Xfce Wiki

Sub domains
 

Differences

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

Link to this comparison view

Next revision		Previous revision
translations:translation_guidance_in_xfce [2009/08/17 14:53] – created miketranslations:translation_guidance_in_xfce [2019/04/30 14:59] (current) – Add Virtaal scootergrisen
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 <cbiere@users.sourceforge.net>
   * Thomas Schürger <trancetip@users.sourceforge.net>   * Thomas Schürger <trancetip@users.sourceforge.net>
   * Murphy <eqom14@users.sourceforge.net>   * Murphy <eqom14@users.sourceforge.net>
Line 13: Line 13:
   * Stavros Giannouris <stavrosg2002@freemail.gr>   * Stavros Giannouris <stavrosg2002@freemail.gr>
   * Mike Massonnet <mmassonnet@xfce.org>   * Mike Massonnet <mmassonnet@xfce.org>
 +    * 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#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 from the SVN repository ===== +You can get the latest PO files from the Transifex platform, available at https://www.transifex.com/xfce/public/
- +
-You can get the latest PO files from SVN, +
- +
-  $ svn checkout http://svn.xfce.org/svn/xfce/modules/trunk-po +
- +
-or current stable version 4.4, +
- +
-  $ svn checkout http://svn.xfce.org/svn/xfce/modules/4.4-po +
- +
-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#svn_scripts_for_translating_.po_files|our wiki]]. +
- +
-If you don't have access permission to the SVN repository via SSL, +
-replace `https://' with `http://' in that scripts, this may work. +
  
 +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/Apps/Gtranslator/
  
-  * KBabel - An advanced and easy to use PO-file editor. +  * Lokalize - An advanced and easy to use PO-file editor. 
-    * http://i18n.kde.org/tools/kbabel/+    * https://userbase.kde.org/Lokalize 
 + 
 +  * Virtaal - Multi-format translation tool. 
 +    * http://virtaal.translatehouse.org/
  
 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 70:
  
  
-===== 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 76:
   $ 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 83:
  
 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, 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 186:
   * 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 242:
 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 you can follow the instructions found on the translations wiki page 
-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 250:
  
  
-===== 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 257:
 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. To update the PO  
 +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
  
   $ ./autogen.sh   $ ./autogen.sh
- 
-when you are in the trunk/ tree, or in branches/xfce_4_4 tree 
- 
-  $ ./configure 
  
 will be required in the each module's directory at first, then simply will be required in the each module's directory at first, then simply
Line 297: Line 274:
 the POT file. the POT file.
  
-After that you can check your language's PO file for missing/fuzzy +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 "''make update-po''" again. This will +
-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 331:
     xfwm4/branches/xfce_4_2/mcs-plugin/xfce-wm-settings.desktop     xfwm4/branches/xfce_4_2/mcs-plugin/xfce-wm-settings.desktop
     xfwm4/branches/xfce_4_2/mcs-plugin/xfce-workspaces-settings.desktop     xfwm4/branches/xfce_4_2/mcs-plugin/xfce-workspaces-settings.desktop
- 
-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).  You only need to follow this procedure for the 4.2 and 4.4 branch.//+//The translations for the desktop menu are translated directly in the po files for the development branch (post 4.4 branch).  You only need to follow this procedure for the 4.2 and 4.4 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/branches/xfce_4_4/menu.xml.${lang} +    xfdesktop/menu.xml.${lang} 
-    xfdesktop/branches/xfce_4_4/modules/menu/xfce-registered-categories.xml.${lang}+    xfdesktop/modules/menu/xfce-registered-categories.xml.${lang}
  
 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 359:
 ===== 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 378:
  
   * Maintain the documentation (job for the maintainer/developper):   * Maintain the documentation (job for the maintainer/developper):
-    - Run the "''configure''" script with the flag "''--enable-xml2po''"+    - Run the "''configure''" script with the flag "''%%--enable-xml2po%%''"
     - Update the POT and PO files with "''make -C po-doc update-po''"     - Update the POT and PO files with "''make -C po-doc update-po''"
     - Update the XML files with the newly translated PO files with "''make -C po-doc update-xml''"     - Update the XML files with the newly translated PO files with "''make -C po-doc update-xml''"
  
-Note: you need the ''xml2po'' tool.  It can be compiled from [[http://cvs.gnome.org/viewcvs/gnome-doc-utils/xml2po/|CVS GNOME]] or installed from your distro (check for the package ''poxml''/''gnome-doc-utils'').+Note: you need the ''xml2po'' tool.  It can be compiled from [[https://git.gnome.org/browse/gnome-doc-utils/tree/xml2po|GNOME Git]] or installed from your distro (check for the package ''poxml''/''gnome-doc-utils'').
  
   * 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 "''configure''" script with the flag "''--enable-xsltproc''"+    - Run the "''configure''" script with the flag "''%%--enable-xsltproc%%''"
     - Run "''make -C docs''"     - Run "''make -C docs''"
     - The result is compiled inside ''docs/$the_docbook/$your_locale/html/''     - The result is compiled inside ''docs/$the_docbook/$your_locale/html/''
Line 440: Line 403:
  
   * Xfce translations mailing list <xfce-i18n@xfce.org>   * Xfce translations mailing list <xfce-i18n@xfce.org>
-  * Daichi Kawahata <daichi@xfce.org> (current maintainer) 
  
 Your feedback will be gratefully appreciated. Your feedback will be gratefully appreciated.
Line 449: Line 411:
  
   * The complete GNU gettext manual:   * The complete GNU gettext manual:
-    * http://www.gnu.org/manual/gettext/index.html+    * http://www.gnu.org/software/gettext/manual/gettext.html
  
   * Standard country codes (ISO 3166):   * Standard country codes (ISO 3166):
Line 458: Line 420:
  
   * Freedesktop.org desktop entry spec:   * Freedesktop.org desktop entry spec:
-    * http://www.freedesktop.org/standards/desktop-entry-spec/+    * https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html
  
   * Translation Project:   * Translation Project:
     * http://translationproject.org/html/welcome.html     * http://translationproject.org/html/welcome.html
- 
-  * Xfce translations statistics: 
-    * http://xfce.org/~kelnos/xfce4/i18n/ 
-