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