summaryrefslogtreecommitdiff
path: root/Master/tlpkg/doc/howto-translations.txt
diff options
context:
space:
mode:
Diffstat (limited to 'Master/tlpkg/doc/howto-translations.txt')
-rw-r--r--Master/tlpkg/doc/howto-translations.txt63
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.