Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

translations:advanced:translation_guidance_in_xfce [2026/09/11 21:44] – created kevinbowentranslations:advanced:translation_guidance_in_xfce [2026/09/12 01:39] (current) – Add warning note and table of contents kevinbowen
Line 1: Line 1:
-====== Short Guide About Translating Messages ======+~~NOTOC~~ 
 +====== Advanced Guide for Translating Messages ======
  
 +<note important>The following links and information are provided for historical reference and advanced users. The accuracy of the information here is most likely outdated and no support is provided following these documents. Use at your own risk! We **strongly** recommend users perform their translation work using the [[https://app.transifex.com/xfce/|Transifex web interface]]
 +</note>
  
-===== 0. License and Authors ===== 
  
-This document is provided under the [[http://creativecommons.org/licenses/by/2.5/|Creative Commons Public License 2.5]]. +  * **[[#Introduction|Introduction]]** 
-It is based on the contributions by the following authors:+  * **[[#Get the PO files|Get the PO files]]** 
 +  * **[[#Get the editor for PO file editing|Get the editor for PO file editing]]** 
 +  * **[[#Contact with the former translator in your language|Contact with the former translator in your language]]** 
 +  * **[[#Prepare the PO file|Prepare the PO file]]** 
 +  * **[[#Convert the output to UTF-8 (if it's not already UTF-8 encoded)|Convert the output to UTF-8 (if it's not already UTF-8 encoded)]]** 
 +  * **[[#Checking and Submitting the PO file|Checking and Submitting the PO file]]** 
 +  * **[[#Desktop files (4.2 branch only and it requires full source)|Desktop files (4.2 branch only and it requires full source)]]** 
 +  * **[[#XML files for desktop menu (it requires full source)|XML files for desktop menu (it requires full source)]]** 
 +  * **[[#Checking your translations in the actual situation|Checking your translations in the actual situation]]** 
 +  * **[[#Documentation translation|Documentation translation]]** 
 +  * **[[#Web page translation|Web page translation]]** 
 +  * **[[#Feedback|Feedback]]** 
 +  * **[[#Appendix|Appendix]]** 
 +  * **[[#License and Authors|License and Authors]]**
  
-  * Christian Biere <cbiere@users.sourceforge.net> +----
-  * Thomas Schürger <trancetip@users.sourceforge.net> +
-  * Murphy <eqom14@users.sourceforge.net> +
-  * Daichi Kawahata <daichi@xfce.org> +
-  * Stavros Giannouris <stavrosg2002@freemail.gr> +
-  * Mike Massonnet <mmassonnet@xfce.org> +
-    * Added entry about web pages and po-doc documentation +
-    * Updated old references from SVN to Git+
  
-===== 1. Intro =====+===== 1. Introduction =====
  
 This is a short summary of the gettext documentation. See the [[#16._appendix|Appendix]] This is a short summary of the gettext documentation. See the [[#16._appendix|Appendix]]
 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 =====
  
Line 57: Line 66:
 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. 
 +
 +[[|Back to Top]]
 +----
  
 ===== 4. Contact with the former translator in your language ===== ===== 4. Contact with the former translator in your language =====
Line 69: Line 81:
 translations mailing list (xfce-i18n@xfce.org). translations mailing list (xfce-i18n@xfce.org).
  
 +----
  
 ===== 5. Prepare the PO file ===== ===== 5. Prepare the PO file =====
Line 84: Line 97:
 Note: The command "msginit" works only if target po directory has Note: The command "msginit" works only if target po directory has
 generated .pot file. generated .pot file.
 +
 +----
  
 ===== 6. Translate the messages ===== ===== 6. Translate the messages =====
Line 186: Line 201:
   * An explanation for plural mechanism.   * An explanation for plural mechanism.
   * Commenting with "''#''".   * Commenting with "''#''".
 +
 +[[|Back to Top]]
 +----
  
 ==== 6.1 Translation Context ==== ==== 6.1 Translation Context ====
Line 203: Line 221:
 In the translated string discard everything up to the first "''|''" and In the translated string discard everything up to the first "''|''" and
 translate the rest only. translate the rest only.
 +
 +----
  
 ==== 6.2 Order switching ==== ==== 6.2 Order switching ====
Line 211: Line 231:
   msgid "Device %s has %s space left"   msgid "Device %s has %s space left"
   msgstr "%2$s space left on device %1$s"   msgstr "%2$s space left on device %1$s"
 +
 +[[|Back to Top]]
 +----
  
 ===== 7 Convert the output to UTF-8 (if it's not already UTF-8 encoded) ===== ===== 7 Convert the output to UTF-8 (if it's not already UTF-8 encoded) =====
Line 233: Line 256:
 encoded character sets. encoded character sets.
  
 +----
  
 ===== 8. Checking and Submitting the PO file ===== ===== 8. Checking and Submitting the PO file =====
Line 249: Line 273:
 translations to the list unless you have no warning. translations to the list unless you have no warning.
  
 +[[|Back to Top]]
 +----
  
 ===== 9. Template updates ===== ===== 9. Template updates =====
Line 275: Line 301:
  
 Sometimes, it requires updating POFILES.in in the first place, when there are strings in new source files. Sometimes, it requires updating POFILES.in in the first place, when there are strings in new source files.
 +
 +[[|Back to Top]]
 +----
  
 ===== 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 332: Line 361:
     xfwm4/branches/xfce_4_2/mcs-plugin/xfce-workspaces-settings.desktop     xfwm4/branches/xfce_4_2/mcs-plugin/xfce-workspaces-settings.desktop
  
 +[[|Back to Top]]
 +----
  
 ===== 11. XML files for desktop menu (it requires full source) ===== ===== 11. XML files for desktop menu (it requires full source) =====
Line 356: Line 387:
 then, newly translations will appear. then, newly translations will appear.
  
 +[[|Back to Top]]
 +----
  
 ===== 12. Checking your translations in the actual situation ===== ===== 12. Checking your translations in the actual situation =====
Line 372: Line 405:
 and restarting the application. and restarting the application.
  
 +----
  
 ===== 13. Documentation translation ===== ===== 13. Documentation translation =====
Line 390: Line 424:
  
 What you should do **as translator**, consists into editing the PO file of your locale inside the ''po-doc'' directory.  If your locale doesn't exist yet, run ''msginit'' inside ''po-doc''. What you should do **as translator**, consists into editing the PO file of your locale inside the ''po-doc'' directory.  If your locale doesn't exist yet, run ''msginit'' inside ''po-doc''.
 +
 +----
  
 ===== 14. Web page translation ===== ===== 14. Web page translation =====
Line 397: Line 433:
    $ svn co http://svn.xfce.org/svn/www/www.xfce.org/trunk/i18n/ www    $ svn co http://svn.xfce.org/svn/www/www.xfce.org/trunk/i18n/ www
  
 +----
  
 ===== 15. Feedback ===== ===== 15. Feedback =====
Line 406: Line 443:
 Your feedback will be gratefully appreciated. Your feedback will be gratefully appreciated.
  
 +----
  
 ===== 16. Appendix ===== ===== 16. Appendix =====
Line 424: Line 461:
   * Translation Project:   * Translation Project:
     * http://translationproject.org/html/welcome.html     * http://translationproject.org/html/welcome.html
 +
 +----
 +
 +===== 17. License and Authors =====
 +
 +This document is provided under the [[http://creativecommons.org/licenses/by/2.5/|Creative Commons Public License 2.5]].
 +It is based on the contributions by the following authors:
 +
 +  * Christian Biere <cbiere@users.sourceforge.net>
 +  * Thomas Schürger <trancetip@users.sourceforge.net>
 +  * Murphy <eqom14@users.sourceforge.net>
 +  * Daichi Kawahata <daichi@xfce.org>
 +  * Stavros Giannouris <stavrosg2002@freemail.gr>
 +  * Mike Massonnet <mmassonnet@xfce.org>
 +    * Added entry about web pages and po-doc documentation
 +    * Updated old references from SVN to Git
 +
 +[[|Back to Top]]
 +----
 +
 +[[:translations:advanced:|Return to Advanced Translation Resources page]]
 +
 +[[:translations:|Return to main Wiki translations page]]