l10n: README: document "core translation"
Contributor for a new language must complete translations of a small set of l10n messages. Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com> Signed-off-by: Jiang Xin <worldhello.net@gmail.com>
Bagas Sanjaya committed
Mar 11, 2021 at 18:01 UTC
2fb9d2596f745c244f3f0d5d08fe49d1d4a92bff
1 file changed
+24
po/README.md
+24
@@ -40,6 +40,30 @@ language, so that the l10n coordinator only needs to interact with one
40
person per language.
41
42
43
+Core translation
44
+----------------
45
+The core translation is the smallest set of work that must be completed
46
+for a new language translation. Because there are more than 5000 messages
47
+in the template message file "po/git.pot" that need to be translated,
48
+this is not a piece of cake for the contributor for a new language.
49
+
50
+The core template message file which contains a small set of messages
51
+will be generated in "po-core/core.pot" automatically by running a helper
52
+program named "git-po-helper" (described later).
53
+
54
+ git-po-helper init --core XX.po
55
+
56
+After translating the generated "po-core/XX.po", you can merge it to
57
+"po/XX.po" using the following commands:
58
+
59
+ msgcat po-core/XX.po po/XX.po -s -o /tmp/XX.po
60
+ mv /tmp/XX.po po/XX.po
61
+ git-po-helper update XX.po
62
+
63
+Edit "po/XX.po" by hand to fix "fuzzy" messages, which may have misplaced
64
+translated messages and duplicate messages.
65
+
66
+
67
Translation Process Flow
68
------------------------
69
The overall data-flow looks like this: