Translating PO Files - Revision history

Mike Linksvayer: Reverted edits by Tsanioke (talk) to last revision by Tommyogp

2012-03-23T14:44:51Z

Reverted edits by Tsanioke (talk) to last revision by Tommyogp

Tsanioke: /* Updating Translations */

2012-03-23T13:52:43Z

‎Updating Translations

Tommyogp: /* Translating using poEdit */

2010-10-24T14:49:14Z

‎Translating using poEdit

Tommyogp: /* Using poEdit */

2010-10-24T14:44:56Z

‎Using poEdit

Hamilton Abreu: Undo revision 39896 by OpenIDUser450 (Talk)

2010-08-16T00:34:44Z

Undo revision 39896 by OpenIDUser450 (Talk)

OpenIDUser450: /* Using GNU gettext tools */

2010-08-16T00:33:07Z

‎Using GNU gettext tools

Guaka: /* Using GNU gettext tools */ `++`


2007-10-04T19:53:49Z
‎Using GNU gettext tools:  <code>++

				
				
				
				
				
				← Older revision
				Revision as of 19:53, 4 October 2007
				
Line 36:
Line 36:
     $ msgmerge ccpublisher.po ../ccpublisher.pot > new_ccpublisher.po      $ msgmerge ccpublisher.po ../ccpublisher.pot > new_ccpublisher.po
    
− This will create a new file (<code>new_ccpublisher.po</code>) containing the merged translations.  After examining it, rename it to the original file name (ccpublisher.po). + This will create a new file (<code>new_ccpublisher.po</code>) containing the merged translations.  After examining it, rename it to the original file name (<code>ccpublisher.po</code>).



Guaka: /* Using poEdit */ image width
2007-10-04T19:52:58Z
‎Using poEdit:  image width

				
				
				
				
				
				← Older revision
				Revision as of 19:52, 4 October 2007
				
Line 23:
Line 23:
  If you are using [http://poedit.org poEdit], you can use the '''Update from POT file...''' option.  Go to the '''Catalog''' menu and select '''Update from POT file...'''.  Select the .pot file which cooresponds to the translation you have open (i.e. if you are updating ccpublisher.po, select ccpublisher.pot).      If you are using [http://poedit.org poEdit], you can use the '''Update from POT file...''' option.  Go to the '''Catalog''' menu and select '''Update from POT file...'''.  Select the .pot file which cooresponds to the translation you have open (i.e. if you are updating ccpublisher.po, select ccpublisher.pot).   
    
− [[Image:Poedit_select_catalog_template.png]] + [[Image:Poedit_select_catalog_template.png|600px]]
    
  poEdit will display the new strings it will add, as well as the obsolete strings it will remove.   poEdit will display the new strings it will add, as well as the obsolete strings it will remove.
    
− [[Image:Poedit_approve_updates.png]] + [[Image:Poedit_approve_updates.png|600px]]
    
  === Using GNU gettext tools ===   === Using GNU gettext tools ===



Nathan Yergler at 16:58, 4 October 2007
2007-10-04T16:58:52Z


				
				
				
				
				
				← Older revision
				Revision as of 16:58, 4 October 2007
				
Line 3:
Line 3:
  == Getting Started ==   == Getting Started ==
    
− ''Download the .pot files from Pootle'' + To begin translating a Creative Commons application, you will need the PO Template (.pot) file(s).  These are typically stored in Subversion in a <code>template</code> locale directory.  If you have questions about where to find the templates for a specific project, email the [[Mailing Lists|cc-devel]] mailing list.
    
  === Translating using poEdit ===   === Translating using poEdit ===
Line 10:
Line 10:
    
  Just use poEdit's '''File''' -> '''New catalog from POT file...''' function will easily doing so. It even can compile .po into .mo file in the same time you pressing '''Save'''.   Just use poEdit's '''File''' -> '''New catalog from POT file...''' function will easily doing so. It even can compile .po into .mo file in the same time you pressing '''Save'''.
−  
− === Translating under Windows ===  
−  
− To translate under Windows, download and install an [[CcPublisher 2_2|i18n-enabled release]] (2.1 or later).  In the installation directory you will find a '''resources''' directory, which contains the '''locale''' subdirectory.  Create a new subdirectory under '''locale''' with a name matching your new locale.  For example, to translate ccPublisher into French, create a directory named <code>fr_FR</code>.  
−  
− [[Image:Locale_folder_thumb.png|frame|The ccPublisher locale folder ([[:Image:Locale_folder.png|full size]]).]]  
−  
− Copy the template files from '''locale''' into your new directory; rename them from .pot to .po.  
−  
− [[Image:Fr_FR_thumb.png|frame|The .po files for the new locale ([[:Image:Fr_FR.png|full size]]).]]  
−  
− Edit each .po file per the instructions above.  
−  
− [[Image:Edit_thumb.png|frame|Editting the .po file ([[:Image:Edit.png|full size]]).]]  
−  
− If you are translating ccPublisher to your default locale, simply run ccPublisher to test your translation.  If you are translating to a different locale, create a shortcut to <code>ccp.exe</code> and modify it to pass the --locale parameter in.  
−  
− [[Image:Edit_shortcut_thumb.png|frame|Editting a shortcut to ccp.exe to specify a locale ([[:Image:Edit_shortcut.png|full size]]).]]  
−  
− When you run ccPublisher with the new locale, the message catalogs will be compiled and the application should reflect your translation.  
−  
− [[Image:CcPublisher_fr_thumb.png|frame|ccPublisher running with the French locale specified; note the File menu reflects the change to Dossier ([[:Image:CcPublisher_fr.png|full size]]).]]  
−  
− === Translating under Mac OS X ===  
−  
− Translations for Mac OS X are currently shipped inside the application bundle.  To find the translation files via the Finder, right click on the ccPublisher application and select '''Show Package Contents'''.  This will open the application bundle in a Finder window.  The locale files are stored in '''Contents''' -> '''Resources''' -> '''resources''' -> '''locale'''.  Navigate to the locale directory and follow the instructions for Linux or Windows.  
    
  == Submitting a Translation ==   == Submitting a Translation ==
    
− Once you have completed or updated a translation and tested it, you can submit it to the ccPublisher developers using the Roundup bug tracking system.  [http://roundup.creativecommons.org/ccpublisher/issue?@template=item&topic=i18n&priority=feature&title=New+Translation Click here] to create a new issue with the correct default values set.  Add the locale information for your new translation to the title and attach the .po and .html files you created (either individually or in a zip/tar file).  + Once you have completed or updated a translation and tested it, you can submit it by emailing the [[Mailing Lists|cc-devel]] mailing list.
−    
− We encourage people submitting bugs and feature requests via Roundup to create accounts so they can easily monitor issues they create.  
    
  == Updating Translations ==   == Updating Translations ==



Nathan Yergler: New page: Translations for Creative Commons software and web applications are stored in gettext message catalogs.  Creative Commons uses [http://translate.creativecommons.org Pootle] t...
2007-10-04T16:54:48Z
New page: Translations for Creative Commons software and web applications are stored in gettext message catalogs.  Creative Commons uses [http://translate.creativecommons.org Pootle] t...
New page
[[Translate|Translations]] for Creative Commons software and web applications are stored in gettext message catalogs.  Creative Commons uses [http://translate.creativecommons.org Pootle] to provide a web-based translation interface.  '''Using Pootle is the preferred method for translating ccPublisher.  Instructions for using Pootle can be found [[Translating with Pootle|here]].'''  This page describes how to create translations using other tools for manipulating the message catalogs.



== Getting Started ==



''Download the .pot files from Pootle''



=== Translating using poEdit ===



[http://www.poedit.net/ poEdit] is an Open Source cross-platform gettext catalogs (.po files) editor. It is built with wxWidgets toolkit and can run on any platform supported by it.  It aims to provide more convenient approach to editing catalogs than launching Notepad (or vi) and editing the file by hand.  Official releases are available from the poEdit web site for Windows and Linux.  A version for Mac OS X is available at http://www.poedit.net/download.php#osx.  The poEdit team reports it is a beta release and the 1.3.6 version is known to be broken, but some translators have had success using it for ccPublisher. 



Just use poEdit's '''File''' -> '''New catalog from POT file...''' function will easily doing so. It even can compile .po into .mo file in the same time you pressing '''Save'''.



=== Translating under Windows ===



To translate under Windows, download and install an [[CcPublisher 2_2|i18n-enabled release]] (2.1 or later).  In the installation directory you will find a '''resources''' directory, which contains the '''locale''' subdirectory.  Create a new subdirectory under '''locale''' with a name matching your new locale.  For example, to translate ccPublisher into French, create a directory named <code>fr_FR</code>.



[[Image:Locale_folder_thumb.png|frame|The ccPublisher locale folder ([[:Image:Locale_folder.png|full size]]).]]



Copy the template files from '''locale''' into your new directory; rename them from .pot to .po.



[[Image:Fr_FR_thumb.png|frame|The .po files for the new locale ([[:Image:Fr_FR.png|full size]]).]]



Edit each .po file per the instructions above.



[[Image:Edit_thumb.png|frame|Editting the .po file ([[:Image:Edit.png|full size]]).]]



If you are translating ccPublisher to your default locale, simply run ccPublisher to test your translation.  If you are translating to a different locale, create a shortcut to <code>ccp.exe</code> and modify it to pass the --locale parameter in.



[[Image:Edit_shortcut_thumb.png|frame|Editting a shortcut to ccp.exe to specify a locale ([[:Image:Edit_shortcut.png|full size]]).]]



When you run ccPublisher with the new locale, the message catalogs will be compiled and the application should reflect your translation.



[[Image:CcPublisher_fr_thumb.png|frame|ccPublisher running with the French locale specified; note the File menu reflects the change to Dossier ([[:Image:CcPublisher_fr.png|full size]]).]]



=== Translating under Mac OS X ===



Translations for Mac OS X are currently shipped inside the application bundle.  To find the translation files via the Finder, right click on the ccPublisher application and select '''Show Package Contents'''.  This will open the application bundle in a Finder window.  The locale files are stored in '''Contents''' -> '''Resources''' -> '''resources''' -> '''locale'''.  Navigate to the locale directory and follow the instructions for Linux or Windows.



== Submitting a Translation ==



Once you have completed or updated a translation and tested it, you can submit it to the ccPublisher developers using the Roundup bug tracking system.  [http://roundup.creativecommons.org/ccpublisher/issue?@template=item&topic=i18n&priority=feature&title=New+Translation Click here] to create a new issue with the correct default values set.  Add the locale information for your new translation to the title and attach the .po and .html files you created (either individually or in a zip/tar file).  



We encourage people submitting bugs and feature requests via Roundup to create accounts so they can easily monitor issues they create.



== Updating Translations ==



Strings are sometimes added or removed from the application during development cycles.  At those times it is necessary to update the translation (.po) files with the new strings and translations.  



=== Using poEdit ===



If you are using [http://poedit.org poEdit], you can use the '''Update from POT file...''' option.  Go to the '''Catalog''' menu and select '''Update from POT file...'''.  Select the .pot file which cooresponds to the translation you have open (i.e. if you are updating ccpublisher.po, select ccpublisher.pot).  



[[Image:Poedit_select_catalog_template.png]]



poEdit will display the new strings it will add, as well as the obsolete strings it will remove.



[[Image:Poedit_approve_updates.png]]



=== Using GNU gettext tools ===



The [http://www.gnu.org/software/gettext/ GNU gettext] tools include a command-line tool called <code>msgmerge</code> which may be used to merge two catalogs together.  For example, to use msgmerge for ccpublisher.po, you can use the following commands (Linux):



  $ cd resources/locale/en_US

  $ msgmerge ccpublisher.po ../ccpublisher.pot > new_ccpublisher.po



This will create a new file (<code>new_ccpublisher.po</code>) containing the merged translations.  After examining it, rename it to the original file name (ccpublisher.po).

← Older revision		Revision as of 19:53, 4 October 2007
Line 36:		Line 36:
	$ msgmerge ccpublisher.po ../ccpublisher.pot > new_ccpublisher.po		$ msgmerge ccpublisher.po ../ccpublisher.pot > new_ccpublisher.po

−	This will create a new file (<code>new_ccpublisher.po</code>) containing the merged translations. After examining it, rename it to the original file name (ccpublisher.po).	+	This will create a new file (<code>new_ccpublisher.po</code>) containing the merged translations. After examining it, rename it to the original file name (<code>ccpublisher.po</code>).

Translating PO Files - Revision history

Mike Linksvayer: Reverted edits by Tsanioke (talk) to last revision by Tommyogp

Tsanioke: /* Updating Translations */

Tommyogp: /* Translating using poEdit */

Tommyogp: /* Using poEdit */

Hamilton Abreu: Undo revision 39896 by OpenIDUser450 (Talk)

OpenIDUser450: /* Using GNU gettext tools */

Guaka: /* Using GNU gettext tools */ ++

Guaka: /* Using poEdit */ image width

Nathan Yergler at 16:58, 4 October 2007

Nathan Yergler: New page: Translations for Creative Commons software and web applications are stored in gettext message catalogs. Creative Commons uses [http://translate.creativecommons.org Pootle] t...

Guaka: /* Using GNU gettext tools */ `++`