1ITSTOOL(1)                  General Commands Manual                 ITSTOOL(1)
2
3
4

NAME

6       itstool - convert between XML and PO using ITS
7
8
9

SYNOPSIS

11       itstool [OPTIONS] XMLFILES...
12       itstool -m <MOFILE> [OPTIONS] XMLFILES...
13       itstool -j <XMLFILE> [OPTIONS] MOFILES...
14
15
16

DESCRIPTION

18       itstool   extracts  messages  from  XML  files  and outputs PO template
19       files, then merges translations from MO files to create translated  XML
20       files.  It  determines  what to translate and how to chunk it into mes‐
21       sages using the W3C Internationalization Tag Set (ITS).
22
23       To extract messages from XML files XMLFILES and output them to OUT.pot:
24
25       itstool -o OUT.pot XMLFILES
26
27       After merging with existing translations or translating strings, gener‐
28       ate  an  MO  file  with  msgfmt(1), then output translated files to the
29       directory DIR:
30
31       itstool -m OUT.mo -o DIR XMLFILES
32
33       You can also create a single multilingual  XML  output  file  using  an
34       input XML file and a set of MO files:
35
36       itstool -j FILE.xml -o OUT.xml MOFILES
37
38       ITS  definitions  are loaded from the built-in rules, rules embedded in
39       the source XML  files,  files  passed  with  the  -i  option,  and  ITS
40       attributes  in the source XML files. Later definitions take precedence.
41       You can disable built-in rules by passing the -n option.
42
43
44

OPTIONS

46   Extracting
47       -o OUT.pot
48       --out OUT.pot
49           output PO template to the file OUT.pot
50
51   Merging
52       -m MOFILE XMLFILES
53       --merge MOFILE XMLFILES
54           merge from an MO file MOFILE and output translated  XML  files  for
55           source XMLFILES
56
57       -l LANG
58       --lang LANG
59           explicitly set the language code output to XML
60
61       -o OUT
62       --out OUT
63           output XML files in the directory OUT
64
65   Joining
66       -j MLIFILE MOFILES
67       --join XMLFILE MOFILES
68           join  translations  from  MOFILES into a multilingual file based on
69           source XMLFILE
70
71       -o OUT.xml
72       --out OUT.xml
73           output to the XML file OUT.xml
74
75   Common
76       -i ITS
77       --its ITS
78           load the ITS rules in the file ITS (can specify multiple times)
79
80       -n
81       --no-builtins
82           do not apply the built-in ITS rules that ship with itstool
83
84       -s
85       --strict
86           exit with error when PO files contain broken XML
87
88       -d
89       --load-dtd
90           load external DTDs used by input XML files
91
92       -k
93       --keep-entities
94           keep entity references unexpanded in PO files
95
96       -p NAME VALUE
97       --param NAME VALUE
98           define ITS parameter NAME to the value VALUE (can specify  multiple
99           times)
100
101

AUTHOR

103       Shaun McCance <shaunm@gnome.org>
104
105

SEE ALSO

107       More  documentation for itstool is maintained online. For more informa‐
108       tion, see:
109
110       http://itstool.org/documentation/
111
112
113
114itstool 2.0.2                    December 2013                      ITSTOOL(1)
Impressum