Ysavourel: 1 revision imported

2016-06-04T23:20:03Z

1 revision imported

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

Mihnita: Added info on -logger and -trace

2012-11-24T23:29:17Z

Added info on -logger and -trace

New page

{{Tikal Common Menu}}
==Running Tikal==

Tikal is a command-line tool. To run it you need to be in a DOS or shell console.

* On Windows you can start a DOS prompt by executing the file named <code>startTikalPrompt.bat</code> that is located in the main directory of the Okapi installation.

* On Linux and Macintosh you need first to open a shell console, then you can use the file <code>tikal.sh</code> that is located in the main directory of the Okapi installation.

Note that if you want to be able to always access Tikal from any prompt, you main have to setup your system so <code>tikal.bat</code> or <code>tikal.sh</code> are in your search path.

There are various commands available:

* [[Tikal - Extraction Commands|Extraction Commands]]
* [[Tikal - Translation Commands|Translation Commands]]
* [[Tikal - Conversion Commands|Conversion Commands]]
* [[Tikal - Miscellaneous Commands|Miscellaneous Commands]]

==Source and Target Languages==

Most commands in Tikal require a source language, a target language or both to be specified. The values of those parameters is computed using the following process:

===Source Language===

: If the option <code>-sl</code> is used:
:: → its value is used as the source language.
: Else:
:: If the input file is in a format where Tikal detects language settings (XLIFF, TMX, TTX, etc.):
::: If a source language is detected:
:::: → that value is used as the source language.
:: If no source language has been set yet:
::: → English (<code>en</code>) is used as the source language.

===Target Language===

: If the option <code>-tl</code> is used:
:: → its value is used as the target language.
: Else:
:: If the input file is in a format where Tikal detects language settings (XLIFF, TMX, TTX, etc.):
::: If a target language is detected:
:::: → that value is used as the target language.
:: If no target language has been set yet:
::: → The language corresponding to the current value of the default locale for the running Java VM is used, except if it is the same as the source language; in that case French (<code>fr</code>) is used as the target language.

==Display Encoding==

In order to display characters properly with Tikal, you must make sure the display encoding of your shell session (e.g. DOS or bash) is the same as the output generated by Tikal.

The default depends on the operating system and may not be guessed correctly in many cases.

The user can override the guess by specifying the encoding to use in Tikal in a configuration file named <code>.Tikal</code> and located in the user's home directory. The system is

displayEncoding=<javaEncodingName>

For example, the following will change the encoding of the Tikal display output to UTF-8:

displayEncoding=UTF-8

Note that changing the display encoding does not affect the encoding of the output files, only the way the string are displayed on the terminal.

==Logging and trace==

You can pass the <code>-logger</code> flag to output all messages to the current logger instead of the console.
Might be pretty noisy, but you have full control by tweaking the logger configuration.
You can find more info on logging here: http://code.google.com/p/okapi/wiki/OkapiLogging.

When passed the <code>-trace</code> flag tikal outputs all debug messages from other components to the console.
This has no effect when the <code>-logger</code> flag is in effect, as the logger gets full control on the output.

==Help and Information==

* Use <code>-?</code> to display the usage screen for Tikal.
* Use <code>-h</code>, <code>-help</code> or <code>--help</code> to display this help page.
* Use <code>-i</code>, <code>-info</code> or <code>--info</code> to version and other information.

Examples:

tikal -?
tikal --help
tikal -info

Note that these three commands preempt any other commands. For example, the following command will only show the usage screen, not extract any file:

tikal -x myFile.html -sl zu -tl eo -?

[[Category:Tikal]]

Tikal - Usage - Revision history

Ysavourel: 1 revision imported

Mihnita: Added info on -logger and -trace