summaryrefslogtreecommitdiff
path: root/build/lang-options/README
blob: 67fab0c9b4fe4fd86c17c2c4e6c86a14e7ea1a2b (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
50
51
52
53
54
55
56
ABOUT THIS DIRECTORY
====================

Each language, for which a translation is existing, should have a file
here with the language code as its name, even if the file is empty.


INSTRUCTIONS FOR USING OPTIONAL PARAGRAPHS
==========================================

In some places in the manual paragraphs have been included that are not
included in the generated English version of the manual. They can however
be included _optionally_ in translations.

To include an optional paragraph for your translation, you need to "enable"
it:
- creating a file for your language in this directory (in case it's not 
  already there; see above)
- add a singe line in this file containing:
     optional_paras="condition(s)"
- if you want to enable more than one optional paragraph, separate their
  conditions by a semicolon (without a space)

example
-------
optional_paras="about-langteam;gpl-unofficial"


       *** PLEASE CHECK THE RESULT AFTER THE MANUAL HAS BEEN BUILT ***


TRANSLATING AN OPTIONAL PARAGRAPH
=================================
In some cases you should replace the full text of the paragraph with your own.
In other cases you may need to translate the English text included in the
paragraph.

If comments are included in the paragraph (to help translation), these should
be deleted.


LIST OF DEFINED OPTIONAL PARAGRAPHS
===================================
Currently the following optional paragraphs have been defined (the first term
is the name of the condition used to activate it):
* about-langteam (en/administrativa/administrativa.xml
  Allows to add some info about the translator or translation team, and how
  to contact the translator(s).
* translation-status (en/bookinfo.xml)
  Allows to add information about the status of the translation and maybe to
  request reviews.
* gpl-unofficial (en/appendix/gpl.xml)
  *Must* be included if the GPL itself is translated; should *not* be included
  if the appendix contains the original (untranslated) English text of the GPL.
  Consists of two paragraphs of which the first *should remain in English*.
  See http://www.gnu.org/licenses/translations.html for additional information.