X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2Fhtml%2Fch04s04.html;h=b6cd6a73541daccb89db919bb2887f3d56e07118;hb=036d1ca4bd5e9574118a7041e58b64fda4bc003d;hp=f21b33116406a72cbf46f3642e4588d05f94eb2f;hpb=a71821962da6b8b6b16cdd44c6d446c7112fe03e;p=kivitendo-erp.git diff --git a/doc/html/ch04s04.html b/doc/html/ch04s04.html index f21b33116..b6cd6a735 100644 --- a/doc/html/ch04s04.html +++ b/doc/html/ch04s04.html @@ -1,11 +1,11 @@
-Anmerkung | |
---|---|
Dieser Abschnitt ist in Englisch geschrieben, um - internationalen Ãbersetzern die Arbeit zu erleichtern. |
This section describes how localization packages in Lx-Office +
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 + version is usable too.
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:
This file is mandatory.
The LANGUAGE
file 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)
This file should be present.
The charset
file 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
This file is mandatory.
The central translation file. It is essentially an inline + after that. Example:
Deutsch (German)
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 a num2text
sub. If
an init
sub exists it will be executed
- first.
Only used in the check and receipt printing module.
Lx-Office comes with a lot of interfaces to different + first.
Only used in the check and receipt printing module.
kivitendo comes with a lot of interfaces to different
formats, some of which are rather picky with their accepted
charset. The special_chars
file contains a
listing of chars not suited for different file format and
@@ -63,7 +56,7 @@ Template/LaTeX
Template/OpenDocument
filenames
The last of which is very machine dependant. Remember that a lot of characters are forbidden by some filesystems, for - exmaple MS Windows doesn't like ':' in its files where Linux + example MS Windows doesn't like ':' in its files where Linux doesn't mind that. If you want the files created with your language pack to be portable, find all chars that could cause trouble.
This file is not a part of the language package @@ -78,4 +71,30 @@ filenames
The 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.
This subdir and file is not a part of the language package + itself.
If the directory more exists and contains a file called + all it will be parsed in addition to the mandatory all (see + above). The file is useful if you want to change some + translations for the current installation without conflicting + further upgrades. The file is not autogenerated and has the same + format as the all, but needs another key (more_texts). See the + german translation for an example or copy the following code: +
+#!/usr/bin/perl +# -*- coding: utf-8; -*- +# vim: fenc=utf-8 + +use utf8; + +# These are additional texts for custom translations. +# The format is the same as for the normal file all, only +# with another key (more_texts instead of texts). +# The file has the form of 'english text' => 'foreign text', + +$self->{more_texts} = { + + 'Ship via' => 'Terms of delivery', + 'Shipping Point' => 'Delivery time', +} +
+