![[Anmerkung]](../../../../system/docbook-xsl/images/note.png) | Anmerkung |
|---|---|
Dieser Abschnitt ist in Englisch geschrieben, um - internationalen Ãbersetzern die Arbeit zu erleichtern. |
This section describes how localization packages in Lx-Office +
![[Anmerkung]](system/docbook-xsl/images/note.png) | Anmerkung |
|---|---|
Dieser Abschnitt ist in Englisch geschrieben, um + internationalen Ãbersetzern die Arbeit zu erleichtern. |
This section describes how localization packages in kivitendo are built. Currently the only language fully supported is German, and since most of the internal messages are held in English the English version is usable too.
A stub version of French is included but not functunal at this - point.
The structure of locales in Lx-Office is:
lx-office/locale/<langcode>/
where <langcode> stands for an abbreviation of the + point.
The structure of locales in kivitendo is:
kivitendo/locale/<langcode>/
where <langcode> stands for an abbreviation of the language package. The builtin packages use two letter ISO 639-1 codes, but the actual name is not relevant for the program and can easily be extended to IETF language @@ -14,14 +14,7 @@ recognized:
- LANGUAGE
This file is mandatory.
The
LANGUAGEfile contains the self descripted name of the language. It should contain a native representation first, and in parenthesis an english translation - after that. Example:Deutsch (German)
- charset
This file should be present.
The
charsetfile describes which - charset a language package is written in and applies to all - other language files in the package. It is possible to write - some language packages without an explicit charset, but it is - still strongly recommended. You'll never know in what - environment your language package will be used, and neither - UTF-8 nor Latin1 are guaranteed.The whole content of this file is a string that can be - recognized as a valid charset encoding. Example:
UTF-8
- all
This file is mandatory.
The central translation file. It is essentially an inline + after that. Example:
Deutsch (German)
- all
This file is mandatory.
The central translation file. It is essentially an inline Perl script autogenerated by locales.pl. To generate it, generate the directory and the two files mentioned above, and execute the following command:
scripts/locales.pl <langcode>
Otherwise you can simply copy one of the other languages. @@ -37,7 +30,7 @@ English - 0.6% - 2015/2028 missing
A file named "
three. If you want to provide it, it must be inlinable Perl code which provides anum2textsub. If aninitsub exists it will be executed - first.Only used in the check and receipt printing module.
- special_chars
Lx-Office comes with a lot of interfaces to different + first.
Only used in the check and receipt printing module.
- special_chars
kivitendo comes with a lot of interfaces to different formats, some of which are rather picky with their accepted charset. The
special_charsfile contains a listing of chars not suited for different file format and @@ -78,4 +71,4 @@ filenamesThe last of which is very machine dependant. Remember that case you made a typo, so that you don't have to translate everything again. If a tranlsation is missing, the lost file is checked first. If you maintain a language package, you might - want to keep this safe somewhere.