| | 1 | = Documentation Translation Process = |
| | 2 | |
| | 3 | 1. Provide Jeff McKenna with your OSGeo User ID (which you can create at https://www.osgeo.org/cgi-bin/ldap_create_user.py) for commit privileges. |
| | 4 | |
| | 5 | 2. Go through the documentation howto (http://mapserver.org/development/documentation.html) and install Sphinx locally, to generate the necessary HTML files from the raw restructured text files. (and read through that entire howto document) |
| | 6 | |
| | 7 | 3. Checkout the docs from SVN locally (svn co https://svn.osgeo.org/mapserver/trunk/docs/ docs --username your-osgeo-id). |
| | 8 | |
| | 9 | 4. Create your language directory. ie: mkdir fr |
| | 10 | |
| | 11 | 5. Copy the ''images'' and ''include'' directories in your language directory. ie cp -r en/images en/include fr/ |
| | 12 | |
| | 13 | 6. You can now begin your translation. Copy the files you want to work on in your language directory and modify them.[[BR]] |
| | 14 | '''NOTE''': Don't copy blindly all the files from the ''en'' directory in your language directory. The server will automatically fallback to the English version the missing documents. Just copy/add gradually the translated files in the language directory. |
| | 15 | |
| | 16 | = Synchronization with English Version = |
| | 17 | |
| | 18 | 1. Determine your current English documentation revision: svn info en (Check the '''Last Changed Rev''' tag) |
| | 19 | |
| | 20 | 2. Update your working copy: svn up |
| | 21 | |
| | 22 | 3. Determine the up-to-date English documentation revision: svn info en (Check the '''Last Changed Rev''' tag) It Would be a good idea to note the "en" directory revision each time you sync. |
| | 23 | |
| | 24 | 4. Generate the diff file: svn diff -r current-revision:up-to-date-revision en/ |
| | 25 | |
| | 26 | 5. Apply the changes to your language directory and commit. |
| | 27 | |
