https://www.claws-mail.org/faq/api.php?action=feedcontributions&user=Nadar&feedformat=atom Claws Mail FAQ - User contributions [en] 2024-03-28T12:03:44Z User contributions MediaWiki 1.35.7 https://www.claws-mail.org/faq/index.php?title=Translator%27s_Information&diff=2984 Translator's Information 2012-11-10T13:44:51Z <p>Nadar: better</p> <hr /> <div>===The Release Process===<br /> <br /> : The Claws Team sets a date for release, at least 2 weeks in advance.<br /> :: &lt;u&gt;Week One:&lt;/u&gt; CVS feature freeze<br /> ::: No new features are added to CVS, the Team try to fix as many outstanding bugs as possible, test new features thoroughly, and improve any translatable strings as is deemed necessary.<br /> ::: A message announcing the forthcoming release is sent to the [http://www.claws-mail.org/MLs.php translators' mailing list]. Translators should respond to this message, confirming whether they will or will not be submitting updates.<br /> :: &lt;u&gt;Week Two:&lt;/u&gt; CVS string freeze<br /> ::: No new features are added and no translatable strings are changed or added.<br /> ::: During this second week, translators should update their local CVS trees and work on updating their translations. For those translators who are unable to build from CVS, up to date POT files are made available for download at http://www.claws-mail.org/i18n/.<br /> ::: If no strings were changed from the previous release the PO file &lt;u&gt;must not be changed and does not need to be submitted&lt;/u&gt;.<br /> ::: When a translator has updated his/her translations they should be sent to Paul at [mailto:translations@thewildbeast.co.uk translations@thewildbeast.co.uk] at any time before the week is up. They will then be committed to CVS and included in the release.<br /> :: &lt;u&gt;Week Three:&lt;/u&gt; The release<br /> ::: The release will be made on Day One of Week Three.<br /> <br /> : &lt;b&gt;Bug-Fix Releases&lt;/b&gt;<br /> :: The Claws Team occasionally feels the need to make bug-fix releases. These are normally indicated by an increment of the MICRO_VERSION, (e.g. from version 2.7.0 to 2.7.1). The bug-fix releases contain none of the new features that have been added to CVS since the last major release, and they also do not contain any new translatable strings that may have been added to CVS. Therefore no translation updates are required for these releases and, consequently, the usual process, detailed above, is not initiated.<br /> <br /> ===Information for new translators===<br /> <br /> '''Starting fresh'''<br /> <br /> First grab yourself a copy of the Claws Mail sources, preferably from [http://www.claws-mail.org/cvs.php CVS], and create a claws-mail.pot file:<br /> : ./autogen.sh<br /> : cd po<br /> : make claws-mail.pot<br /> If you are not able to build from CVS, then get a copy of the last released sources from the [http://sourceforge.net/project/showfiles.php?group_id=25528&amp;package_id=147457 SourceForge Claws-Mail files page], which has the claws-mail.pot file included.<br /> <br /> Copy claws-mail.pot to [LANGUAGE ABBREV].po, (replace [LANGUAGE ABBREV] with the correct abbreviation for your language, e.g. 'es' if you are translating into Spanish).<br /> : cp claws-mail.pot es.po<br /> <br /> Open your new po file with your favourite text editor, (or you may prefer to use a translation catalog editor, such as [http://poedit.sourceforge.net poedit] or [http://kbabel.kde.org/ kbabel], for example), and first edit the header section of your file. You will need to replace the text in UPPERCASE with the correct values. The easiest way to work out how to do this is to compare it to another po file that already exists:<br /> <br /> {| border=&quot;1&quot;<br /> |+ po file header section<br /> ! your new po file !! es.po<br /> |-<br /> | &lt;pre&gt;# SOME DESCRIPTIVE TITLE.<br /> # Copyright (C) YEAR The Claws Mail Team<br /> # FIRST AUTHOR &lt;EMAIL@ADDRESS&gt;, YEAR.<br /> #<br /> #, fuzzy<br /> msgid &quot;&quot;<br /> msgstr &quot;&quot;<br /> &quot;Project-Id-Version: PACKAGE VERSION\n&quot;<br /> &quot;Report-Msgid-Bugs-To: paul@claws-mail.org\n&quot;<br /> &quot;POT-Creation-Date: 2007-01-30 09:03+0000\n&quot;<br /> &quot;PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n&quot;<br /> &quot;Last-Translator: FULL NAME &lt;EMAIL@ADDRESS&gt;\n&quot;<br /> &quot;Language-Team: LANGUAGE &lt;LL@li.org&gt;\n&quot;<br /> &quot;MIME-Version: 1.0\n&quot;<br /> &quot;Content-Type: text/plain; charset=CHARSET\n&quot;<br /> &quot;Content-Transfer-Encoding: 8bit\n&quot;<br /> &quot;Plural-Forms: nplurals=INTEGER; plural=EXPRESSION;\n&quot;&lt;/pre&gt;<br /> | &lt;pre&gt;# Spanish translation of Claws Mail.<br /> # Copyright (C) 2007 The Claws Mail Team<br /> # Ricardo Mones &lt;ricardo@mones.org&gt;, 2000-2007.<br /> #<br /> msgid &quot;&quot;<br /> msgstr &quot;&quot;<br /> &quot;Project-Id-Version: claws mail\n&quot;<br /> &quot;Report-Msgid-Bugs-To: paul@claws-mail.org\n&quot;<br /> &quot;POT-Creation-Date: 2007-01-25 12:17+0100\n&quot;<br /> &quot;PO-Revision-Date: 2007-01-25 19:28+0200\n&quot;<br /> &quot;Last-Translator: Ricardo Mones &lt;ricardo@mones.org&gt;\n&quot;<br /> &quot;Language-Team: Ricardo Mones &lt;ricardo@mones.org&gt;\n&quot;<br /> &quot;MIME-Version: 1.0\n&quot;<br /> &quot;Content-Type: text/plain; charset=iso-8859-1\n&quot;<br /> &quot;Content-Transfer-Encoding: 8bit\n&quot;<br /> &quot;Plural-Forms: nplurals=2; plural=n != 1;\n&quot;&lt;/pre&gt;<br /> |}<br /> Consult the [http://www.gnu.org/software/gettext/manual/html_node/gettext_150.html gettext manual] for the correct Plural-Forms entry for your language.<br /> <br /> Next you will add your translated strings in the &lt;b&gt;msgstr&lt;/b&gt; sections.<br /> Again, an example from es.po:<br /> <br /> {|<br /> |-<br /> &lt;pre&gt;#: src/account.c:372<br /> msgid &quot;&quot;<br /> &quot;Some composing windows are open.\n&quot;<br /> &quot;Please close all the composing windows before editing the accounts.&quot;<br /> msgstr &quot;&quot;<br /> &quot;Hay ventanas de composici&amp;oacute;n abiertas.\n&quot;<br /> &quot;Cierre todas las ventanas de composici&amp;oacute;n antes de editar las cuentas.&quot;<br /> &lt;/pre&gt;<br /> |}<br /> <br /> There are some variations to the format which you should be aware of:<br /> <br /> :: Default hotkeys are indicated by the '_' character:<br /> :::{|<br /> |-<br /> &lt;pre&gt;#: src/account.c:767<br /> msgid &quot; _Set as default account &quot;<br /> msgstr &quot; _Establecer como primaria &quot;&lt;/pre&gt;<br /> |}<br /> <br /> :: The presence of dynamically-generated text is indicated by the 'c-format' line. The 'c format', (%s, %d, etc.), in your &lt;b&gt;msgstr&lt;/b&gt; must match the one used in the &lt;b&gt;msgid&lt;/b&gt;:<br /> :::{|<br /> |-<br /> &lt;pre&gt;#: src/account.c:867<br /> #, c-format<br /> msgid &quot;Copy of %s&quot;<br /> msgstr &quot;Copia de %s&quot;&lt;/pre&gt;<br /> |}<br /> <br /> :: Some strings have informational data for translators included in the &lt;b&gt;msgid&lt;/b&gt; part, delimited by the '|' character. Their purpose is to indicate the context of the string and they should not appear in your &lt;b&gt;msgstr&lt;/b&gt;:<br /> :::{|<br /> |-<br /> &lt;pre&gt;#: src/prefs_msg_colors.c:228<br /> msgid &quot;Tooltip|Pick color for 2nd level text&quot;<br /> msgstr &quot;Elejir el color para el texto de segundo nivel&quot;&lt;/pre&gt;<br /> |}<br /> <br /> :: Other strings have the informational data included in the comment header, indicated by 'TRANSLATORS: &amp;hellip;':<br /> :::{|<br /> |-<br /> &lt;pre&gt;#. TRANSLATORS: 'color %d' refers to the filtering/processing<br /> #. rule name and should not be translated<br /> #: src/prefs_msg_colors.c:432 src/prefs_msg_colors.c:464<br /> #, c-format<br /> msgid &quot;Set label for 'color %d'&quot;<br /> msgstr &quot;Establecer la etiqueta para el &amp;laquo;color %d&amp;raquo;&quot;&lt;/pre&gt;<br /> |}<br /> <br /> :: Some strings contain markup, which should be left in place:<br /> :::{|<br /> |-<br /> &lt;pre&gt;#: src/wizard.c:892<br /> msgid &quot;&lt;span weight=\&quot;bold\&quot;&gt;Your name:&lt;/span&gt;&quot;<br /> msgstr &quot;&lt;span weight=\&quot;bold\&quot;&gt;Su nombre:&lt;/span&gt;&quot;&lt;/pre&gt;<br /> |}<br /> <br /> :: Here is an example of Plural-Forms usage:<br /> :::{|<br /> |-<br /> &lt;pre&gt;#: src/inc.c:592<br /> #, c-format<br /> msgid &quot;Done (%d message (%s) received)&quot;<br /> msgid_plural &quot;Done (%d messages (%s) received)&quot;<br /> msgstr[0] &quot;Hecho (%d mensaje (%s) recibido)&quot;<br /> msgstr[1] &quot;Hecho (%d mensajes (%s) recibidos)&quot;&lt;/pre&gt;<br /> |}<br /> <br /> '''Checking your translation for errors''' (and completeness)<br /> : /usr/bin/msgfmt -c --statistics es.po<br /> <br /> '''Building Claws Mail with your new translation included'''<br /> <br /> For this step you will need to be able to build from CVS, so a full set of development tools is required.<br /> <br /> Open the file configure.ac in your text editor and locate the line that begins with 'ALL_LINGUAS=', then add your language to the list of languages.<br /> <br /> Then run ./autogen.sh [OPTIONS], make, make install as usual.<br /> <br /> '''Updating your translation'''<br /> <br /> When it is time to update your translation, first update your [http://www.claws-mail.org/cvs.php CVS] working directory.<br /> Then do the following:<br /> <br /> : cd po<br /> : rm claws-mail.pot<br /> : make claws-mail.pot<br /> <br /> Next issue the following command to update your po file:<br /> <br /> : /usr/bin/msgmerge --update es.po claws-mail.pot<br /> <br /> Then open your file and locate the strings that need updating. These will have an empty &lt;b&gt;msgstr&lt;/b&gt; or will be marked 'fuzzy':<br /> ::{|<br /> |-<br /> &lt;pre&gt;#: src/mainwindow.c:838 src/messageview.c:332<br /> #, fuzzy<br /> msgid &quot;/_Tools/List _URLs...&quot;<br /> msgstr &quot;/_Herramientas/Exportar _HTML...&quot;&lt;/pre&gt;<br /> |}<br /> <br /> ::{|<br /> |-<br /> &lt;pre&gt;#: src/action.c:1184<br /> #, fuzzy, c-format<br /> msgid &quot;--- Ended: %s\n&quot;<br /> msgstr &quot;--- Ejecutando: %s\n&quot;&lt;/pre&gt;<br /> |}<br /> <br /> Correct the &lt;b&gt;msgstr&lt;/b&gt; and, in the first example, remove the line '#, fuzzy', or, in the second example, remove just the 'fuzzy, ' part of the line, leaving the c-format part intact.</div> Nadar https://www.claws-mail.org/faq/index.php?title=Translator%27s_Information&diff=2983 Translator's Information 2012-11-10T12:42:20Z <p>Nadar: poedit, changes don't show up in compile</p> <hr /> <div>===The Release Process===<br /> <br /> : The Claws Team sets a date for release, at least 2 weeks in advance.<br /> :: &lt;u&gt;Week One:&lt;/u&gt; CVS feature freeze<br /> ::: No new features are added to CVS, the Team try to fix as many outstanding bugs as possible, test new features thoroughly, and improve any translatable strings as is deemed necessary.<br /> ::: A message announcing the forthcoming release is sent to the [http://www.claws-mail.org/MLs.php translators' mailing list]. Translators should respond to this message, confirming whether they will or will not be submitting updates.<br /> :: &lt;u&gt;Week Two:&lt;/u&gt; CVS string freeze<br /> ::: No new features are added and no translatable strings are changed or added.<br /> ::: During this second week, translators should update their local CVS trees and work on updating their translations. For those translators who are unable to build from CVS, up to date POT files are made available for download at http://www.claws-mail.org/i18n/.<br /> ::: If no strings were changed from the previous release the PO file &lt;u&gt;must not be changed and does not need to be submitted&lt;/u&gt;.<br /> ::: When a translator has updated his/her translations they should be sent to Paul at [mailto:translations@thewildbeast.co.uk translations@thewildbeast.co.uk] at any time before the week is up. They will then be committed to CVS and included in the release.<br /> :: &lt;u&gt;Week Three:&lt;/u&gt; The release<br /> ::: The release will be made on Day One of Week Three.<br /> <br /> : &lt;b&gt;Bug-Fix Releases&lt;/b&gt;<br /> :: The Claws Team occasionally feels the need to make bug-fix releases. These are normally indicated by an increment of the MICRO_VERSION, (e.g. from version 2.7.0 to 2.7.1). The bug-fix releases contain none of the new features that have been added to CVS since the last major release, and they also do not contain any new translatable strings that may have been added to CVS. Therefore no translation updates are required for these releases and, consequently, the usual process, detailed above, is not initiated.<br /> <br /> ===Information for new translators===<br /> <br /> '''Starting fresh'''<br /> <br /> First grab yourself a copy of the Claws Mail sources, preferably from [http://www.claws-mail.org/cvs.php CVS], and create a claws-mail.pot file:<br /> : ./autogen.sh<br /> : cd po<br /> : make claws-mail.pot<br /> If you are not able to build from CVS, then get a copy of the last released sources from the [http://sourceforge.net/project/showfiles.php?group_id=25528&amp;package_id=147457 SourceForge Claws-Mail files page], which has the claws-mail.pot file included.<br /> <br /> Copy claws-mail.pot to [LANGUAGE ABBREV].po, (replace [LANGUAGE ABBREV] with the correct abbreviation for your language, e.g. 'es' if you are translating into Spanish).<br /> : cp claws-mail.pot es.po<br /> <br /> Open your new po file with your favourite text editor, (or you may prefer to use a translation catalog editor, such as [http://poedit.sourceforge.net poedit] or [http://kbabel.kde.org/ kbabel], for example), and first edit the header section of your file. You will need to replace the text in UPPERCASE with the correct values. The easiest way to work out how to do this is to compare it to another po file that already exists:<br /> <br /> {| border=&quot;1&quot;<br /> |+ po file header section<br /> ! your new po file !! es.po<br /> |-<br /> | &lt;pre&gt;# SOME DESCRIPTIVE TITLE.<br /> # Copyright (C) YEAR The Claws Mail Team<br /> # FIRST AUTHOR &lt;EMAIL@ADDRESS&gt;, YEAR.<br /> #<br /> #, fuzzy<br /> msgid &quot;&quot;<br /> msgstr &quot;&quot;<br /> &quot;Project-Id-Version: PACKAGE VERSION\n&quot;<br /> &quot;Report-Msgid-Bugs-To: paul@claws-mail.org\n&quot;<br /> &quot;POT-Creation-Date: 2007-01-30 09:03+0000\n&quot;<br /> &quot;PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n&quot;<br /> &quot;Last-Translator: FULL NAME &lt;EMAIL@ADDRESS&gt;\n&quot;<br /> &quot;Language-Team: LANGUAGE &lt;LL@li.org&gt;\n&quot;<br /> &quot;MIME-Version: 1.0\n&quot;<br /> &quot;Content-Type: text/plain; charset=CHARSET\n&quot;<br /> &quot;Content-Transfer-Encoding: 8bit\n&quot;<br /> &quot;Plural-Forms: nplurals=INTEGER; plural=EXPRESSION;\n&quot;&lt;/pre&gt;<br /> | &lt;pre&gt;# Spanish translation of Claws Mail.<br /> # Copyright (C) 2007 The Claws Mail Team<br /> # Ricardo Mones &lt;ricardo@mones.org&gt;, 2000-2007.<br /> #<br /> msgid &quot;&quot;<br /> msgstr &quot;&quot;<br /> &quot;Project-Id-Version: claws mail\n&quot;<br /> &quot;Report-Msgid-Bugs-To: paul@claws-mail.org\n&quot;<br /> &quot;POT-Creation-Date: 2007-01-25 12:17+0100\n&quot;<br /> &quot;PO-Revision-Date: 2007-01-25 19:28+0200\n&quot;<br /> &quot;Last-Translator: Ricardo Mones &lt;ricardo@mones.org&gt;\n&quot;<br /> &quot;Language-Team: Ricardo Mones &lt;ricardo@mones.org&gt;\n&quot;<br /> &quot;MIME-Version: 1.0\n&quot;<br /> &quot;Content-Type: text/plain; charset=iso-8859-1\n&quot;<br /> &quot;Content-Transfer-Encoding: 8bit\n&quot;<br /> &quot;Plural-Forms: nplurals=2; plural=n != 1;\n&quot;&lt;/pre&gt;<br /> |}<br /> Consult the [http://www.gnu.org/software/gettext/manual/html_node/gettext_150.html gettext manual] for the correct Plural-Forms entry for your language.<br /> <br /> Next you will add your translated strings in the &lt;b&gt;msgstr&lt;/b&gt; sections.<br /> Again, an example from es.po:<br /> <br /> {|<br /> |-<br /> &lt;pre&gt;#: src/account.c:372<br /> msgid &quot;&quot;<br /> &quot;Some composing windows are open.\n&quot;<br /> &quot;Please close all the composing windows before editing the accounts.&quot;<br /> msgstr &quot;&quot;<br /> &quot;Hay ventanas de composici&amp;oacute;n abiertas.\n&quot;<br /> &quot;Cierre todas las ventanas de composici&amp;oacute;n antes de editar las cuentas.&quot;<br /> &lt;/pre&gt;<br /> |}<br /> <br /> There are some variations to the format which you should be aware of:<br /> <br /> :: Default hotkeys are indicated by the '_' character:<br /> :::{|<br /> |-<br /> &lt;pre&gt;#: src/account.c:767<br /> msgid &quot; _Set as default account &quot;<br /> msgstr &quot; _Establecer como primaria &quot;&lt;/pre&gt;<br /> |}<br /> <br /> :: The presence of dynamically-generated text is indicated by the 'c-format' line. The 'c format', (%s, %d, etc.), in your &lt;b&gt;msgstr&lt;/b&gt; must match the one used in the &lt;b&gt;msgid&lt;/b&gt;:<br /> :::{|<br /> |-<br /> &lt;pre&gt;#: src/account.c:867<br /> #, c-format<br /> msgid &quot;Copy of %s&quot;<br /> msgstr &quot;Copia de %s&quot;&lt;/pre&gt;<br /> |}<br /> <br /> :: Some strings have informational data for translators included in the &lt;b&gt;msgid&lt;/b&gt; part, delimited by the '|' character. Their purpose is to indicate the context of the string and they should not appear in your &lt;b&gt;msgstr&lt;/b&gt;:<br /> :::{|<br /> |-<br /> &lt;pre&gt;#: src/prefs_msg_colors.c:228<br /> msgid &quot;Tooltip|Pick color for 2nd level text&quot;<br /> msgstr &quot;Elejir el color para el texto de segundo nivel&quot;&lt;/pre&gt;<br /> |}<br /> <br /> :: Other strings have the informational data included in the comment header, indicated by 'TRANSLATORS: &amp;hellip;':<br /> :::{|<br /> |-<br /> &lt;pre&gt;#. TRANSLATORS: 'color %d' refers to the filtering/processing<br /> #. rule name and should not be translated<br /> #: src/prefs_msg_colors.c:432 src/prefs_msg_colors.c:464<br /> #, c-format<br /> msgid &quot;Set label for 'color %d'&quot;<br /> msgstr &quot;Establecer la etiqueta para el &amp;laquo;color %d&amp;raquo;&quot;&lt;/pre&gt;<br /> |}<br /> <br /> :: Some strings contain markup, which should be left in place:<br /> :::{|<br /> |-<br /> &lt;pre&gt;#: src/wizard.c:892<br /> msgid &quot;&lt;span weight=\&quot;bold\&quot;&gt;Your name:&lt;/span&gt;&quot;<br /> msgstr &quot;&lt;span weight=\&quot;bold\&quot;&gt;Su nombre:&lt;/span&gt;&quot;&lt;/pre&gt;<br /> |}<br /> <br /> :: Here is an example of Plural-Forms usage:<br /> :::{|<br /> |-<br /> &lt;pre&gt;#: src/inc.c:592<br /> #, c-format<br /> msgid &quot;Done (%d message (%s) received)&quot;<br /> msgid_plural &quot;Done (%d messages (%s) received)&quot;<br /> msgstr[0] &quot;Hecho (%d mensaje (%s) recibido)&quot;<br /> msgstr[1] &quot;Hecho (%d mensajes (%s) recibidos)&quot;&lt;/pre&gt;<br /> |}<br /> <br /> '''Checking your translation for errors''' (and completeness)<br /> : /usr/bin/msgfmt -c --statistics es.po<br /> <br /> You can also use the editor [http://www.poedit.net/ poedit] for editing the po file.<br /> <br /> '''Building Claws Mail with your new translation included'''<br /> <br /> For this step you will need to be able to build from CVS, so a full set of development tools is required.<br /> <br /> Open the file configure.ac in your text editor and locate the line that begins with 'ALL_LINGUAS=', then add your language to the list of languages.<br /> <br /> Then run ./autogen.sh [OPTIONS], make, make install as usual.<br /> <br /> When you have changed a translation in the po-file and compile claws-mail anew but the change don't show up, you have to do the following:<br /> : cd po<br /> : rm es.gmo<br /> : make update-gmo<br /> Then compile claws-mail as usual.<br /> <br /> <br /> '''Updating your translation'''<br /> <br /> When it is time to update your translation, first update your [http://www.claws-mail.org/cvs.php CVS] working directory.<br /> Then do the following:<br /> <br /> : cd po<br /> : rm claws-mail.pot<br /> : make claws-mail.pot<br /> <br /> Next issue the following command to update your po file:<br /> <br /> : /usr/bin/msgmerge --update es.po claws-mail.pot<br /> <br /> Then open your file and locate the strings that need updating. These will have an empty &lt;b&gt;msgstr&lt;/b&gt; or will be marked 'fuzzy':<br /> ::{|<br /> |-<br /> &lt;pre&gt;#: src/mainwindow.c:838 src/messageview.c:332<br /> #, fuzzy<br /> msgid &quot;/_Tools/List _URLs...&quot;<br /> msgstr &quot;/_Herramientas/Exportar _HTML...&quot;&lt;/pre&gt;<br /> |}<br /> <br /> ::{|<br /> |-<br /> &lt;pre&gt;#: src/action.c:1184<br /> #, fuzzy, c-format<br /> msgid &quot;--- Ended: %s\n&quot;<br /> msgstr &quot;--- Ejecutando: %s\n&quot;&lt;/pre&gt;<br /> |}<br /> <br /> Correct the &lt;b&gt;msgstr&lt;/b&gt; and, in the first example, remove the line '#, fuzzy', or, in the second example, remove just the 'fuzzy, ' part of the line, leaving the c-format part intact.</div> Nadar