diff --git a/Manuals/Tcar-ug/Manuals/Texinfo/localizing.docbook b/Manuals/Tcar-ug/Manuals/Texinfo/localizing.docbook index cea2c4b..560ebc1 100644 --- a/Manuals/Tcar-ug/Manuals/Texinfo/localizing.docbook +++ b/Manuals/Tcar-ug/Manuals/Texinfo/localizing.docbook @@ -3,25 +3,63 @@ Texinfo Document Localization - Inside &TCAR;, documentation manuals are written in English - language and later translated to other languages. In the very - specific case of documentation manuals produced through + The documentation manuals inside &TCAR; are written in English + language first and translated to other languages later. In the + very specific case of documentation manuals produced through texinfo documentation backend, it is necessary to create one - manual structure for each language you decide to produce a - manual for. In this configuration, it is not possible to - separate translation messages from manual's content itself - because they both are the same thing. Translators need to be - aware of changes committed up to English manuals, find out - where the changes happened exactly and, finally, update the - localized manuals they maintain in order to keep both English - and localized manuals syncronized one another. + manual structure for each language you decided to produce the + documentation manuals for. In this configuration, it is not + possible to separate translation messages from manual's + content because they both are the same thing. Translators + need to be aware of changes committed up to English manuals, + find out where the changes happened exactly and, finally, + update the localized manuals they maintain in order to keep + both English and localized manuals syncronized one another. Language - ... + To create a documentation manual in English language you need + to be sure that the LANG environment variable + is set to en_US.UTF-8 or something similar for + your user's session. Likewise, if you want to create + documentation manuals in a language other than English, be + sure your user's session LANG environment + variable is set to the appropriate locale code. Generally, + you can control the locale code of your user's session through + the graphical login screen, or once you've opened + the user's session by explicitly changing the value of + LANG environment variable to your prefered + locale inside the ~/.bash_profile file. + To see the list of all the locales supported, you can use the + locale -a | less command. + + + + Inside the main definition file of each documentation manual, + the language information is set by texinfo + @documentlanguage command, when the documentation + manual is created through the help functionality + of centos-art.sh script. Generally, there + is no need to change the language information set by + @documentlanguage command once the document has + been created, unless you mistakently create the manual for a + locale code different to that one you previously pretended in + first place. + + + When producing output, the language information set by + @documentlanguage texinfo command is ignore in + Info and HTML output produced by makeinfo + command in the texinfo-4.8-14.el5 package, + but cosidered by Tex program to redefine various English words + used in the output (e.g., Chapter, + Index, See, and so on) based on + the current language set in. + +