1264708713currentLine 11: Line 11: For example, a PO file from our Pootle server can work well - this way the same terms are also recommended in Pootle. We need the experts in software localisation in each language to recommend which URL should be used for their language. Contact us if this is not yet configured for your language. For example, a PO file from our Pootle server can work well - this way the same terms are also recommended in Pootle. We need the experts in software localisation in each language to recommend which URL should be used for their language. Contact us if this is not yet configured for your language. -All file formats supported by Virtaal can be used (PO, XLIFF, Qt .ts, TBX, TMX, Wordfast TM, OmegaT Glossary (with Toolkit 1.5.1) .mo, .qm, .qph).  (Not that all of these are necessarily a good idea for your terminology :-)+All file formats supported by Virtaal can be used. This feature was introduced in Virtaal 0.5.

1258559050currentLine 28: Line 28:       * Local files on your computer       * Local files on your computer       * [[http://open-tran.eu|Open-Tran.eu]]       * [[http://open-tran.eu|Open-Tran.eu]] -      * Files downloaded from the Translate project+      * [[autoterm|Automatically downloaded terminology files]]     * Reuse existing translations. Suggestions can come from:     * Reuse existing translations. Suggestions can come from:       * The current file       * The current file

1264431238currentLine 8: Line 8:     * Searching is done with Unicode normalisation     * Searching is done with Unicode normalisation     * Can submit directly to [[version control]] including CVS, Subversion, darcs, git and Bazaar     * Can submit directly to [[version control]] including CVS, Subversion, darcs, git and Bazaar  +    * Can host projects without being tied to a version control system  +    * Can host projects with different file layouts     * Event [[notifications]] using RSS feeds.     * Event [[notifications]] using RSS feeds.  +    * User submitted news items.     * Integrates with the Translate Toolkit     * Integrates with the Translate Toolkit -      * Provides [[statistics]] of strings, words, and errors +      * Provides up to date [[statistics]] of strings, words, and errors  -      * upload files in PO or XLIFF format+      * upload files in PO or XLIFF format (with different merge strategies)       * **Highlights errors** in translation       * **Highlights errors** in translation     * Require **user authentication** but can allow multiple modes including suggestion     * Require **user authentication** but can allow multiple modes including suggestion Line 18: Line 21:     * [[permissions|Assign permissions]] to various translators to perform different functions     * [[permissions|Assign permissions]] to various translators to perform different functions     * Uses **Unicode** throughout so will work with any target language     * Uses **Unicode** throughout so will work with any target language -    * <del>Teams can set [[goals]]</del> (not available in version 2.0) +    * Teams can set [[goals]] (not available in version 2.0)  -    * <del>[[assigning|Assign work]] to various translators</del> (not available in version 2.0)+    * [[assigning|Assign work]] to various translators (not available in version 2.0)   * Editor   * Editor     * A **web-based translation editor** means you can translate anywhere online     * A **web-based translation editor** means you can translate anywhere online     * The web interface is translated into many languages.     * The web interface is translated into many languages. -    * with live translation enabled, translations of the interface are updated live as you translate the Pootle project+    * With live translation enabled, translations of the interface are updated live as you translate the Pootle project     * Implements **Right-to-Left** display for those languages that need it for both translation content and the user interface     * Implements **Right-to-Left** display for those languages that need it for both translation content and the user interface     * Uses customised styling for languages to ensure proper display of both source text, target text, and the user interface     * Uses customised styling for languages to ensure proper display of both source text, target text, and the user interface     * Highlights XML tags and possible spacing problems     * Highlights XML tags and possible spacing problems -    * Find remaining work by filtering untranslated or fuzzy units+    * Easily find remaining work by filtering untranslated or fuzzy units     * Review quality with many [[checks|quality checks]] for translation errors, customised for project and language conventions     * Review quality with many [[checks|quality checks]] for translation errors, customised for project and language conventions     * Handles PO plurals, msgctx and KDE 3 style context     * Handles PO plurals, msgctx and KDE 3 style context

1264452523currentLine 28: Line 28:   * [[http://webtest.okada.jp.org/|R into Japanese]]   * [[http://webtest.okada.jp.org/|R into Japanese]]   * [[http://rech.jm.u-psud.fr:8080/|Installation of Pootle]] for [[http://www.ofset.org/|OFSET]]   * [[http://rech.jm.u-psud.fr:8080/|Installation of Pootle]] for [[http://www.ofset.org/|OFSET]] -  * [[http://l10n.i-rs.ru/]] Translation of OpenOffice.org into Russian, Turkish and Ukrainian    * [[https://dev.laptop.org/translate/|Localisation server]] for the [[http://laptop.org|One Laptop Per Child]] project.   * [[https://dev.laptop.org/translate/|Localisation server]] for the [[http://laptop.org|One Laptop Per Child]] project.   * [[http://translate.gnulinuxmatters.org/|The GLM Translation Service]] - [[http://www.gnulinuxmatters.org/|GNU/Linux Matters]]   * [[http://translate.gnulinuxmatters.org/|The GLM Translation Service]] - [[http://www.gnulinuxmatters.org/|GNU/Linux Matters]] Line 119: Line 118:   * http://activate.singular-tech.com:8080/   * http://activate.singular-tech.com:8080/   * http://www.ksobwalden.ch:8000/   * http://www.ksobwalden.ch:8000/  +  *  * [[http://l10n.i-rs.ru/]] Translation of OpenOffice.org into Russian, Turkish and Ukrainian (OpenOffice.org now has their own Pootle server)

1206381769currentLine 1: Line 1:  +<note>  +A newer tool called [[toolkit:poterminology]] is now part of the [[toolkit:index|Translate Toolkit]] and should work better for all users. This page is only left for reference.  +</note>  + ====== Clunky method to create glossaries ====== ====== Clunky method to create glossaries ====== -This method is for Windows users, but the principles can be applied in Linux as well.  It is for creating a subject specific glossary in a specific software translation project.  The idea is to get a list of commonly used jargon from the project that can be translated beforehand.+This old method is for Windows users, but the principles can be applied in Linux as well.  It is for creating a subject specific glossary in a specific software translation project.  The idea is to get a list of commonly used jargon from the project that can be translated beforehand.   +   +<note>   +Rather use [[toolkit:poterminology]] than following these instructions.   +</note> -//TODO: Change this file to contain only free/libre tools and resources.//  ===== 1. Extract the source text ===== ===== 1. Extract the source text =====

1260351447currentLine 16: Line 16:   * [[Installation]]   * [[Installation]] -  * [[Startup options]]    * [[Important Changes]]   * [[Important Changes]] Line 25: Line 24:   * [[terminology matching|Adding a terminology project]]   * [[terminology matching|Adding a terminology project]]   * [[updatetm|Working with Translation Memory]]   * [[updatetm|Working with Translation Memory]]  +  * [[optimisation|Pootle optimisation]]  +  +====== Older documentation (Pootle 1.2) ======  +  * [[Startup options]]   * [[nginx|Advanced Pootle setup with Nginx]]   * [[nginx|Advanced Pootle setup with Nginx]] -  * [[Setting up a simple Pootle server]]    * [[assigning|Assigning work]]   * [[assigning|Assigning work]]   * [[logstats|Retrieving translator statistics from the server log]]   * [[logstats|Retrieving translator statistics from the server log]] -  ====== Guides ====== ====== Guides ======

1258469573currentLine 12: Line 12: ===== 2.0 ===== ===== 2.0 =====   * Pootle now uses the Django framework and data that previously was stored in flat files (projects, languages, users and permissions) is now stored in a database. [[migration|Migration]] scripts are provided.   * Pootle now uses the Django framework and data that previously was stored in flat files (projects, languages, users and permissions) is now stored in a database. [[migration|Migration]] scripts are provided.  +  +Review all suggestions before migrating, and note that [[assigning|assignments]] are not yet supported in Pootle 2.0. ===== 1.2.0 ===== ===== 1.2.0 =====

1258545125currentLine 1: Line 1:  +====== Pootle under Nginx ======  +Running Pootle under a web server such as Nginx will improve performance. Also see the page about [[Apache]] that might help with ideas on reaching the best performance with Pootle.  +  +Since version 2.0, Pootle can run easily under any WSGI compatible server. For more information about Nginx and WSGI, visit this page:  +  +http://wiki.nginx.org/NginxNgxWSGIModule  +  +The rest of the page explains how to set up Nginx as a reverse proxy for Pootle (only really relevant for Pootle versions before 2.0 like 1.2).  + <note>This information is about an old Pootle version and it may not strictly apply to the current version of Pootle.</note> <note>This information is about an old Pootle version and it may not strictly apply to the current version of Pootle.</note> Line 4: Line 13: -====== Nginx server ====== +===== Nginx server ===== Nginx (Engine X) - is an HTTP(S) server, HTTP(S) reverse proxy and IMAP/POP3 proxy server written by Igor Sysoev. It has been running on many heavily loaded Russian sites for more than two years. The sources are licensed under a BSD-like license. Nginx (Engine X) - is an HTTP(S) server, HTTP(S) reverse proxy and IMAP/POP3 proxy server written by Igor Sysoev. It has been running on many heavily loaded Russian sites for more than two years. The sources are licensed under a BSD-like license. Line 13: Line 21:   * http://wiki.codemongers.com/   * http://wiki.codemongers.com/ - +===== Add Pootle to Nginx config ===== -====== Add Pootle to Nginx config ======+ Run PootleServer on localhost and add next lines to nginx.conf (assumed you already configured and run Nginx on your server): Run PootleServer on localhost and add next lines to nginx.conf (assumed you already configured and run Nginx on your server): Line 54: Line 61:         }     } -   

1258679048currentLine 1: Line 1: ====== Running Pootle on Apache ====== ====== Running Pootle on Apache ======  +  +Running Pootle under Apache will improve performance, give you more flexibility, and might be better for security. It is strongly recommended to run Pootle under Apache or a similar web server. ===== Pootle 2.0: mod_python or mod_wsgi ===== ===== Pootle 2.0: mod_python or mod_wsgi ===== -Running Pootle under Apache requires [[http://www.modpython.org/|mod_python]] or [[http://code.google.com/p/modwsgi/|mod_wsgi]]. ''mod_wsgi'' is recommended.+For anything except the most trivial deployments it is best to use a database server such as MySQL rather than the default SQLite, and to install memcached and configure it in localsettings.py.   +   +Make sure to review your global Apache settings (something like  /etc/apache2/httpd.conf or /etc/httpd/conf/httpd.conf) for the server-pool settings. The default settings provided by Apache are too high for running a web application like Pootle. The ideal settings depend heavily on your hardware and the number of users you expect to have. A moderate server with 1GB memory might set MaxClients to something like 20 (for example).   +   +Running Pootle 2 under Apache requires [[http://www.modpython.org/|mod_python]] or [[http://code.google.com/p/modwsgi/|mod_wsgi]]. ''mod_wsgi'' is recommended. You need to extract Pootle in a directory accessible to the apache user. You need to extract Pootle in a directory accessible to the apache user. Line 9: Line 15: Make sure Apache has read access to all of Pootle's files and write access to the ''dbs'' and ''po'' subdirectories. Make sure Apache has read access to all of Pootle's files and write access to the ''dbs'' and ''po'' subdirectories. -Depending on which apache module you'll use to deploy pootle, you need to add the relevant portion to your apache's configuration.+Depending on which Apache module you'll use to deploy Pootle, you need to add the relevant portion to your Apache configuration. ==== mod_wsgi ==== ==== mod_wsgi ====

1263550708currentLine 147: Line 147: ===== O ===== ===== O =====  +| oc | Occitan | nplurals=2; plural=(n > 1) | | or | Oriya | nplurals=2; plural=(n != 1) | | or | Oriya | nplurals=2; plural=(n != 1) |

1259247722currentLine 77: Line 77: I have to give it to the Virtaal/Pootle folks for being a cool crew when it comes to helping out users of their tools I have to give it to the Virtaal/Pootle folks for being a cool crew when it comes to helping out users of their tools  +  +----  +  +[[http://grahamweldon.com/|Graham Weldon]] (lead developer of CakePHP 2.0):  +  +*Spectacular* work. Absolutely mind-bogglingly brilliant. And you can quote me on that.

1263301206currentLine 3: Line 3: Extracts all the source text from a directory of POT files or the target text from a directory of PO files, removing PO headers and optionally the accelerator keys. Extracts all the source text from a directory of POT files or the target text from a directory of PO files, removing PO headers and optionally the accelerator keys. -If you want to use other tools to analyse the text within a translation project then this is the tool for you.  You can use it to, for instance, calculate word frequencies to create an initial glossary based on the pure source text.+If you want to use other tools to analyse the text within a translation project, then this is the tool for you.  For example, you can use it to calculate word frequencies to create an initial glossary based on the pure source text. ===== Prerequisites ===== ===== Prerequisites ===== -* GNU Gettext +  * GNU Gettext  -* sed+ * sed

1256159816currentLine 14: Line 14: </html> </html> -  * [[pootle:index|Pootle]] - ??? ?? ?? +  * [[ko:pootle:index|Pootle]] - ??? ?? ??  -    * [[pootle:?? ??]]+    * [[ko:pootle:?? ??]]     * [[http://sourceforge.net/project/showfiles.php?group_id=91920&package_id=144807|????]]     * [[http://sourceforge.net/project/showfiles.php?group_id=91920&package_id=144807|????]]     * [[http://pootle.locamotion.org|Our server]] ([[pootle:Live servers|others]])     * [[http://pootle.locamotion.org|Our server]] ([[pootle:Live servers|others]])

currentLine 1: Line 1:  +====== ?? ======  +??(Pootle)? ?? ??? ???? ?? ?? ? ?? ???????. ??? ??, ?? ??, ?? ?? ?? ??? ????, ??? ??? ?? ??? ?????. ??? [[..:..:pootle:live_servers|???? ??]]? ????? ?????? ??? ?? ????.(?? ??, ? ??, ?? [[guide:translateathon|Translate@thons]])  +  +??? [[toolkit:index|?? ????(Translate Toolkit)]]? ??? API? ?????. ??? ???? ???? ??? ?? ?? ?? ??? ???? ?? ???? ?? ????? ?????.  +  +?? ?? ??? http://pootle.locamotion.org/ ??, ? ??? ?? ??? [[..:..:pootle:official_server|??]]?? ??? ? ????.  +  +====== ?? ?? ======  +  +  * [[Installation]]  +  * [[Startup options]]  +  * [[Features]]  +  * [[Important Changes]]  +  * [[toolkit:Contributing]]  +  * [[developers:Reporting bugs]]  +  * [[What's in a name?]]  +  * [[Copyright]]  +  +  +  +====== ??? ??? ======  +  +  * [[Setting up a simple Pootle server]]  +  * [[assigning|Assigning work]]  +  * [[version control|Working with version control and Pootle]]  +  * [[terminology matching|Adding a terminology project]]  +  * [[updatetm|Working with Translation Memory]]  +  * [[apache|Advanced Pootle setup with Apache]]  +  * [[nginx|Advanced Pootle setup with Nginx]]  +  * [[logstats|Retrieving translator statistics from the server log]]  +  +  +====== ??? ======  +  +  * [[users:User Guide]] ([[users:af:User Guide|af]], [[users:cs:User Guide|cs]], [[users:de:User Guide|de]], [[users:es:User Guide|es]], [[users:eu:User Guide|eu]], [[users:fa:User Guide|fa]], [[users:fr:User Guide|fr]], [[users:nl:User Guide|nl]]) ??? ???? ?? ??? ??? ???? ????.  +    * ???? ??  +    * ?? ?? ??  +    * ??? ??? ??  +    * ??  +    * ?? ????  +  * [[Site Administrator's Guide]]  +    * ?? ??, ?? ??, ??  +  * [[Admin Guide]]  +    * ???, ??, ???? ??  +  * [[Developer Guide]]  +    * FAQ, ??, ????, ??  +  * [[Tips from the trench]]  +    * ??? ?? ??  +  +  +  +  +  +  +  +  +  +==== ? ?? ??? ====  +?? ???? ???? ??? ??????. ? ??? ???? [[..:..:pootle:live servers|??? ???? ?? ????]]? ?? ?? ?? ??? ??? ?????.  +  * http://www.colivre.coop.br/Tech/TraducaoPootle  +  * http://wiki.creativecommons.org/Translating_with_Pootle  +  * http://wiki.services.openoffice.org/wiki/Pootle_User_Guide  +  * http://wiki.services.openoffice.org/wiki/Pootle_Glossary_Guide  +  * http://mr-dust.pe.kr/entry/How-to-translate-OpenOfficeorg  +  * http://docs.linux.org.ua/dlou/index.php/Pootle (Ukrainian, ??????????)  +  * http://takanory.net/plone/japanese/pootle (Japanese, ???)  +  * http://www.moongift.jp/2006/09/2326/ (Japanese, ???)  +  * https://tracker.gnulinuxmatters.org/wiki/Translating/Pootle  +  * http://kondosyokai.org/~john/computing/pootle/OpenBSD-installation.html  +  * http://gustavonarea.net/blog/posts/installing-pootle-on-debian-etch-the-easiest-way/  +  * http://wiki.laptop.org/go/Pootle (OLPC project)  +  * http://wiki.list.org/display/DEV/Pootle+primer (mailman project)  +  * http://wiki.squid-cache.org/Translations/Basics (Squid project)  +  * http://mindjunks.co.cc/2008/12/pootle-as-a-online-transalation-toolkit/ - installing on Fedora

1256067971currentLine 23: Line 23:   * [[http://bugs.locamotion.org/enter_bug.cgi?product=Virtaal|?? ??]]   * [[http://bugs.locamotion.org/enter_bug.cgi?product=Virtaal|?? ??]]   * [[https://lists.sourceforge.net/lists/listinfo/translate-devel|Translate-devel ??? ???]]   * [[https://lists.sourceforge.net/lists/listinfo/translate-devel|Translate-devel ??? ???]] -  ===== ???? ===== ===== ???? ===== -There are many ways of contributing to Virtaal. Join the mailing list or IRC channel to join our effort. You can translate the user interface into your language. Do that by installing Virtaal and opening the [[http://translate.svn.sourceforge.net/viewvc/translate/src/trunk/virtaal/po/virtaal.pot|latest POT file]]. Attach it in a bug report, or send it to one of the developers.+???? ???? ?? Virtaal? ??? ? ????. ?? ??? ???? IRC? ??????. ?? ??? ??? Virtaal? ????? ??? ? ? ????. Virtaal? ???? [[http://translate.svn.sourceforge.net/viewvc/translate/src/trunk/virtaal/po/virtaal.pot|?? POT ??]]? ??? ???? ?????. ?? ?? ?? ??? ???? ?? ??? ??? ??? ? ? ??? ????. -You can join our effort to distribute Virtaal by sharing informing with people, writing documentation or packaging for more platforms.+? ?? Virtaal? ?? ??? ????? ?? ???? ???? ??? ????? Virtaal? ??? ??? ?? ????. -If you would like to contribute to Virtaal by programming, you can start by reading the instructions on the following pages:+Virtaal ??? ???? ???, ?? ?? ???? ?? ??? ??????. -  * [[Building]] +  * [[Building|??]]  -  * [[Testing]] +  * [[Testing|???]]  -  * [[Development Plans]] +  * [[Development Plans|?? ??]]  -  * [[Suggestions]]+  * [[Suggestions|??]]

1256129963currentLine 11: Line 11: View a list of [[http://bugs.locamotion.org/buglist.cgi?query_format=specific&order=relevance+desc&bug_status=__open__&product=Virtaal&content=|open requests and bugs]]. View a list of [[http://bugs.locamotion.org/buglist.cgi?query_format=specific&order=relevance+desc&bug_status=__open__&product=Virtaal&content=|open requests and bugs]]. -Features that are likely to get in the foreseeable future:+Features that are likely to be developed in the foreseeable future:   * <del>Terminology help</del> - supported since version 0.4   * <del>Terminology help</del> - supported since version 0.4   * Better handling of XLIFF inline elements and placeables - already supported since version 0.4   * Better handling of XLIFF inline elements and placeables - already supported since version 0.4

1255935584currentLine 61: Line 61:     * Word, Excel, etc (probably through usage of OpenOffice.org)     * Word, Excel, etc (probably through usage of OpenOffice.org)     * [[wp>Office Open XML|OOXML]] (at least at the text level we don't have to deal with much of the mess inside OOXML).  See also: [[http://go.microsoft.com/fwlink/?LinkId=120908|Open XML SDK v1]]     * [[wp>Office Open XML|OOXML]] (at least at the text level we don't have to deal with much of the mess inside OOXML).  See also: [[http://go.microsoft.com/fwlink/?LinkId=120908|Open XML SDK v1]] -    * [[wp>Rich Text Format]]+    * [[wp>Rich Text Format]] (RTF) see [[http://code.google.com/p/pyrtf-ng/|pyrtf-ng]]     * [[wp>XML Paper Specification]]     * [[wp>XML Paper Specification]]     * .NET Resource files (.resx) - Bug [[bug>396]]     * .NET Resource files (.resx) - Bug [[bug>396]]

1255953204currentLine 61: Line 61:   * <del>terminology pushes translation box down</del> - [[commit>11262]], with minor styling issues outstanding   * <del>terminology pushes translation box down</del> - [[commit>11262]], with minor styling issues outstanding   * <del>advanced search checkboxes forgotten on skip</del>   * <del>advanced search checkboxes forgotten on skip</del> -  * <del>can't search comments [[http://bugs.locamotion.org/show_bug.cgi?id=881| #881]]</del> +  * <del>can't search comments [[bug>881]]</del>  -  * resolve [[http://bugs.locamotion.org/show_bug.cgi?id=672 |release blocking bugs]]+  * resolve [[bug>672|release blocking bugs]]   * <del>template should not show as 100% untranslated, should not affect overall project stats</del>   * <del>template should not show as 100% untranslated, should not affect overall project stats</del> -  * <del>display check name when reviewing [[http://bugs.locamotion.org/show_bug.cgi?id=959 | #959]]</del> - [[commit>11635]]+  * <del>display check name when reviewing [[bug>959]]</del> - [[commit>11635]] ====== Cleanup and nice to have stuff ====== ====== Cleanup and nice to have stuff ======

1216220444currentLine 28: Line 28: ===== Example ===== ===== Example ===== -In this example I will demonstrate the usage of these tools by creating a language corpus for Zulu (http://en.wikipedia.org/wiki/Zulu#Language).+In this example I will demonstrate the usage of these tools by creating a language corpus for [[wp>Zulu language|Zulu]].   * Change to the CorpusCatcher directory.   * Change to the CorpusCatcher directory.

1255611675currentLine 7: Line 7:   * [[mainpage|About]]   * [[mainpage|About]]   * [[Software]]   * [[Software]] -    * [[FreeMind]] (PO)+    * [[VLC]] (PO)     * [[WordPress]] (PO)     * [[WordPress]] (PO)     * [[FileZilla]] (PO)     * [[FileZilla]] (PO) -    * [[VLC]] (PO)      * [[Tuxpaint]] (PO)     * [[Tuxpaint]] (PO)     * [[Art of Illusion]] (.prop)     * [[Art of Illusion]] (.prop) -    * [[TuxGuitar]] (.prop)+    * [[FreeMind]] (.prop)     * [[OpenProj]] (.prop)     * [[OpenProj]] (.prop)  +    * [[TuxGuitar]] (.prop)   * [[Languages]]   * [[Languages]]