Provided by: gtranslator_2.91.7-1ubuntu1_amd64 
NAME
gtranslator -- a comfortable gettext po file editor with many bells and whistles.
SYNOPSIS
gtranslator [ --help ] [ --version ] [ -a filename ] [ -e po-file ] [ -g geometry-string ]
[ -l po-file-to-learn ] [ -b ] [ -s ]
DESCRIPTION
gtranslator is a comfortable gettext po file editor with many features like special char
featured editing, plural forms view, div. charset support, comfortable prefs, list view of
messages, regular expression based search function, compile/update possiblities and much
much more.
Of course all standard features of a good application like DnD, session support,
supplement files for mime types and menu items are present.
Instant comment view, a comfortable quick navigation messages table with customizable
colors, colorschemes, UTF-8 support, a high level of preferizabilation and a personal
learn buffer/translation memory with autotranslation capabilities are the main features of
gtranslator besides the comfortable editing of the translation entries.
OPTIONS
-a --auto-translate=po-file
Autotranslates the given po file with the entries from the learn buffer and exits
afterwards.
-e --export-learn-buffer=po-file-to-export
Exports the learn buffer contents into the given plain gettext po file and exits.
-g --geometry=geometry
Let's you specify the geometry of gtranslator's main window.
-l --learn=po-file-to-learn
Learns the given po file within the command line without starting the GUI. The
personal learn buffer is used as a translation memory to autoaccomplish missing
translations/entries.
-s --learn-statistics
Print out some statistics and information about the learn buffer of gtranslator on
the commandline.
--display
With this option you can select on which screen gtranslator should appear.
--help Shows you a little help autogenerated by GNOME and with the options mentioned
above.
--version
Prints out the version number of gtranslator.
--usage
Shows you the pill of options without an explanation.
FILES
~/.gconf/apps/gtranslator
Your personal gtranslator settings will be stored there.
~/.gtranslator
This directory is used by gtranslator for all it's "private" files (e.g. temporary
files).
~/.gtranslator/colorschemes/
Your personal colorschemes can be placed in this directory -- gtranslator does also
list the colorschemes in this directory in the colorscheme selection box.
~/.gtranslator/etstates/
The state file for the messages table/tree is stored in this directory.
~/.gtranslator/umtf/
Your personal learn buffers (in UMTF format) are stored in this directory -- the
learn buffer is used for auto translation issues.
~/.gtranslator/files/
Temporary files used by gtranslator are stored in this directory (mostly this
directory should be empty).
LEARN BUFFER
The learn buffer is the implementation of a personal translation memory (TM) in
gtranslator. gtranslator uses the UMTF (a compressed XML file which is normally quite good
human readable if uncompressed) format for storing it's learned strings.
Your learned strings are then available for the autotranslation feature of gtranslator
where gtranslator automatically fills in the corresponding and valuable translations for
any message which has already been learned previously. This results in a fairly high
percentage of prefilled/pretranslated messages.
The common and good style of working with the learn buffer and with the autotranslation
should be to learn the main po/translation files for your language via gtranslator via
calling gtranslator -n -l po-file-to-learn on the command line; this will put the
translated strings from this po file into your personal learn buffer.
You should learn the main po files (for GNOME for example gnumeric, nautilus, evolution or
any other bigger, already translated package's po file) for your language); you can use a
new script from the gtranslator package to automatise this task a little bit: it's “build-
gtranslator-learn-buffer.sh” which is installed into gtranslator's scripts directory which
you can see by calling gtranslator -b and you simply execute the script with it's full
path and simply follow the information on the command line for it.
Afterwards you can simply use the "Autotranslation" menu entry from the GUI or use the
"F10" hotkey to let gtranslator autotranslate all missing translations from your personal
learn buffer. This will ease your translation work and make a big portion of the po files
be pre-translated.
With a fairly big personal learn buffer of about 2 MB you can achive many pre-translated
messages for a new project/translation.
If you want to use the stored learn buffer contents to produce a po file with all the
“learned” translations, you can also use the “export learn buffer” capability of
gtranslator to get a plain po file version of the learn buffer.
USAGE EXAMPLES
Some examples for the options.
gtranslator -b
Shows you the real build specs/dates of gtranslator.
gtranslator -s
Give me statistics about the learn buffer of gtranslator.
gtranslator -n -l po-file-to-learn
Learns the given po file “po-file-to-learn” on the command line without starting up
the GUI.
gtranslator -a po-file
Autotranslates all missing entries from the learn buffer if possible and exits.
gtranslator -e po-file-to-export
Exports your current learn buffer to the given plain gettext po file
(“po-file-to-export”).
gtranslator po-file
Starts gtranslator with the given po-file loaded on startup.
gtranslator -g “460x320+0+0”
Lets gtranslator appear on the left upper edge of the screen “+0+0” and gtranslator
is sized to “460x320” if possible -- if gtranslator needs more size for it's window
contents, it'll expand itself to the necessary dimensions -- even if you defined a
smaller geometry string.
LICENSE
gtranslator is distributed under the GNU GPL V 2.0 or greater.
AUTHORS
Ross Golder <ross@kabalak.net>, Fatih Demir <kabalak@kabalak.net> (previously also:
Gediminas Paulauskas <menesis@kabalak.net>, Thomas Ziehmer <thomas@kabalak.net>, Kevin
Vandersloot <kfv101@psu.edu> and Peeter Vois <peeter@kabalak.net>).
WEBSITE
http://www.gtranslator.org
BUGREPORTS
You can deliver bug reports to the gtranslator development team to our bug base via
http://bugzilla.gnome.org/enter_bug.cgi?product=gtranslator
VERSION
gtranslator 2.91.7 man-page