summaryrefslogtreecommitdiff
path: root/languages/README.txt
blob: bb6f7bc5ce7b3f133efd10430f04b9444138287a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
Quick Start for translators:
----------------------------
For example finnish translation:
Search for all *.fi.po files. They are simple text files, with an easy format.
Edit them with programs like kbabel or gtranslator.
Run 'localize.sh' script in the tools directory to update translations.

Send the updated xxx.fi.po file in a zip archive to graemeg@gmail.com.
Do NOT send diffs for .po files!


Now the background:
-------------------
The <fpGUIdir>/languages directory contains all the stuff for
internationalization of the fpGUI Toolkit.

All language files can easily be updated with the
<fpGUIdir>/tools/localize.sh or <fpGUIdir>\tools\localize.bat (coming soon) 
script.

All text and messages used in the toolkit should be placed into the  
<fpGUIdir/src/corelib/lang_en.inc (English) include file. This unit uses a
resourcestring section, so that the compiler will create the
<fpGUIdir>/lib/fpg_constants.rst file.
Since this is a fpc-only format it must be converted with the rstconv program:

cd <fpGUIdir>/languages
rstconv -i ../lib/fpg_constants.rst -o fpgui.po

Hint: 
This is automatically done by <fpGUIdir>/tools/localize.sh or <fpGUIdir>\tools\localize.bat.

This will create the file fpgui.po, which should be translated in all
required languages to a fpgui.xx.po file. For the xx see the gettext unit
in the procedure TranslateResourceStrings. All translation .po files are 
in UTF-8 encoding.


fpGUI Toolkit currently supports the following translations:
------------------------------------------------------------
english:           fpgui.en.po
german:            fpgui.de.po
russian:           fpgui.ru.po
spanish:           fpgui.es.po
french:            fpgui.fr.po
italian:           fpgui.it.po
afrikaans:         fpgui.af.po
portuguese:        fpgui.pt.po