diff options
author | Norbert Preining <preining@logic.at> | 2009-09-15 09:40:04 +0000 |
---|---|---|
committer | Norbert Preining <preining@logic.at> | 2009-09-15 09:40:04 +0000 |
commit | 60d44731afa4954a7324f3bbe3e111598874afd2 (patch) | |
tree | b44918fd5babb878b576cdf2a688af6542fcf7e8 /Master/tlpkg/doc | |
parent | 568f2a84fedd5654cc87f3408d72bd32b4363df3 (diff) |
move howto-translations to doc, and rename etc to dev in tlpkg
git-svn-id: svn://tug.org/texlive/trunk@15293 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/tlpkg/doc')
-rw-r--r-- | Master/tlpkg/doc/howto-translations.txt | 114 |
1 files changed, 114 insertions, 0 deletions
diff --git a/Master/tlpkg/doc/howto-translations.txt b/Master/tlpkg/doc/howto-translations.txt new file mode 100644 index 00000000000..bb6688c09d0 --- /dev/null +++ b/Master/tlpkg/doc/howto-translations.txt @@ -0,0 +1,114 @@ + +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. + +Here are explanations for gtranslator and poedit. I (np) prefer now +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. + +using gtranslator (gtranslator.sf.net): +--------------------------------------- + +Starting a new translation NN.po: +- copy messages.pot to NN.po +- open it with gtranslator +- select from the menu: Edit -> Header + and change the items under "Translator and Language", especially + change CHARSET to utf8 +- start translating + +The first column gives the status, you can sort by clicking on the head +of it + + +using poedit (poedit.sf.net): +----------------------------- + +Starting new translation NN.po: +- start fresh poedit +- click on "File -> New catalog from POT file" +- select messages.pot (in tlpkg/translations/messages.pot) +- A dialog opens that asks for some fields, like + Project name and version: + Team: + Team's email address: + Language: + Country: + Charset: UTF-8 + Source code charset: + Plural Forms: + etc all of which is unknown to me, but I filled in at least the Language + and the email of myself of tex-live@tug.org +- click "Ok" +- select where to save (either in tlpkg/translations/NN.po or somewhere else + and send us the file) +- start translating + +Editing an existing NN.po: +- start poedit +- open NN.po +- start translating + + +---------------------------------------------- + +General remarks concerning 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 + 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 +.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. + +So before any of you start out with editing a translation, please fetch the +latest messages.pot and NN.po + +----------------------------------------- + +For developers +-------------- + +Extraction of the messages == update of the po template messages.pot: +(should probably be done daily?) + + cd ..../Master + xgettext -o tlpkg/translations/messages.pot -L Perl \ + -k__ -k\$__ -k%__ -k__x -k__n:1,2 -k__nx:1,2 -k__xn:1,2 -kN__ -k \ + tlpkg/installer/install-menu-perltk.pl \ + tlpkg/installer/install-menu-wizard.pl \ + texmf/scripts/texlive/tlmgrgui/*.pl + + +Merging/updating of the .po files +(should update de.po, and merge new file locations) + + cd Master/tlpkg/translations + msgmerge --update de.po messages.pot + + +Statistics: + pocount .../Master/tlpkg/translations/*.po + + |