diff options
Diffstat (limited to 'Master/tlpkg/doc/howto-translations.txt')
| -rw-r--r-- | Master/tlpkg/doc/howto-translations.txt | 63 |
1 files changed, 30 insertions, 33 deletions
diff --git a/Master/tlpkg/doc/howto-translations.txt b/Master/tlpkg/doc/howto-translations.txt index e678fc3ce5a..157cf589e76 100644 --- a/Master/tlpkg/doc/howto-translations.txt +++ b/Master/tlpkg/doc/howto-translations.txt @@ -1,11 +1,9 @@ +$Id$ +(This file public domain, originally written by Norbert Preining.) Dealing with translations of TeX Live programs ============================================== - -For translators ---------------- - BIG FAT NOTE: Before starting please always fetch the latest NN.po from our svn server because we merge new strings into .po files in regular intervals. @@ -15,16 +13,17 @@ gtranslator because it keeps the strings where no changes have been made in the format as they were, so there will be less commits and smaller commits. -Testing your translations: Please call +Testing your translations: Please try + (perl) install-tl --gui --debug-translation [--lang NN] tlmgr --debug-translation gui [--gui-lang NN] + This will give warnings *in*the*terminal* which strings haven't been translated. -using gtranslator (gtranslator.sf.net): ---------------------------------------- - +Using gtranslator (gtranslator.sf.net) +-------------------------------------- Starting a new translation NN.po: - copy messages.pot to NN.po - open it with gtranslator @@ -33,13 +32,11 @@ Starting a new translation NN.po: change CHARSET to utf8 - start translating -The first column gives the status, you can sort by clicking on the head -of it +The first column gives the status, you can sort by clicking on its head. -using poedit (poedit.sf.net): ------------------------------ - +Using poedit (poedit.sf.net) +---------------------------- Starting new translation NN.po: - start fresh poedit - click on "File -> New catalog from POT file" @@ -66,42 +63,42 @@ Editing an existing NN.po: - start translating ----------------------------------------------- - -General remarks concerning translations: +Requirements and advice for translations: ---------------------------------------- - - please use \" instead of ", as can be seen in the original strings - several lines in the translations are merged together *without* adding anything. So if you want new lines please use \n in the text (as seen in several original strings) -- if %s (one or more) are occurring then they are replaced in the +- if %s (one or more) is present, then they are replaced in the final strings with the respective infos. Please keep them. -We do update the messages.pot daily (nightly) and merge the strings into -all the .po files (using msgmerge). That means if we change one of the -english strings the translation will normally be marked as "fuzzy" in the +We update the messages.pot nightly and merge the strings into all the +.po files (using msgmerge). That means if we change one of the english +strings the translation will normally be marked as "fuzzy" in the .po file. -In poedit those fuzzy translations are shown in red, telling you that those -have had a change in the original string and the translation should be -checked. +In gtranslator the first column shows a warning sign if the message is +fuzzy. -In gtranslator the first column shows a warning sign if the message is fuzzy. +In poedit those fuzzy translations are shown in red, telling you that +those have had a change in the original string and the translation +should be checked. -So before any of you start out with editing a translation, please fetch the -latest messages.pot and NN.po +So before any of you start out with editing a translation, please fetch +the latest messages.pot and NN.po! ------------------------------------------ -For developers +For developers: -------------- - Extraction of the messages == update of the po template messages.pot, and Merging/updating of the .po files - see ../bin/tl-update-message + see ../bin/tl-update-messages Statistics: - pocount .../Master/tlpkg/translations/*.po - + pocount ../translations/*.po +When a new translation (language) is added, add to lists in + install-tl (under -lang), + tlmgr.pl (under --gui-lang), + tlmgrgui.pl (%code_lang). +Unfortunately nothing checks these for consistency, up to us humans. |