You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by "Konstantin Kolinko (Confluence)" <no...@apache.org> on 2019/12/13 09:10:07 UTC
[CONF] Apache Tomcat > Managing translations
There's **1 new edit** on this page
---
|
---
| | [](https://cwiki.apache.org/confluence/display/TOMCAT/Managing+translations?src=mail&src.mail.product=confluence-
server&src.mail.timestamp=1576228207669&src.mail.notification=com.atlassian.confluence.plugins.confluence-
notifications-batch-plugin%3Abatching-
notification&src.mail.recipient=8aa9809569d423cd016a0413306f00db&src.mail.action=view
"page icon")
---
[Managing
translations](https://cwiki.apache.org/confluence/display/TOMCAT/Managing+translations?src=mail&src.mail.product=confluence-
server&src.mail.timestamp=1576228207669&src.mail.notification=com.atlassian.confluence.plugins.confluence-
notifications-batch-plugin%3Abatching-
notification&src.mail.recipient=8aa9809569d423cd016a0413306f00db&src.mail.action=view
"Managing translations")
| | | | |  | | Konstantin
Kolinko edited this page
---
|
| | Here's the version comment
---
|
---
| | |  | | Konstantin
Kolinko edited at [09:08
AM](https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=99845052)
---
| | | Arranged the lists and updated the text a bit. Added a permalink.
---
|
| | Here's what changed:
---
|
_Permalink_ to this page: [
https://cwiki.apache.org/confluence/x/vIPzBQ](https://cwiki.apache.org/confluence/x/vIPzBQ)
The Tomcat project uses [POEditor](https://poeditor.com/) to manage
translations.
...
* [Join](https://poeditor.com/join/project/NUTIjDWzrl) Tomcat translations project.
A public link, available to everyone. Once you join the project, you can
access it via Dashboard page at POEditor site.
* [View](https://poeditor.com/projects/view?id=221603) Tomcat translations project.
This link requires additional privileges (and responds with error 404 unless
you have them). This page lists translation status for each language and
provides additional controls.
_Note_ : Accessing this page requires additional privileges. An error 404 is
shown if you do not have them.
Key points:
* The Export/Import code that copies to/from POEditor prefixes each property key with the package name to ensure that the keys are always unique.
* In POEditor the keys are known as terms.
* If a value contains a `{n}` sequence (usually written as `[{n}]` to distinguish a value from the surrounding text) then it will be processed by a MessageFormatter which means any single quotes must be escaped by using two single quotes.
* The Manager and Host Manager applications use messages that start with "OK - " to indicate success of an operation. This prefix has to be preserved when translating. See [Bug 63141](https://bz.apache.org/bugzilla/show_bug.cgi?id=63141) for details.
The process to synchronise synchronize the Tomcat source code with POEditor
works as follows:
1. Update English translations in Tomcat:
Add or remove keys (terms) to the English LocalStrings.properties files.
Make any changes required to the values in the English LocalStrings.properties
files.
2. Export (the translations from Tomcat:
run `org.apache.tomcat.buildutil.translate.Export`) the translations
3. Import the terms with English translations to POEditor.
4. Update the translations for other languages on POEditor web site.
5. Export one or more languages ( _Note_ : only export translated terms).
6. Import (the translations into Tomcat:
run `org.apache.tomcat.buildutil.translate.Import`) the translations
It is recommended that one language is imported at a time and that steps 5 and
6 and 7 are repeated for each language to be imported.
Steps 1 to 4 3 are only required when adding terms, removing terms or changing
the English translation.
For small changes it is possible to make the change in both svn git repository
and POEditor - effectively keeping the two in sync manually - and not use the
Import/Export process. Care needs to be taken to ensure that the two systems
remain synchronized.
---
| | | [Go to page
history](https://cwiki.apache.org/confluence/pages/viewpreviousversions.action?pageId=99845052&src=mail&src.mail.product=confluence-
server&src.mail.timestamp=1576228207669&src.mail.notification=com.atlassian.confluence.plugins.confluence-
notifications-batch-plugin%3Abatching-
notification&src.mail.recipient=8aa9809569d423cd016a0413306f00db "Go to page
history")
---
---
| [View
page](https://cwiki.apache.org/confluence/display/TOMCAT/Managing+translations?src=mail&src.mail.product=confluence-
server&src.mail.timestamp=1576228207669&src.mail.notification=com.atlassian.confluence.plugins.confluence-
notifications-batch-plugin%3Abatching-
notification&src.mail.recipient=8aa9809569d423cd016a0413306f00db&src.mail.action=view)
---
| | [Stop watching
space](https://cwiki.apache.org/confluence/users/removespacenotification.action?spaceKey=TOMCAT&src=mail&src.mail.product=confluence-
server&src.mail.timestamp=1576228207669&src.mail.notification=com.atlassian.confluence.plugins.confluence-
notifications-batch-plugin%3Abatching-
notification&src.mail.recipient=8aa9809569d423cd016a0413306f00db&src.mail.action=stop-
watching&jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ4c3JmOjhhYTk4MDk1NjlkNDIzY2QwMTZhMDQxMzMwNmYwMGRiIiwicXNoIjoiNmI4NDg1YzQzOTZlYTMyNmYyY2NlNDA2NTVhNmI4YjQxODc3NmIwM2JlYjYzZmM2OTNhY2I1NmEzMGMwMDUwNyIsImlzcyI6ImNvbmZsdWVuY2Vfbm90aWZpY2F0aW9uc0FSRUgtWFVEMS1QT1FHLUNTQU8iLCJleHAiOjE1NzY4MzMwMDcsImlhdCI6MTU3NjIyODIwN30.NVVV1x1VW8NXmIFCzQIokPkC_dfWnfMBF-x25rI57O8)
| •
---|---
[Manage
notifications](https://cwiki.apache.org/confluence/users/editmyemailsettings.action?src=mail&src.mail.product=confluence-
server&src.mail.timestamp=1576228207669&src.mail.notification=com.atlassian.confluence.plugins.confluence-
notifications-batch-plugin%3Abatching-
notification&src.mail.recipient=8aa9809569d423cd016a0413306f00db&src.mail.action=manage)
---
| 
---
This message was sent by Atlassian Confluence 7.1.1
---