Differences
This shows you the differences between two versions of the page.
Next revision | Previous revisionNext revisionBoth sides next revision | ||
translations:translation_guidance_in_xfce [2009/08/17 14:53] – created mike | translations:translation_guidance_in_xfce [2017/12/11 23:08] – [16. Appendix] vinzv | ||
---|---|---|---|
Line 7: | Line 7: | ||
It is based on the contributions by the following authors: | It is based on the contributions by the following authors: | ||
- | * Christian Biere <mailto:cbiere@users.sourceforge.net> | + | * Christian Biere < |
* Thomas Schürger < | * Thomas Schürger < | ||
* Murphy < | * Murphy < | ||
Line 13: | Line 13: | ||
* Stavros Giannouris < | * Stavros Giannouris < | ||
* Mike Massonnet < | * Mike Massonnet < | ||
+ | * Added entry about web pages and po-doc documentation | ||
+ | * Updated old references from SVN to Git | ||
===== 1. Intro ===== | ===== 1. Intro ===== | ||
- | This is a short summary of the gettext documentation. See the [[translation_guidance_in_xfce# | + | This is a short summary of the gettext documentation. See the [[# |
if this information isn't sufficient for you. | if this information isn't sufficient for you. | ||
+ | ===== 2. Get the PO files ===== | ||
- | ===== 2. Get the PO files from the SVN repository ===== | + | You can get the latest PO files from the Transifex platform, available at http://translations.xfce.org/. |
- | + | ||
- | You can get the latest PO files from SVN, | + | |
- | + | ||
- | $ svn checkout | + | |
- | + | ||
- | or current stable version 4.4, | + | |
- | + | ||
- | $ svn checkout http:// | + | |
- | + | ||
- | It's recommended having translation for 4.4 at first, SVN trunk version | + | |
- | would be frequently changed unless they are frozen by developer. | + | |
- | + | ||
- | Note that, if you're going to complete the translation including XML | + | |
- | files, DocBook format documents, the above modules are not enough, | + | |
- | instead you'll have to install whole sources for both 4.4 branch and | + | |
- | trunk. You can get useful scripts for this purpose from | + | |
- | [[svn_howto# | + | |
- | + | ||
- | If you don't have access permission to the SVN repository via SSL, | + | |
- | replace `https://' | + | |
+ | Regarding Xfce, it's recommended having translation for the current stable version at first, the development version would be frequently changed unless they are frozen by developer. | ||
===== 3. Get the editor for PO file editing ===== | ===== 3. Get the editor for PO file editing ===== | ||
Line 64: | Line 47: | ||
* gtranslator - The GNOME 2.x translation making program. | * gtranslator - The GNOME 2.x translation making program. | ||
- | * http://gtranslator.sourceforge.net/ | + | * https://wiki.gnome.org/ |
- | * KBabel | + | * Lokalize |
- | * http://i18n.kde.org/tools/ | + | * https://userbase.kde.org/Lokalize |
If you are going to continue as translator, you might want to learn | If you are going to continue as translator, you might want to learn | ||
one of above. | one of above. | ||
- | |||
- | Note: Let us (xfce-i18n@xfce.org) know if you know something else. | ||
- | |||
===== 4. Contact with the former translator in your language ===== | ===== 4. Contact with the former translator in your language ===== | ||
Line 87: | Line 67: | ||
- | ===== 5. Prepare the PO file (only works in 4.2 branch) | + | ===== 5. Prepare the PO file ===== |
To create the PO file for your language, simply type, | To create the PO file for your language, simply type, | ||
Line 93: | Line 73: | ||
$ msginit | $ msginit | ||
- | in the target po directory, according to the your current locale, it | + | in the target po directory, according to your current locale, it |
creates lang.po in which the suitable header strings will be given | creates lang.po in which the suitable header strings will be given | ||
automatically without your bothering. This newly created PO file, | automatically without your bothering. This newly created PO file, | ||
Line 100: | Line 80: | ||
Note: The command " | Note: The command " | ||
- | generated .pot file, therefore, it's impossible using this command in | + | generated .pot file. |
- | trunk module currently, instead you'll have to get whole source tree | + | |
- | from SVN repository. | + | |
===== 6. Translate the messages ===== | ===== 6. Translate the messages ===== | ||
Line 205: | Line 183: | ||
* An explanation for plural mechanism. | * An explanation for plural mechanism. | ||
* Commenting with "''#''" | * Commenting with "''#''" | ||
- | * Distinguish in between UI and Tooltip string (punctuation). | ||
==== 6.1 Translation Context ==== | ==== 6.1 Translation Context ==== | ||
Line 262: | Line 239: | ||
You should get no warnings, but if you got them, fix it following | You should get no warnings, but if you got them, fix it following | ||
outputted warning messages. After checking, you can send your | outputted warning messages. After checking, you can send your | ||
- | translation to the Xfce translations mailing list (xfce-i18n@xfce.org). | + | translation to the Xfce Transifex platform. To get an account with upload |
- | If you are going to send multiple files at once, please use "tar + | + | rights |
- | bzip2/gzip" format. | + | in the //Getting started// section. |
Note: This part is so important that please don't post your | Note: This part is so important that please don't post your | ||
Line 270: | Line 247: | ||
- | ===== 9. Stay tuned! (it requires full source) | + | ===== 9. Template updates |
The messages may be changed from release to release and with growing | The messages may be changed from release to release and with growing | ||
Line 277: | Line 254: | ||
be a few more sentences to be translated. | be a few more sentences to be translated. | ||
- | To update the PO files to reflect any changes to translatable strings | + | The following part concerns the project maintainers. |
+ | files to reflect any changes to translatable strings | ||
in the source files, it requires full source codes in which you'll have | in the source files, it requires full source codes in which you'll have | ||
to run | to run | ||
$ ./ | $ ./ | ||
- | |||
- | when you are in the trunk/ tree, or in branches/ | ||
- | |||
- | $ ./configure | ||
will be required in the each module' | will be required in the each module' | ||
Line 297: | Line 271: | ||
the POT file. | the POT file. | ||
- | After that you can check your language' | + | Sometimes, it requires updating POFILES.in in the first place, when there are strings in new source files. |
- | translations and add/correct them with you favorite editor. | + | |
- | + | ||
- | When you're finished, you should run "'' | + | |
- | wrap your .po file's lines properly to have a maximum line width of 80 | + | |
- | characters. | + | |
- | + | ||
- | FIXME | + | |
- | + | ||
- | * Sometimes, it requires updating POFILES.in in the first place. | + | |
===== 10. Desktop files (4.2 branch only and it requires full source) ===== | ===== 10. Desktop files (4.2 branch only and it requires full source) ===== | ||
Line 364: | Line 328: | ||
xfwm4/ | xfwm4/ | ||
xfwm4/ | xfwm4/ | ||
- | |||
- | FIXME | ||
- | |||
- | * HOW TO - making an one-stop patch. | ||
===== 11. XML files for desktop menu (it requires full source) ===== | ===== 11. XML files for desktop menu (it requires full source) ===== | ||
- | //The translations for the desktop menu are translated directly in the po files for the trunk (post 4.4 branch). | + | //The translations for the desktop menu are translated directly in the po files for the development branch |
You might want to localize desktop menu appearing by right click on the | You might want to localize desktop menu appearing by right click on the | ||
desktop, your files are, | desktop, your files are, | ||
- | * For SVN 4.4 branch | + | * For the 4.4 branch |
- | xfdesktop/ | + | xfdesktop/ |
- | xfdesktop/ | + | xfdesktop/ |
to translate into your language, follow the instructions in those files, | to translate into your language, follow the instructions in those files, | ||
Line 396: | Line 356: | ||
===== 12. Checking your translations in the actual situation ===== | ===== 12. Checking your translations in the actual situation ===== | ||
- | As for the SVN trunk, the relevant module should be built and installed. | + | As for the development branch, the relevant module should be built and installed. |
This is only for the brave and those that know what to do, instructions | This is only for the brave and those that know what to do, instructions | ||
and information are to be found elsewhere. | and information are to be found elsewhere. | ||
- | As for the SVN 4.4 branch, and assuming that the translator has this | + | As for the 4.4 branch, and assuming that the translator has this |
installed, it is a matter of running | installed, it is a matter of running | ||
Line 415: | Line 375: | ||
* Maintain the documentation (job for the maintainer/ | * Maintain the documentation (job for the maintainer/ | ||
- | - Run the "'' | + | - Run the "'' |
- Update the POT and PO files with "'' | - Update the POT and PO files with "'' | ||
- Update the XML files with the newly translated PO files with "'' | - Update the XML files with the newly translated PO files with "'' | ||
Line 422: | Line 382: | ||
* Compile the DocBook into HTML format (anyone who wants to check the results) | * Compile the DocBook into HTML format (anyone who wants to check the results) | ||
- | - Run the "'' | + | - Run the "'' |
- Run "'' | - Run "'' | ||
- The result is compiled inside '' | - The result is compiled inside '' | ||
Line 440: | Line 400: | ||
* Xfce translations mailing list < | * Xfce translations mailing list < | ||
- | * Daichi Kawahata < | ||
Your feedback will be gratefully appreciated. | Your feedback will be gratefully appreciated. | ||
Line 449: | Line 408: | ||
* The complete GNU gettext manual: | * The complete GNU gettext manual: | ||
- | * http:// | + | * http:// |
* Standard country codes (ISO 3166): | * Standard country codes (ISO 3166): | ||
Line 458: | Line 417: | ||
* Freedesktop.org desktop entry spec: | * Freedesktop.org desktop entry spec: | ||
- | * http://www.freedesktop.org/standards/ | + | * https://specifications.freedesktop.org/ |
* Translation Project: | * Translation Project: | ||
* http:// | * http:// | ||
- | |||
- | * Xfce translations statistics: | ||
- | * http:// | ||
- |