Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   18016 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

ITSTOOL(1)							    ITSTOOL(1)

NAME
       itstool - convert between XML and PO using ITS

SYNOPSIS
       itstool [OPTIONS] XMLFILES...
       itstool -m <MOFILE> [OPTIONS] XMLFILES...
       itstool -j <XMLFILE> [OPTIONS] MOFILES...

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 mes‐
       sages using the W3C Internationalization Tag Set (ITS).

       To extract messages from XML files XMLFILES and output them to OUT.pot:

       itstool -o OUT.pot XMLFILES

       After merging with existing translations or translating strings, gener‐
       ate  an	MO  file  with	msgfmt(1), then output translated files to the
       directory DIR:

       itstool -m OUT.mo -o DIR XMLFILES

       You can also create a single multilingual  XML  output  file  using  an
       input XML file and a set of MO files:

       itstool -j FILE.xml -o OUT.xml MOFILES

       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.
       You can disable built-in rules by passing the -n option.

OPTIONS
   Extracting
       -o OUT.pot
       --out OUT.pot
	   output PO template to the file OUT.pot

   Merging
       -m MOFILE XMLFILES
       --merge MOFILE XMLFILES
	   merge from an MO file MOFILE and output translated  XML  files  for
	   source XMLFILES

       -l LANG
       --lang LANG
	   explicitly set the language code output to XML

       -o OUT
       --out OUT
	   output XML files in the directory OUT

   Joining
       -j MLIFILE MOFILES
       --join XMLFILE MOFILES
	   join	 translations  from  MOFILES into a multilingual file based on
	   source XMLFILE

       -o OUT.xml
       --out OUT.xml
	   output to the XML file OUT.xml

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

       -n
       --no-builtins
	   do not apply the built-in ITS rules that ship with itstool

       -s
       --strict
	   exit with error when PO files contain broken XML

       -d
       --load-dtd
	   load external DTDs used by input XML files

       -k
       --keep-entities
	   keep entity references unexpanded in PO files

       -p NAME VALUE
       --param NAME VALUE
	   define ITS parameter NAME to the value VALUE (can specify  multiple
	   times)

AUTHOR
       Shaun McCance <shaunm@gnome.org>

SEE ALSO
       More  documentation for itstool is maintained online. For more informa‐
       tion, see:

       http://itstool.org/documentation/

itstool 2.0.2			 December 2013			    ITSTOOL(1)

Vote for polarhome