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 possibilities 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 its "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 its 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 its 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 achieve 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 its  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 3.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

       https://wiki.gnome.org/Apps/Gtranslator

BUGREPORTS

       You can deliver bug reports to the gtranslator  development  team  to  our  bug  base  via
       https://gitlab.gnome.org/GNOME/gtranslator/issues