csv2tbx

Convert between CSV (Comma Separated Value) files and the TBX format for terminology exchange.

Usage

csv2tbx [--charset=CHARSET] [--columnorder=COLUMNORDER] <csv> <tbx>

Where:

<csv>

is a CSV file

<tbx>

is the target TBX file

Options (csv2tbx):

--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 csv format

-x EXCLUDE, --exclude=EXCLUDE

exclude names matching EXCLUDE from input paths

-o OUTPUT, --output=OUTPUT

write to OUTPUT in tbx format

-S, --timestamp

skip conversion if the output file has newer timestamp

--charset=CHARSET

set charset to decode from csv files

--columnorder=COLUMNORDER

specify the order and position of columns (comment,source,target)

CSV file layout

The CSV file is expected to have three columns (separated by commas, not other characters like semicolons), of which the default layout is

Column

Data

Description

A

Comment

All the PO #: location comments. These are not used in the TBX files, and can be left empty, but could be generated by po2csv

B

Source Language

The msgid or source string

C

Target Language

The msgstr or target language

Examples

These examples demonstrate the use of csv2tbx:

csv2tbx terms.csv terms.tbx

to simply convert terms.csv to terms.tbx.

To convert a directory recursively to another directory with the same structure of files:

csv2tbx csv-dir tbx-target-dir

This will convert CSV files in csv-dir to TBX files placed in tbx-target-dir.:

csv2tbx --charset=windows-1250 csv tbx

Users working on Windows will often return files in encoding other the Unicode based encodings. In this case we convert CSV files found in csv from windows-1250 to UTF-8 and place the correctly encoded files in tbx. Note that UTF-8 is the only available destination encoding.

Two column CSV

csv2tbx --columnorder=source,target foo.csv foo.tbx

Notes

For conformance to the standards and to see which features are implemented, see CSV and TBX.