diff --git a/Manuals/Tcar-ug/Manuals/Texinfo/localizing.docbook b/Manuals/Tcar-ug/Manuals/Texinfo/localizing.docbook index 560ebc1..6014c4f 100644 --- a/Manuals/Tcar-ug/Manuals/Texinfo/localizing.docbook +++ b/Manuals/Tcar-ug/Manuals/Texinfo/localizing.docbook @@ -3,42 +3,42 @@ Texinfo Document Localization - 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 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. + The localization of documentation manuals produced through + texinfo documentation backend takes place by creating one + documentation manual for each language. These manuals don't + have a direct relation among themselves except that one + adopted by people writting them in order to keep their content + syncronized one another. This configuration needs to + predefine a source documentation manual and translated + versions which derivate from it so as to keep the localization + work organized. To keep track of changes, the underlaying + version control system must be used. Notice that most of these + limitations might be reduced if it would be possible to apply + gettext procedures to texinfo + source files. - Language + Texinfo Document 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 + To create a documentation manual in English language the + LANG environment variable must be set to + en_US.UTF-8 or something similar. Likewise, if + you want to create documentation manuals in a language other + than English, be sure the 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 + you can customize the user's session locale information + in the graphical login screen before login, or once you've + login by explicitly setting the value of LANG + environment variable 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 + the language information is set by texinfo's @documentlanguage command, when the documentation manual is created through the help functionality of centos-art.sh script. Generally, there @@ -63,7 +63,7 @@ - Encoding + Texinfo Document Encoding ...