Ysavourel: 1 revision imported

2016-06-04T23:19:56Z

1 revision imported

← Older revision	Revision as of 19:19, 4 June 2016
(No difference)

Ysavourel at 12:03, 23 February 2015

2015-02-23T12:03:23Z

New page

{{Tikal Common Menu}}
__TOC__
==Convert to PO Format==

Creates a PO file for the give input file. If the input file is multilingual (like a TMX or a TS file), the source and target will be in the PO file.

The syntax of this command is:

-2po [options] inputFile [inputFile2...]

Where the options are:

{| border="1" cellpadding="5" cellspacing="0"
|- valign="top"
|nowrap="nowrap"| <code>-fc configId</code> || The identifier of the filter configuration to use for the input files
|- valign="top"
| <code>-ie encoding</code> || The encoding name of the input files. this is used only if the filter cannot detect the encoding from the input file itself.
|- valign="top"
| <code>-sl srcLang</code> || The code of the source language of the input files. [[Tikal - Usage#Source and Target Languages|See more details...]]
|- valign="top"
| <code>-tl trgLang</code> || The code of the target language. [[Tikal - Usage#Source and Target Languages|See more details...]]
|- valign="top"
| <code>-generic</code> || Indicates to use generic notation for inline codes in the generated PO file, for example <code><1/></code> vs. <code> </code>. If this option is not specified the inline codes are output in their original form.
|- valign="top"
| <code>-trgsource| -trgempty</code> || Forces the content of the output target field to be either a copy of the source or empty. If neither option is set the content of the target field is the target text or empty.
|- valign="top"
| <code>-all</code> || Allows entries that have no text to be converted. If this option is not set, the entries that are empty, or contains only codes or whitespaces are not included in the output file. If this option is set all entries are included in the output.
|- valign="top"
| <code>-approved</code> || If this option is set only approved entries are included.
|- valign="top"
|nowrap="nowrap"|<code>-rd rootDirectory</code> || The root directory (by default the user's home directory).
|}

For example:

tikal -2po data.tmx -sl EN -tl ZU

Creates a PO file from the TMX document <code>data.tmx</code>. The source language is English and the target Zulu.

==Convert to TMX Format==

Creates a TMX document for the give input file. If the input file is multilingual (like a PO or a TS file), the source and target will be in the TMX document.

The syntax of this command is:

-2tmx [options] inputFile [inputFile2...]

Where the options are:

{| border="1" cellpadding="5" cellspacing="0"
|- valign="top"
|nowrap="nowrap"| <code>-fc configId</code> || The identifier of the filter configuration to use for the input files.
|- valign="top"
| <code>-ie encoding</code> || The encoding name of the input files. this is used only if the filter cannot detect the encoding from the input file itself.
|- valign="top"
| <code>-sl srcLang</code> || The code of the source language of the input files. [[Tikal - Usage#Source and Target Languages|See more details...]]
|- valign="top"
| <code>-tl trgLang</code> || The code of the target language. [[Tikal - Usage#Source and Target Languages|See more details...]]
|- valign="top"
| <code>-trgsource| -trgempty</code> || Forces the content of the output target field to be either a copy of the source or empty. If neither option is set the content of the target field is the target text or empty.
|- valign="top"
| <code>-all</code> || Allows entries that have no text to be converted. If this option is not set (the default), the entries that are empty, or contains only codes or whitespaces are not included in the output file. If this option is set all entries are included in the output.
|- valign="top"
| <code>-approved</code> || If this option is set only approved entries are included.
|- valign="top"
|nowrap="nowrap"|<code>-rd rootDirectory</code> || The root directory (by default the user's home directory).
|}

For example:

tikal -2tmx data.po -sl EN -tl ZU

Creates a TMX document from the PO file <code>data.po</code>. The source language is English and the target Zulu.

tikal -2tmx data.tmx -sl EN -tl DE -trgempty

Creates a TMX document from another TMX document named <code>data.tmx</code>. The source language is English and the target German. The content of the <code><tuv></code> elements for the German will be empty.

==Convert to Table Format==

Creates a table-like output for the give input file. If the input file is multilingual (like a PO or a TS file), the source and target will be in the output table.

The syntax of this command is:

-2tbl [options] inputFile [inputFile2...]

Where the options are:

{| border="1" cellpadding="5" cellspacing="0"
|- valign="top"
|nowrap="nowrap"| <code>-fc configId</code> || The identifier of the filter configuration to use for the input files.
|- valign="top"
| <code>-ie encoding</code> || The encoding name of the input files. this is used only if the filter cannot detect the encoding from the input file itself.
|- valign="top"
| <code>-sl srcLang</code> || The code of the source language of the input files. [[Tikal - Usage#Source and Target Languages|See more details...]]
|- valign="top"
| <code>-tl trgLang</code> || The code of the target language. [[Tikal - Usage#Source and Target Languages|See more details...]]
|- valign="top"
| <code>-trgsource| -trgempty</code> || Forces the content of the output target field to be either a copy of the source or empty. If neither option is set the content of the target field is the target text or empty.
|- valign="top"
| <code>-csv| -tab</code> || Output format: <code>-csv</code> for comma-separated values, or <code>-tab</code> for tab-delimited values.
|- valign="top"
| <code>-xliff| -xliffgx| -tmx| -generic</code> || Inline codes format: <code>-xliff</code> for [[XLIFF]], <code>-xliffgx</code> for XLIFF with g/x notation, <code>-tmx</code> for TMX, or <code>-generic</code> for generic placeholders.
|- valign="top"
| <code>-all</code> || Allows entries that have no text to be converted. If this option is not set, the entries that are empty, or contains only codes or whitespaces are not included in the output file. If this option is set all entries are included in the output.
|- valign="top"
| <code>-approved</code> || If this option is set only approved entries are included.
|- valign="top"
|nowrap="nowrap"|<code>-rd rootDirectory</code> || The root directory (by default the user's home directory).
|}

For example:

tikal -2tbl data.tmx -sl EN -tl ZU

Creates a tab-delimited file from the TMX document data.tmx. Any inline codes is output in its original form. The source language is English and the target Zulu. Any tab character within the text is escaped with a backslash prefix.

tikal -2tbl data.po -sl EN -tl ES -csv -xliffgx -trgsource

Creates a comma-separated values output file from the PO file data.po. The inline codes are represented as XLIFF elements using the <code><g></code> and <code><x></code> notation. The text is between double quotes, and any double-quote and backslash characters within the text is escaped with a backslash prefix. The source language is English and the target Spanish. the content of the target column is a copy of the source.

==Import into Pensieve TM==

Imports the specified input documents into a [[Pensieve TM]] database. If the specified TM does not exists, it is created. If it does exist, the entries of the input files are added to it.

The syntax of this command is:

-imp myTMdirectory [options] inputFile [inputFile2...]

Where the options are:

{| border="1" cellpadding="5" cellspacing="0"
|- valign="top"
|nowrap="nowrap"| <code>-fc configId</code> || The identifier of the filter configuration to use for the input files.
|- valign="top"
| <code>-ie encoding</code> || The encoding name of the input files. this is used only if the filter cannot detect the encoding from the input file itself.
|- valign="top"
| <code>-sl srcLang</code> || The code of the source language of the input files. [[Tikal - Usage#Source and Target Languages|See more details...]]
|- valign="top"
| <code>-tl trgLang</code> || The code of the target language. [[Tikal - Usage#Source and Target Languages|See more details...]]
|- valign="top"
| <code>-trgsource| -trgempty</code> || Forces the content of the output target field to be either a copy of the source or empty. If neither option is set the content of the target field is the target text or empty.
|- valign="top"
| <code>-all</code> || Allows entries that have no text to be converted. If this option is not set (the default), the entries that are empty, or contains only codes or whitespaces are not included in the output file. If this option is set all entries are included in the output (if they respect the other options).
|- valign="top"
| <code>-over</code> || If this option is set and an entry to import has the same source text as one or more entries in the existing TM, all the existing entries will be replaced by the new one. Do not set this option if you want to allow different translations for the same source.
|- valign="top"
| <code>-approved</code> || If this option is set only approved entries are included.
|- valign="top"
|nowrap="nowrap"|<code>-rd rootDirectory</code> || The root directory (by default the user's home directory).
|}

For example:

tikal -imp myTMdir data.po -sl JA -tl FR

Imports the PO file <code>data.po</code> into the TM database located in <code>myTMDir</code>. If the directory does not exists it will be created. If a TM exists, the entries of the input file(s) will be added to it. The source language of the PO file is Japanese and the target French.

==Export TMX from Pensieve TM==

Creates a TMX output file for the the given [[Pensieve TM|Pensieve TMs]].

The syntax of this command is:

-exp tmDirectory [tmDirectory2...] [options]

Where the options are:

{| border="1" cellpadding="5" cellspacing="0"
|- valign="top"
|nowrap="nowrap"| <code>-sl srcLang</code> || The code of the source language of the input files. [[Tikal - Usage#Source and Target Languages|See more details...]]
|- valign="top"
| <code>-tl trgLang</code> || The code of the target language. [[Tikal - Usage#Source and Target Languages|See more details...]]
|- valign="top"
| <code>-trgsource| -trgempty</code> || Forces the content of the output target field to be either a copy of the source or empty. If neither option is set the content of the target field is the target text or empty.
|- valign="top"
| <code>-all</code> || Allows entries that have no text to be converted. If this option is not set (the default), the entries that are empty, or contains only codes or whitespaces are not included in the output file. If this option is set all entries are included in the output.
|}

For example:

tikal -exp myProjectTM -sl en -tl IT

Creates a TMX document from the Pensieve TM stored in <code>myProjectTM</code>. The source language is English and the target Italian.

Note that the command <code>-exp</code> is a shortcut for the <code>-2tmx</code> command ([[#Convert to TMX Format|Convert to TMX Format]]). You can export Pensieve TM entries in table, TMX or PO format using the filter configuration <code>okf_pensieve</code>. For instance, the example above can be also execute using the following command:

tikal -2tmx myProjectTM -fc okf_pensieve -sl en -tl IT

[[Category:Tikal]] [[Category:Pensieve TM]] [[Category:TMX]]

Tikal - Conversion Commands - Revision history

Ysavourel: 1 revision imported

Ysavourel at 12:03, 23 February 2015