]> git.ipfire.org Git - thirdparty/cups.git/blobdiff - doc/help/translation.html
Import CUPS 1.4svn r7023 into easysw/current.
[thirdparty/cups.git] / doc / help / translation.html
index 32057349539085adaab02677260fbf28a04f3ef2..abc4bbb655bc3b90b6674a0158b4d1a103a18f8e 100644 (file)
@@ -23,15 +23,6 @@ files and directories:</P>
        <LI><VAR>desktop/cups.desktop</VAR> - the GNOME/KDE
        desktop file pointing to the CUPS web interface</LI>
 
-       <LI><VAR>doc/images/button-*.gif</VAR> - the web
-       interface button images</LI>
-
-       <LI><VAR>tools/buttons.txt</VAR> - the English text for the
-       web interface buttons</LI>
-
-       <LI><VAR>tools/makebuttons</VAR> - the shell script we use
-       to generate the web interface button images</LI>
-
        <LI><VAR>doc/index.html</VAR> - the web interface home
        page</LI>
 
@@ -47,7 +38,8 @@ localization files are  placed in subdirectories under the
 <VAR>doc</VAR> and <VAR>templates</VAR> using the locale name.
 Locale names are either <VAR>ll</VAR> or <VAR>ll_CC</VAR>, where
 "ll" is the 2-letter language code and "CC" is the 2-letter
-country code. <em>CUPS does not currently use or support the newer <VAR>ll-region</VAR> syntax for locale names.</em></P>
+country code. <em>CUPS does not currently use or support the newer
+<VAR>ll-region</VAR> syntax for locale names.</em></P>
 
 <P>All non-image files must be encoded using the UTF-8 character
 set.</P>
@@ -56,11 +48,10 @@ set.</P>
 <H2 CLASS="title"><A NAME="SUBMIT">Submitting a Translation for CUPS</A></H2>
 
 <P>To submit a translation for inclusion in CUPS, translate the
-desktop file, all of the button images, template files, the
-<VAR>index.html.in</VAR> file, and the message catalog. Place
-these files in the correct subdirectory in the CUPS source code
-archive and run the following command to create an archive with
-your files:</P>
+desktop file, all of the template files, the <VAR>index.html.in</VAR>
+file, and the message catalog. Place these files in the correct
+subdirectories in the CUPS source code archive and run the following
+command to create an archive with your files:</P>
 
 <PRE CLASS="command">
 tar cvf <I>ll_CC</I>.tar.gz desktop/cups.desktop doc/<I>ll_CC</I> \
@@ -87,261 +78,6 @@ Comment[<I>ll_CC</I>]=<I>Translation of "CUPS Web Interface"</I>
 </PRE>
 
 
-<H2 CLASS="title"><A NAME="IMAGES">Button Images</A></H2>
-
-<P>The web interface button images are used to activate functions on
-the CUPS web pages. Table 1 lists the button images and the English
-text labels for those buttons. Copy the file
-<VAR>tools/buttons.txt</VAR> to <VAR>buttons-ll_CC.txt</VAR>,
-translate the text in that file (use UTF-8 as the text encoding!),
-and then use the supplied <VAR>tools/makebuttons</VAR> script to
-create button images that match the CUPS web interface:</P>
-
-<PRE CLASS="command">
-cp tools/buttons.txt buttons-ll_CC.txt
-vi buttons-ll_CC.txt
-tools/makebuttons ll_CC buttons-ll_CC.txt
-</PRE>
-
-<BLOCKQUOTE><B>Note:</B> The <VAR>tools/makebuttons</VAR> script
-requires at least version 6.2.4 of the ImageMagick software to
-work.</BLOCKQUOTE>
-
-<P>When you have created all of the button images, edit the
-<VAR>Makedefs</VAR> file and add the locale name to the
-<CODE>LANGUAGES</CODE> variable. You can then run "make
-install" in the <VAR>doc</VAR> subdirectory to test the
-translated buttons.</P>
-
-<DIV CLASS="table"><TABLE SUMMARY="Web Interface Buttons">
-<CAPTION>Table 1: Web Interface Buttons</CAPTION>
-<THEAD>
-<TR>
-       <TH>Filename</TH>
-       <TH>Text</TH>
-</TR>
-</THEAD>
-<TBODY>
-<TR>
-       <TD>button-accept-jobs.gif</TD>
-       <TD>Accept Jobs</TD>
-</TR>
-<TR>
-       <TD>button-add-class.gif</TD>
-       <TD>Add Class</TD>
-</TR>
-<TR>
-       <TD>button-add-printer.gif</TD>
-       <TD>Add Printer</TD>
-</TR>
-<TR>
-       <TD>button-add-rss-subscription.gif</TD>
-       <TD>Add RSS Subscription</TD>
-</TR>
-<TR>
-       <TD>button-add-this-printer.gif</TD>
-       <TD>Add This Printer</TD>
-</TR>
-<TR>
-       <TD>button-cancel-all-jobs.gif</TD>
-       <TD>Cancel All Jobs</TD>
-</TR>
-<TR>
-       <TD>button-cancel-job.gif</TD>
-       <TD>Cancel Job</TD>
-</TR>
-<TR>
-       <TD>button-cancel-subscription.gif</TD>
-       <TD>Cancel Subscription</TD>
-</TR>
-<TR>
-       <TD>button-change-settings.gif</TD>
-       <TD>Change Settings</TD>
-</TR>
-<TR>
-       <TD>button-clean-print-heads.gif</TD>
-       <TD>Clean Print Heads</TD>
-</TR>
-<TR>
-       <TD>button-clear.gif</TD>
-       <TD>Clear</TD>
-</TR>
-<TR>
-       <TD>button-continue.gif</TD>
-       <TD>Continue</TD>
-</TR>
-<TR>
-       <TD>button-delete-class.gif</TD>
-       <TD>Delete Class</TD>
-</TR>
-<TR>
-       <TD>button-delete-printer.gif</TD>
-       <TD>Delete Printer</TD>
-</TR>
-<TR>
-       <TD>button-edit-configuration-file.gif</TD>
-       <TD>Edit Configuration File</TD>
-</TR>
-<TR>
-       <TD>button-export-samba.gif</TD>
-       <TD>Export Printers to Samba</TD>
-</TR>
-<TR>
-       <TD>button-help.gif</TD>
-       <TD>Help</TD>
-</TR>
-<TR>
-       <TD>button-hold-job.gif</TD>
-       <TD>Hold Job</TD>
-</TR>
-<TR>
-       <TD>button-manage-classes.gif</TD>
-       <TD>Manage Classes</TD>
-</TR>
-<TR>
-       <TD>button-manage-jobs.gif</TD>
-       <TD>Manage Jobs</TD>
-</TR>
-<TR>
-       <TD>button-manage-printers.gif</TD>
-       <TD>Manage Printers</TD>
-</TR>
-<TR>
-       <TD>button-manage-server.gif</TD>
-       <TD>Manage Server</TD>
-</TR>
-<TR>
-       <TD>button-modify-class.gif</TD>
-       <TD>Modify Class</TD>
-</TR>
-<TR>
-       <TD>button-modify-printer.gif</TD>
-       <TD>Modify Printer</TD>
-</TR>
-<TR>
-       <TD>button-move-job.gif</TD>
-       <TD>Move Job</TD>
-</TR>
-<TR>
-       <TD>button-move-jobs.gif</TD>
-       <TD>Move All Jobs</TD>
-</TR>
-<TR>
-       <TD>button-print-self-test-page.gif</TD>
-       <TD>Print Self-Test Page</TD>
-</TR>
-<TR>
-       <TD>button-print-test-page.gif</TD>
-       <TD>Print Test Page</TD>
-</TR>
-<TR>
-       <TD>button-publish-printer.gif</TD>
-       <TD>Publish Printer</TD>
-</TR>
-<TR>
-       <TD>button-reject-jobs.gif</TD>
-       <TD>Reject Jobs</TD>
-</TR>
-<TR>
-       <TD>button-release-job.gif</TD>
-       <TD>Release Job</TD>
-</TR>
-<TR>
-       <TD>button-restart-job.gif</TD>
-       <TD>Reprint Job</TD>
-</TR>
-<TR>
-       <TD>button-save-changes.gif</TD>
-       <TD>Save Changes</TD>
-</TR>
-<TR>
-       <TD>button-search.gif</TD>
-       <TD>Search</TD>
-</TR>
-<TR>
-       <TD>button-set-allowed-users.gif</TD>
-       <TD>Set Allowed Users</TD>
-</TR>
-<TR>
-       <TD>button-set-as-default.gif</TD>
-       <TD>Set As Default</TD>
-</TR>
-<TR>
-       <TD>button-set-printer-options.gif</TD>
-       <TD>Set Printer Options</TD>
-</TR>
-<TR>
-       <TD>button-show-active.gif</TD>
-       <TD>Show Active Jobs</TD>
-</TR>
-<TR>
-       <TD>button-show-all.gif</TD>
-       <TD>Show All Jobs</TD>
-</TR>
-<TR>
-       <TD>button-show-completed.gif</TD>
-       <TD>Show Completed Jobs</TD>
-</TR>
-<TR>
-       <TD>button-show-next.gif</TD>
-       <TD>Show Next</TD>
-</TR>
-<TR>
-       <TD>button-show-previous.gif</TD>
-       <TD>Show Previous</TD>
-</TR>
-<TR>
-       <TD>button-sort-ascending.gif</TD>
-       <TD>Show Ascending</TD>
-</TR>
-<TR>
-       <TD>button-sort-descending.gif</TD>
-       <TD>Show Descending</TD>
-</TR>
-<TR>
-       <TD>button-start-class.gif</TD>
-       <TD>Start Class</TD>
-</TR>
-<TR>
-       <TD>button-start-printer.gif</TD>
-       <TD>Start Printer</TD>
-</TR>
-<TR>
-       <TD>button-stop-class.gif</TD>
-       <TD>Stop Class</TD>
-</TR>
-<TR>
-       <TD>button-stop-printer.gif</TD>
-       <TD>Stop Printer</TD>
-</TR>
-<TR>
-       <TD>button-unpublish-printer.gif</TD>
-       <TD>Unpublish Printer</TD>
-</TR>
-<TR>
-       <TD>button-use-default-config.gif</TD>
-       <TD>Use Default Configuration File</TD>
-</TR>
-<TR>
-       <TD>button-view-access-log.gif</TD>
-       <TD>View Access Log</TD>
-</TR>
-<TR>
-       <TD>button-view-error-log.gif</TD>
-       <TD>View Error Log</TD>
-</TR>
-<TR>
-       <TD>button-view-page-log.gif</TD>
-       <TD>View Page Log</TD>
-</TR>
-<TR>
-       <TD>button-view-printable-version.gif</TD>
-       <TD>View Printable Version</TD>
-</TR>
-</TBODY>
-</TABLE></DIV>
-
-
 <H2 CLASS="title"><A NAME="HOMEPAGE">The Home Page</A></H2>
 
 <P>The <VAR>index.html</VAR> file is a complete HTML file that is
@@ -379,7 +115,14 @@ message catalog and then make any necessary changes.</P>
 favorite text editor or translation program to translate the text
 to the desired language.</P>
 
-<P>Finally, add your locale to the <CODE>LANGUAGES</CODE>
+<P>Then validate your translation using the <VAR>locale/checkpo</VAR> utility:</P>
+
+<PRE CLASS="command">
+cd locale
+./checkpo cups_ll_CC.po
+</PRE>
+
+<P>After fixing any errors in your translation, add your locale to the <CODE>LANGUAGES</CODE>
 variable in the <VAR>Makedefs</VAR> file and run the "make
 install" command in the <VAR>locale</VAR> subdirectory to test
 the translation.</P>
@@ -523,7 +266,7 @@ translated all of the templates, add the locale to the
 </TR>
 <TR>
        <TD>job-cancel.tmpl</TD>
-       <TD>This template shows "job cancelled".</TD>
+       <TD>This template shows "job canceled".</TD>
 </TR>
 <TR>
        <TD>job-hold.tmpl</TD>
@@ -555,6 +298,10 @@ translated all of the templates, add the locale to the
        <TD>This template shows the "showing N or M jobs" header in the
        jobs list.</TD>
 </TR>
+<TR>
+       <TD>list-available-printers.tmpl</TD>
+       <TD>This template shows a list of new printers that have been found.</TD>
+</TR>
 <TR>
        <TD>maintenance.tmpl</TD>
        <TD>This template shows "maintenance commands sent".</TD>
@@ -850,7 +597,7 @@ are displayed. Table 4 lists the supported values.</P>
 <CAPTION>Table 4: WHICH_JOBS Values</CAPTION>
 <THEAD>
 <TR>
-       <TH>OP Value</TH>
+       <TH>WHICH_JOBS Value</TH>
        <TH>Description</TH>
 </TR>
 </THEAD>
@@ -916,6 +663,10 @@ supported <CODE>OP</CODE> values.</P>
        <TD>export-samba</TD>
        <TD>Exports printers to Samba.</TD>
 </TR>
+<TR>
+       <TD>find-new-printers</TD>
+       <TD>Find new printers that have not yet been added.</TD>
+</TR>
 <TR>
        <TD>modify-class</TD>
        <TD>Modifies a printer class.</TD>
@@ -1047,7 +798,7 @@ supported <CODE>OP</CODE> values.</P>
 </TR>
 <TR>
        <TD>restart-job</TD>
-       <TD>Restarts/reprints a stopped, cancelled, completed, or aborted
+       <TD>Restarts/reprints a stopped, canceled, completed, or aborted
        print job.</TD>
 </TR>
 </TBODY>