start

odf2xliff and xliff2odf

Convert OpenDocument (ODF) files to XLIFF localization files. Create translated ODF files by combining the original ODF files with XLIFF files containing translations of strings in the original document.

XLIFF is the XML Localization Interchange File Format developed by OASIS (The Organization for the Advancement of Structured Information Standards) to allow translation work to be standardised no matter what the source format and to allow the work to be freely moved from tool to tool.

If you are more used to software translation or l10n, you might want to read a bit about document translation. This should help you to get the most out of translating ODF with XLIFF.

Usage

odf2xliff [options] <original_odf> <xliff>
xliff2odf [options] -t <original_odf> <xliff> <translated_odf>

Where:

<original_odf> is an ODF document whose strings have to be translated
<xliff> is an XLIFF file
<translated_odf> is an ODF file to generate by replacing the strings in <original_odf> with the translated strings in <xliff>

Options (odf2xliff):

--version show program's version number and exit
-h, --help show this help message and exit
--manpage output a manpage based on the help
--progress=PROGRESS show progress as: dots, none, bar, names, verbose
--errorlevel=ERRORLEVEL show errorlevel as: none, message, exception, traceback
-i INPUT, --input=INPUT read from INPUT in ODF format
-o OUTPUT, --output=OUTPUT write to OUTPUT in XLIFF format
--psyco=MODE use psyco to speed up the operation, modes: none, full, profile

Options (xliff2odf):

--version show program's version number and exit
-h, --help show this help message and exit
--manpage output a manpage based on the help
--progress=PROGRESS show progress as: dots, none, bar, names, verbose
--errorlevel=ERRORLEVEL show errorlevel as: none, message, exception, traceback
-i INPUT, --input=INPUT read from INPUT in XLIFF formats
-o OUTPUT, --output=OUTPUT write to OUTPUT in ODF format
-t TEMPLATE, --template=TEMPLATE read from TEMPLATE in ODF format
--psyco=MODE use psyco to speed up the operation, modes: none, full, profile

Examples

odf2xliff english.odt english_français.xlf

Create an XLIFF file from an ODT file (the source ODF file could also be any of the other ODF files, including ODS, ODG, etc.).

xliff2odf -t english.odt english_français.xlf français.odt

Using english.odt as the template document, and english_français.xlf as the file of translations, create a translated file français.odt.

Bugs

This filter is not yet extensively used - we appreciate your feedback. For more information on conformance to standards, see the xliff or odf pages. Possible issues were listed during testing.