1gtranslator(1) GNOME programs gtranslator(1)
2
3
4
6 gtranslator -- a comfortable gettext po file editor with many bells and
7 whistles.
8
9
11 gtranslator [ --help ] [ --version ] [ -a filename ] [ -e po-file ] [
12 -g geometry-string ] [ -l po-file-to-learn ] [ -b ] [ -s ]
13
14
16 gtranslator is a comfortable gettext po file editor with many features
17 like special char featured editing, plural forms view, div. charset
18 support, comfortable prefs, list view of messages, regular expression
19 based search function, compile/update possiblities and much much more.
20
21
22 Of course all standard features of a good application like DnD, session
23 support, supplement files for mime types and menu items are present.
24
25
26 Instant comment view, a comfortable quick navigation messages table
27 with customizable colors, colorschemes, UTF-8 support, a high level of
28 preferizabilation and a personal learn buffer/translation memory with
29 autotranslation capabilities are the main features of gtranslator
30 besides the comfortable editing of the translation entries.
31
33 -a --auto-translate=po-file
34 Autotranslates the given po file with the entries from the learn
35 buffer and exits afterwards.
36
37 -e --export-learn-buffer=po-file-to-export
38 Exports the learn buffer contents into the given plain gettext
39 po file and exits.
40
41 -g --geometry=geometry
42 Let's you specify the geometry of gtranslator's main window.
43
44 -b --build-informations
45 Shows the build specifications (date, time, versions, directo‐
46 ries) of gtranslator.
47
48 -l --learn=po-file-to-learn
49 Learns the given po file within the command line without start‐
50 ing the GUI. The personal learn buffer is used as a translation
51 memory to autoaccomplish missing translations/entries.
52
53 -s --learn-statistics
54 Print out some statistics and information about the learn buffer
55 of gtranslator on the commandline.
56
57 --display
58 With this option you can select on which screen gtranslator
59 should appear.
60
61 --help Shows you a little help autogenerated by GNOME and with the
62 options mentioned above.
63
64 --version
65 Prints out the version number of gtranslator.
66
67 --usage
68 Shows you the pill of options without an explanation.
69
71 ~/.gconf/apps/gtranslator
72
73 Your personal gtranslator settings will be stored there.
74
75 ~/.gtranslator
76 This directory is used by gtranslator for all it's "private"
77 files (e.g. temporary files).
78
79 ~/.gtranslator/colorschemes/
80 Your personal colorschemes can be placed in this directory --
81 gtranslator does also list the colorschemes in this directory in
82 the colorscheme selection box.
83
84 ~/.gtranslator/etstates/
85 The state file for the messages table/tree is stored in this
86 directory.
87
88 ~/.gtranslator/umtf/
89 Your personal learn buffers (in UMTF format) are stored in this
90 directory -- the learn buffer is used for auto translation
91 issues.
92
93 ~/.gtranslator/files/
94 Temporary files used by gtranslator are stored in this directory
95 (mostly this directory should be empty).
96
98 The learn buffer is the implementation of a personal translation memory
99 (TM) in gtranslator. gtranslator uses the UMTF (a compressed XML file
100 which is normally quite good human readable if uncompressed) format for
101 storing it's learned strings.
102 Your learned strings are then available for the autotranslation feature
103 of gtranslator where gtranslator automatically fills in the correspond‐
104 ing and valuable translations for any message which has already been
105 learned previously. This results in a fairly high percentage of pre‐
106 filled/pretranslated messages.
107 The common and good style of working with the learn buffer and with the
108 autotranslation should be to learn the main po/translation files for
109 your language via gtranslator via calling gtranslator -n -l
110 po-file-to-learn on the command line; this will put the translated
111 strings from this po file into your personal learn buffer.
112 You should learn the main po files (for GNOME for example gnumeric,
113 nautilus, evolution or any other bigger, already translated package's
114 po file) for your language); you can use a new script from the gtrans‐
115 lator package to automatise this task a little bit: it's “build-gtrans‐
116 lator-learn-buffer.sh” which is installed into gtranslator's scripts
117 directory which you can see by calling gtranslator -b and you simply
118 execute the script with it's full path and simply follow the informa‐
119 tions on the command line for it.
120 Afterwards you can simply use the "Autotranslation" menu entry from the
121 GUI or use the "F10" hotkey to let gtranslator autotranslate all miss‐
122 ing translations from your personal learn buffer. This will ease your
123 translation work and make a big portion of the po files be pre-trans‐
124 lated.
125 With a fairly big personal learn buffer of about 2 MB you can achive
126 many pre-translated messages for a new project/translation.
127 If you want to use the stored learn buffer contents to produce a po
128 file with all the “learned” translations, you can also use the “export
129 learn buffer” capability of gtranslator to get a plain po file version
130 of the learn buffer.
131
133 Some examples for the options.
134
135
136 gtranslator -b
137 Shows you the real build specs/dates of gtranslator.
138
139
140 gtranslator -s
141 Give me statistics about the learn buffer of gtranslator.
142
143
144 gtranslator -n -l po-file-to-learn
145 Learns the given po file “po-file-to-learn” on the command line
146 without starting up the GUI.
147
148
149 gtranslator -a po-file
150 Autotranslates all missing entries from the learn buffer if pos‐
151 sible and exits.
152
153
154 gtranslator -e po-file-to-export
155 Exports your current learn buffer to the given plain gettext po
156 file (“po-file-to-export”).
157
158
159 gtranslator po-file
160 Starts gtranslator with the given po-file loaded on startup.
161
162
163 gtranslator -g “460x320+0+0”
164 Lets gtranslator appear on the left upper edge of the screen
165 “+0+0” and gtranslator is sized to “460x320” if possible -- if
166 gtranslator needs more size for it's window contents, it'll
167 expand itself to the necessary dimensions -- even if you defined
168 a smaller geometry string.
169
170
172 gtranslator is distributed under the GNU GPL V 2.0 or greater.
173
174
176 Ross Golder <ross@kabalak.net>, Fatih Demir <kabalak@kabalak.net> (pre‐
177 viously also: Gediminas Paulauskas <menesis@kabalak.net>, Thomas
178 Ziehmer <thomas@kabalak.net>, Kevin Vandersloot <kfv101@psu.edu> and
179 Peeter Vois <peeter@kabalak.net>).
180
182 http://www.gtranslator.org
183
184
186 You can deliver bug reports to the gtranslator development team to our
187 bug base via http://bugzilla.gnome.org/enter_bug.cgi?product=gtransla‐
188 tor
189
190
192 gtranslator 1.9.11 man-page
193
194
195
196gtranslator gtranslator 1.9.11 -- 2010-07-16 gtranslator(1)