PCSX2 Documentation/Using Poedit: Difference between revisions

no edit summary
mNo edit summary
No edit summary
Line 1: Line 1:
{{DocTabs|Section=2}}
''This wiki page is a work-in-progress. Information presented here may be partial or incomplete.''
This wiki page is a work-in-progress. Information presented here may be partial or incomplete.


When working with PCSX2 translations, Poedit is not only recommended, but is nearly a necessity. You will need to reference the PCSX2 source code frequently if you want to make accurate translations, and Poedit is the only PO editor I could find that has such a feature built-in (and actually works as expected).
When working with PCSX2 translations, Poedit is not only recommended, but is nearly a necessity. You will need to reference the PCSX2 source code frequently if you want to make accurate translations, and Poedit is the only PO editor I could find that has such a feature built-in (and actually works as expected).
Line 6: Line 5:
Important!! Make sure that you check out the right version/revision of PCSX2 that corresponds to the PO file you've downloaded.
Important!! Make sure that you check out the right version/revision of PCSX2 that corresponds to the PO file you've downloaded.


Step 1: Download and Install Poedit
==Download and Install Poedit==
http://www.poedit.net/download.php
http://www.poedit.net/download.php


Step 2: Download the latest POT files provided by us.
==Download the latest POT files provided by us.==
The latest stable release POT file pack can be found here: https://code.google.com/p/pcsx2/downloads/list ('''Warning''': this link has expired and as of may 2015 there are no alternatives)
The latest stable release POT file pack can be found here: https://code.google.com/p/pcsx2/downloads/list ('''Warning''': this link has expired and as of may 2015 there are no alternatives)


Line 18: Line 17:
As of the last update to this wiki, the latest POT file pack is the 0.9.8 release translation POT.
As of the last update to this wiki, the latest POT file pack is the 0.9.8 release translation POT.


Step 3: Check out PCSX2 sources
==Check out PCSX2 sources==
Make sure to check out the exact revision indicated by the POT archive! This is important since the source code associations listed in the POT file may not match newer revisions of PCSX2, making it difficult to resolve iconized identifiers. The PCSX2 revision can be gleaned from the comment section at the top of the POT files included in the archive.
Make sure to check out the exact revision indicated by the POT archive! This is important since the source code associations listed in the POT file may not match newer revisions of PCSX2, making it difficult to resolve iconized identifiers. The PCSX2 revision can be gleaned from the comment section at the top of the POT files included in the archive.


Note that Poedit does have the ability to update the translation table to match a newer revision of PCSX2. As a translator, you are welcome to update the translation table and get a head start on translating for an upcoming version of PCSX2. However, translations for public/stable releases of PCSX2 should be based on the POT files provided by the PCSX2 Team.
Note that Poedit does have the ability to update the translation table to match a newer revision of PCSX2. As a translator, you are welcome to update the translation table and get a head start on translating for an upcoming version of PCSX2. However, translations for public/stable releases of PCSX2 should be based on the POT files provided by the PCSX2 Team.


Step 4: Configure Poedit
==Configure Poedit==
Go to File->New Catalog from POT file..., and select one of the POT files provided in the package you downloaded in Step 2. You will see the following dialog:
Go to File->New Catalog from POT file..., and select one of the POT files provided in the package you downloaded in Step 2. You will see the following dialog:


Line 34: Line 33:
Make sure that the filename matches the original filename in the archive (see above for a list of PO files that PCSX2 looks for). Poedit will then create both PO and MO files for you. The PO file is the one you will later submit to the PCSX2 team.
Make sure that the filename matches the original filename in the archive (see above for a list of PO files that PCSX2 looks for). Poedit will then create both PO and MO files for you. The PO file is the one you will later submit to the PCSX2 team.


Step 5: Testing your translation!
==Testing your translation!==
Poedit will have saved a MO file in your PCSX2 Langs folder in Step 4, and if the MO file is in the right place and has the right filename, PCSX2 will automatically detect it and offer your language as an option. Run PCSX2 and change the current language to the one you've just created. You may have to restart PCSX2 for the new changes to take effect in all areas of the program.
Poedit will have saved a MO file in your PCSX2 Langs folder in Step 4, and if the MO file is in the right place and has the right filename, PCSX2 will automatically detect it and offer your language as an option. Run PCSX2 and change the current language to the one you've just created. You may have to restart PCSX2 for the new changes to take effect in all areas of the program.


Submitting Your Translated Work
==Submitting Your Translated Work==
Before starting a translation, please apply for it in this thread (if there has been no other applicant before you): http://forums.pcsx2.net/Thread-Program-and-Guide-translation-applications
Before starting a translation, please apply for it in this thread (if there has been no other applicant before you): http://forums.pcsx2.net/Thread-Program-and-Guide-translation-applications


Line 45: Line 44:


Translations are branched according to the releases of PCSX2 that they conform to.
Translations are branched according to the releases of PCSX2 that they conform to.


{{PCSX2 Main Documentation Navbox}}
{{PCSX2 Main Documentation Navbox}}
ninja
782

edits