Scroll to navigation

ITSTOOL(1) General Commands Manual ITSTOOL(1)

NAME

itstool - convert between XML and PO using ITS
 

SYNOPSIS

itstool [OPTIONS] [XMLFILES]
 
itstool -m <MOFILE> [OPTIONS] [XMLFILES]
 

DESCRIPTION

itstool extracts messages from XML files and outputs PO template files, then merges translations from MO files to create translated XML files. It determines what to translate and how to chunk it into messages using the W3C Internationalization Tag Set (ITS).
 
To extract messages from XML files FILES and output them to OUT.pot:
 
itstool -o OUT.pot FILES
 
After merging with existing translations or translating strings, generate an MO file with msgfmt(1), then output translated files to the directory DIR:
 
itstool -m OUT.mo -o DIR FILES
 
ITS definitions are loaded from the built-in rules, rules embedded in the source XML files, files passed with the -i option, and ITS attributes in the source XML files. Later definitions take precedence.
 

OPTIONS

Extracting

-o FILE
--out=FILE
output PO template to the file OUT

Merging

-m FILE
--merge=FILE
merge from an MO file FILE and output XML files
-l LANG
--lang=LANG
explicitly set the language code output to XML
-o FILE
--out=FILE
output XML files in the directory OUT

Common

-i ITS
--its=ITS
load the ITS rules in the file ITS (can specify multiple times)
 

AUTHOR

Shaun McCance <shaunm@gnome.org>
 

SEE ALSO

More documentation for itstool is maintained online. For more information, see:
http://itstool.org/documentation/
May 2011 itstool 1.1.3