Ysavourel: 1 revision imported

2016-06-04T23:19:57Z

1 revision imported

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

Ysavourel at 17:49, 17 February 2014

2014-02-17T17:49:00Z

New page

{{Rainbow TKits Header}}
__TOC__
==Overview==

The ''OmegaT Project'' package is one of the types of translation packages you can create with the [[Rainbow Translation Kit Creation Step]]. Such package can be post-processed using the [[Rainbow Translation Kit Merging Step]].

In this package the input documents are placed in an OmegaT project. [http://www.omegat.org/ OmegaT] is a cross-platform open-source translation tool.
* The project is created. If one already exists it is overwritten. The input documents are extracted into XLIFF documents that are placed in the <code>source</code> sub-directory of the project.
* Existing and leveraged translation are output into the <code>tm</code> sub-directory of the project, or directly into the TMX of the project.
* Segmented text units are represented in XLIFF and handled properly by OmegaT.
* By default, inline codes are represented using the placeholder notation (<code><g>/<x/>/<bx>/<ex></code>) in the XLIFF documents, which are represented as numbered letter codes in OmegaT (e.g. <code><g1>/<x2/>/<b3>/<e3></code>). Optionally you may use encapsulation notation (<code><bpt>/<ept>/<ph>/<it></code>). See [[#Options|below]] for notes on compatibility with various versions of OmegaT.

This package can be opened directly with OmegaT.

Note that you can also use some of filters of the Okapi Framework directly from OmegaT (i.e. without creating this package) by working with the [[Okapi Filters Plugin for OmegaT]].

==Options==

<cite>Use <g></g> and <x/> notation</cite> — Set this option to create an XLIFF output where inline codes are coded as place-holders that do not include the original data. Some file formats have inline codes that correspond to large chunk of data that are not useful for the translator: This notation allows you to not include them in the XLIFF output. This setting is suitable for use with versions of OmegaT prior to 3.0, or OmegaT 3.0 or higher with the XLIFF filter set to <cite>Compatibility with OmegaT 2.6</cite> (see <cite>Options > File Filters... > XLIFF > Options...</cite>).

Disabling this option will result in encapsulation-style codes (<code><bpt>/<ept>/<ph>/<it></code>); please use OmegaT 3.0 or later with default settings (<cite>Compatibility with OmegaT 2.6</cite> option '''''off''''' for XLIFF filter) to ensure correct handling.

<cite>Allow segmentation in the OmegaT project</cite> — set this option to set the <code>sentence_seg</code> flag of the project to true. This option is ignore, and the flag always set to false, if there are segmented text units in the extracted text. That is, if there is a [[Segmentation Step]] active before the creation of the translation kit, or if one of the input file has pre-segmented entries.

If you want to override the pre-segmentation, you can use the [[Desegmentation Step]] before the creation of the translation kit.

<cite>Include post-processing hook</cite> — set this option to include a hook in the OmegaT project that will allow OmegaT's <cite>Create Translated Documents</cite> command to automatically invoke the Rainbow Translation Kit Merging process. In order for the command to be invoked, you must check the <cite>Also allow per-project external commands</cite> checkbox in OmegaT in the <cite>Options > Save...</cite> panel.

'''Note:''' Support for this feature requires [http://www.omegat.org/en/dl_overview.php version 2.6.2 or higher of OmegaT].

The hook is in the form of a CLI command:

<code>java -jar '''/path/to/okapi/'''lib/rainbow.jar -x TranslationKitPostProcessing -np "${projectRoot}manifest.rkm" -fc okf_rainbowkit-noprompt</code>

* <code>'''/path/to/okapi'''</code> will be an absolute path to the user's Okapi installation '''''or''''' it will be <code>${OKAPI_HOME}</code> if a valid <code>OKAPI_HOME</code> environment variable is set.
* <code>${projectRoot}</code> and <code>${OKAPI_HOME}</code> are expanded by OmegaT upon execution.
* On Mac OS X an additional argument, <code>-XstartOnFirstThread</code>, is included. If you move a translation kit to or from an OS X system, you may have to manually either add or remove this argument. See below for instructions.

'''Note''': The hook will fail if <code>rainbow.jar</code> cannot be found at the specified path. This may happen in the following situations:
* You move your Okapi installation
* You send the translation kit to a machine with Okapi installed at a different location, or not installed at all

In this case you can either:
* Re-create the translation kit on the target machine, or
* Manually fix the path in OmegaT: Go to <cite>Project > Properties > External Post-processing Command</cite>.

==Details==

===Sub-Directories===

The extracted files are stored in the same directory structure as the original files, relative to the root of the file set.

For example if you have two files named <code>index.html</code> in two different sub-directories, they will be both extracted as <code>index.html.xlf</code> but each on its corresponding sub-directory.

===Inline Codes===

By default, inline codes are represented using the placeholder notation (<code><g>/<x/>/<bx>/<ex></code>) in the XLIFF documents, which are represented as numbered letter codes in OmegaT that are independent of the content they contain (e.g. <code><g1>/<x2/>/<b3>/<e3></code>).

Optionally you may use encapsulation notation (<code><bpt>/<ept>/<ph>/<it></code>). In this mode, the appearance of the tags in OmegaT depends on the content of the tag (e.g. <code><bpt ...>'''''f'''''oo</bpt></code> will show as <code><'''''f'''''0></code>).

The content of the inline codes in the TMX files for this package are output in the same notation as the XLIFF to ensure proper matching.

See [[#Options|above]] for notes on compatibility with various versions of OmegaT.

===Segmentation===

Segmentation is supported: OmegaT handles the XLIFF standard segmentation.

If the input is not segmented, you can use the <cite>Allow segmentation in the OmegaT project</cite> option to allow or not the segmentation to be done by OmegaT when opening the project.

===Pre-Translation===

Translatable entries can be pre-translated different ways. In this package, the result of pre-translation is as follows:

* Existing translations marked as '''approved''' are put in the <code>project_save.tmx</code> file, located in the <code>omegat</code> sub-directory.
* Existing translations without flag are put in the <code>unapproved.tmx</code> file, located in the <code>tm</code> sub-directory.
* Existing translations coming from alternate-translation constructs in the original file (for example the <code><alt-trans></code> elements of an XLIFF document) are put in the <code>alternates.tmx</code> file, located in the <code>tm</code> sub-directory.
* Translations coming from some leveraging steps are put in the <code>leverage.tmx</code> file, located in the <code>tm</code> sub-directory.

==Package Layout==

Assuming that your package name is <code>pack1</code>, your input root ends with <code>main</code>, the target language is French, you have selected to use the same filenames as the input files for the output files, and you have the following source files:

--- main
|
+--- index.html
+--- myFile.idml
+--- subDir
|
+--- index.html

The layout of this package after creation will be:

--- pack1
|
+--- omegat.project
+--- manifest.rkm
+--- glossary
|--- tm
| |
| +---- *.tmx
|
+--- omegat
| |
| +--- project_save.tmx
|
+--- original
| |
| +--- index.html
| +--- myFile.idml
| +--- subDir
| |
| +--- index.html
|
+--- source
| |
| +--- index.html.xlf
| +--- myFile.idml.xlf
| +--- subDir
| |
| +--- index.html.xlf
|
+--- target

* <code>original</code> contains a copy of the original source documents. You needs those files for post-processing.
* <code>source</code> contains the documents that are to be translated.
* <code>target</code> contains no files. This is where the translated files should go. They will be created by OmegaT with the command <cite>Create Translated Documents</cite>.
* <code>tm</code> contains any TMX files generated by the step.
* <code>omegat</code> contains the project's TMX file.
* <code>glossary</code> contains nothing. This is where you can place your glossaries.

For the post-processing the <code>target</code> sub-directory must contain the translated XLIFF documents. After post-processing a new <code>done</code> sub-directory is created:

--- pack1
|
+--- target
| |
| +--- index.html.xlf
| +--- myFile.idml.xlf
| +--- subDir
| |
| +--- index.html.xlf
|
+--- done
| |
| +--- index.html
| +--- myFile.idml
| +--- subDir
| |
| +--- index.html
|
+... (same as after creation)

* <code>done</code> contains the merged translated documents. This directory is created during post-processing.

==Limitations==

This package is BETA

[[Category:Translation Formats]] [[Category:Rainbow TKits]]

Rainbow TKit - OmegaT Project - Revision history

Ysavourel: 1 revision imported

Ysavourel at 17:49, 17 February 2014