Difference between revisions of "Localizing BlackBox"
Jump to navigation
Jump to search
Ivan denisov (talk | contribs) |
Ivan denisov (talk | contribs) |
||
| (2 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
[[BlackBox Component Builder]] can be localized, i.e. adapted to a different language, by the following steps: | |||
[BlackBox Component Builder] can be localized, i.e. adapted to a different language, by the following steps: | |||
# Select the [https://en.wikipedia.org/wiki/ISO_639-1 ISO_639-1] two-letter language code (e.g. ''ru'' for Russian, ''fr'' for French). For information on all language codes see [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes all ISO_639-1 language codes]. | # Select the [https://en.wikipedia.org/wiki/ISO_639-1 ISO_639-1] two-letter language code (e.g. ''ru'' for Russian, ''fr'' for French). For information on all language codes see [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes all ISO_639-1 language codes]. | ||
| Line 10: | Line 8: | ||
# In order to make your translation available to others it suffices to pack all newly created files together with their directory structure starting from the BlackBox root directory into a .zip file and unpack that .zip file into an existing BlackBox installation. | # In order to make your translation available to others it suffices to pack all newly created files together with their directory structure starting from the BlackBox root directory into a .zip file and unpack that .zip file into an existing BlackBox installation. | ||
# Any two-letter subdirectory of ''System/Rsrc/'' will be offered automatically for the language selection in the ''Edit->Preferences'' dialog. | # Any two-letter subdirectory of ''System/Rsrc/'' will be offered automatically for the language selection in the ''Edit->Preferences'' dialog. | ||
There is ready localization package for Russian language: http://comp.molpit.org/blackbox/russian.txt | |||
Latest revision as of 15:35, 23 April 2016
BlackBox Component Builder can be localized, i.e. adapted to a different language, by the following steps:
- Select the ISO_639-1 two-letter language code (e.g. ru for Russian, fr for French). For information on all language codes see all ISO_639-1 language codes.
- Adapt all Strings.odc files for the new language and put them in a subdirectory named after the two-letter language code (e.g. Rsrc/ru/ for Russian, Rsrc/fr/ for French). All keys (left column) must be the same as in the default Strings.odc files.
- Adapt all documentation files and put them in a subdirectory named after the two-letter language code (e.g. Docu/ru/ for Russian, Docu/fr/ for French). All file names must be the same as for the default documentation files.
- If you encounter links to other documentation files adapt the window title and the link text (e.g. for French change <StdCmds.OpenBrowser('Docu/Tour', 'Guided Tour')>Guided Tour<> to <StdCmds.OpenBrowser('Docu/Tour', 'Visite guidée')>Visite guidée<>. It is not required to also change the path to 'Docu/fr/Tour' since the command StdCmds.OpenBrowser opens the documentation file according to the selected language, if available.
- It is possible to only translate a subset of all documentation files. References from an untranslated file to a translated file will continue to work and will show the untranslated window title. References from a translated file to an untranslated file should be localized as described above and will open the untranslated file with a translated window title. Thereby a translation can be added later without changing the already existing translated file that contains the reference.
- In order to make your translation available to others it suffices to pack all newly created files together with their directory structure starting from the BlackBox root directory into a .zip file and unpack that .zip file into an existing BlackBox installation.
- Any two-letter subdirectory of System/Rsrc/ will be offered automatically for the language selection in the Edit->Preferences dialog.
There is ready localization package for Russian language: http://comp.molpit.org/blackbox/russian.txt