Mercurial > babel > old > babel-test

annotate doc/setup.txt @ 227:01dd895f396c

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Fix tests broken by [233], and add new tests.
author cmlenz
date Fri, 20 Jul 2007 16:20:43 +0000
parents cf09490f22b3
children 318394721dc6
rev   line source
2
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
1 .. -*- mode: rst; encoding: utf-8 -*-
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
2
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
3 ================================
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
4 Distutils/Setuptools Integration
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
5 ================================
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
6
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
7 Babel provides commands for integration into ``setup.py`` scripts, based on
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
8 either the ``distutils`` package that is part of the Python standard library,
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
9 or the third-party ``setuptools`` package.
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
10
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
11 These commands are available by default when Babel has been properly installed,
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
12 and ``setup.py`` is using ``setuptools``. For projects that use plain old
40
4525549aa6cc Syntax highlighting for the docs.
cmlenz
parents: 2
diff changeset
13 ``distutils``, the commands need to be registered explicitly, for example:
4525549aa6cc Syntax highlighting for the docs.
cmlenz
parents: 2
diff changeset
14
4525549aa6cc Syntax highlighting for the docs.
cmlenz
parents: 2
diff changeset
15 .. code-block:: python
2
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
16
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
17 from distutils.core import setup
54
b3395b285104 Rename the `babel.catalog` package to `babel.messages` for consistency with the other package names.
cmlenz
parents: 51
diff changeset
18 from babel.messages import frontend as babel
2
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
19
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
20 setup(
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
21 ...
160
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
22 cmd_class = {'compile_catalog': babel.compile_catalog,
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
23 'extract_messages': babel.extract_messages,
181
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
24 'init_catalog': babel.init_catalog}
2
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
25 )
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
26
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
27
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
28 .. contents:: Contents
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
29 :depth: 2
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
30 .. sectnum::
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
31
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
32
160
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
33 compile_catalog
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
34 ===============
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
35
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
36 The ``compile_catalog`` command is similar to the GNU ``msgfmt`` tool, in that
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
37 it takes a message catalog from a PO file and compiles it to a binary MO file.
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
38
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
39 If the command has been correctly installed or registered, a project's
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
40 ``setup.py`` script should allow you to use the command::
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
41
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
42 $ ./setup.py compile_catalog --help
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
43 Global options:
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
44 --verbose (-v) run verbosely (default)
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
45 --quiet (-q) run quietly (turns verbosity off)
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
46 --dry-run (-n) don't actually do anything
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
47 --help (-h) show detailed help message
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
48
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
49 Options for 'compile_catalog' command:
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
50 ...
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
51
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
52 Running the command will produce a PO template file::
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
53
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
54 $ ./setup.py compile_catalog --directory foobar/locale --locale pt_BR
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
55 running compile_catalog
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
56 compiling catalog to to foobar/locale/pt_BR/LC_MESSAGES/messages.mo
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
57
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
58
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
59 Options
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
60 -------
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
61
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
62 The ``compile_catalog`` command accepts the following options:
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
63
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
64 +-----------------------------+----------------------------------------------+
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
65 | Option | Description |
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
66 +=============================+==============================================+
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
67 | ``--domain`` | domain of the PO file (defaults to |
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
68 | | lower-cased project name) |
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
69 +-----------------------------+----------------------------------------------+
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
70 | ``--directory`` (``-d``) | name of the base directory |
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
71 +-----------------------------+----------------------------------------------+
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
72 | ``--input-file`` (``-i``) | name of the input file |
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
73 +-----------------------------+----------------------------------------------+
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
74 | ``--output-file`` (``-o``) | name of the output file |
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
75 +-----------------------------+----------------------------------------------+
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
76 | ``--locale`` | locale for the new localized string |
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
77 +-----------------------------+----------------------------------------------+
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
78 | ``--use-fuzzy`` | also include "fuzzy" translations |
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
79 +-----------------------------+----------------------------------------------+
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
80
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
81 If ``directory`` is specified, but ``output-file`` is not, the default filename
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
82 of the output file will be::
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
83
177
a7766f92f944 * Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents: 160
diff changeset
84 <directory>/<locale>/LC_MESSAGES/<domain>.mo
a7766f92f944 * Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents: 160
diff changeset
85
a7766f92f944 * Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents: 160
diff changeset
86 If neither the ``input_file`` nor the ``locale`` option is set, this command
a7766f92f944 * Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents: 160
diff changeset
87 looks for all catalog files in the base directory that match the given domain,
a7766f92f944 * Instead of an extra `compile-all` option on the `compile` (or `compile_catalog`) command, compilation of all catalogs is performed when neither an `input_file` nor a `locale` is specified.
cmlenz
parents: 160
diff changeset
88 and compiles each of them to MO files in the same directory.
160
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
89
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
90 These options can either be specified on the command-line, or in the
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
91 ``setup.cfg`` file.
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
92
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
93
2
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
94 extract_messages
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
95 ================
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
96
90
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
97 The ``extract_messages`` command is comparable to the GNU ``xgettext`` program:
2
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
98 it can extract localizable messages from a variety of difference source files,
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
99 and generate a PO (portable object) template file from the collected messages.
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
100
160
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
101 If the command has been correctly installed or registered, a project's
2
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
102 ``setup.py`` script should allow you to use the command::
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
103
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
104 $ ./setup.py extract_messages --help
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
105 Global options:
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
106 --verbose (-v) run verbosely (default)
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
107 --quiet (-q) run quietly (turns verbosity off)
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
108 --dry-run (-n) don't actually do anything
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
109 --help (-h) show detailed help message
77
5c819411e4af Updated frontend screens for added sorting features.
cmlenz
parents: 62
diff changeset
110
2
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
111 Options for 'extract_messages' command:
90
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
112 ...
2
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
113
51
7f61453c1bea Fixed a bug regarding plural msgid's handling when writing the `.pot` file.
palgarvio
parents: 49
diff changeset
114 Running the command will produce a PO template file::
2
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
115
49
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
116 $ ./setup.py extract_messages --output-file foobar/locale/messages.pot
2
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
117 running extract_messages
49
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
118 extracting messages from foobar/__init__.py
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
119 extracting messages from foobar/core.py
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
120 ...
51
7f61453c1bea Fixed a bug regarding plural msgid's handling when writing the `.pot` file.
palgarvio
parents: 49
diff changeset
121 writing PO template file to foobar/locale/messages.pot
49
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
122
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
123
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
124 Method Mapping
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
125 --------------
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
126
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
127 The mapping of file patterns to extraction methods (and options) can be
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
128 specified using a configuration file that is pointed to using the
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
129 ``--mapping-file`` option shown above. Alternatively, you can configure the
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
130 mapping directly in ``setup.py`` using a keyword argument to the ``setup()``
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
131 function:
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
132
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
133 .. code-block:: python
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
134
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
135 setup(...
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
136
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
137 message_extractors = {
62
84d400066b71 The order of extraction methods is now preserved (see #10).
cmlenz
parents: 54
diff changeset
138 'foobar': [
117
41506e62701f Made new frontend tests more ''unit-y'', i.e. calling the APIs directly instead of launching the scripts.
cmlenz
parents: 90
diff changeset
139 ('**.py', 'python', None),
41506e62701f Made new frontend tests more ''unit-y'', i.e. calling the APIs directly instead of launching the scripts.
cmlenz
parents: 90
diff changeset
140 ('**/templates/**.html', 'genshi', None),
41506e62701f Made new frontend tests more ''unit-y'', i.e. calling the APIs directly instead of launching the scripts.
cmlenz
parents: 90
diff changeset
141 ('**/templates/**.txt', 'genshi', {
144
a5914ba672d1 Some doc fixes.
cmlenz
parents: 117
diff changeset
142 'template_class': 'genshi.template:TextTemplate'
62
84d400066b71 The order of extraction methods is now preserved (see #10).
cmlenz
parents: 54
diff changeset
143 })
84d400066b71 The order of extraction methods is now preserved (see #10).
cmlenz
parents: 54
diff changeset
144 ],
49
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
145 },
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
146
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
147 ...
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
148 )
2
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
149
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
150
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
151 Options
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
152 -------
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
153
90
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
154 The ``extract_messages`` command accepts the following options:
2
b2492365f186 Forgot to check in the doc directory.
cmlenz
parents:
diff changeset
155
49
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
156 +-----------------------------+----------------------------------------------+
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
157 | Option | Description |
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
158 +=============================+==============================================+
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
159 | ``--charset`` | charset to use in the output file |
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
160 +-----------------------------+----------------------------------------------+
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
161 | ``--keywords`` (``-k``) | space-separated list of keywords to look for |
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
162 | | in addition to the defaults |
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
163 +-----------------------------+----------------------------------------------+
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
164 | ``--no-default-keywords`` | do not include the default keywords |
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
165 +-----------------------------+----------------------------------------------+
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
166 | ``--mapping-file`` (``-F``) | path to the mapping configuration file |
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
167 +-----------------------------+----------------------------------------------+
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
168 | ``--no-location`` | do not include location comments with |
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
169 | | filename and line number |
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
170 +-----------------------------+----------------------------------------------+
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
171 | ``--omit-header`` | do not include msgid "" entry in header |
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
172 +-----------------------------+----------------------------------------------+
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
173 | ``--output-file`` (``-o``) | name of the output file |
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
174 +-----------------------------+----------------------------------------------+
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
175 | ``--width`` (``-w``) | set output line width (default 76) |
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
176 +-----------------------------+----------------------------------------------+
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
177 | ``--no-wrap`` | do not break long message lines, longer than |
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
178 | | the output line width, into several lines |
daf35e2ad044 Support a `message_extractors` keyword argument directly in `setup()`. Closes #4.
cmlenz
parents: 40
diff changeset
179 +-----------------------------+----------------------------------------------+
62
84d400066b71 The order of extraction methods is now preserved (see #10).
cmlenz
parents: 54
diff changeset
180 | ``--input-dirs`` | directories that should be scanned for |
84d400066b71 The order of extraction methods is now preserved (see #10).
cmlenz
parents: 54
diff changeset
181 | | messages |
84d400066b71 The order of extraction methods is now preserved (see #10).
cmlenz
parents: 54
diff changeset
182 +-----------------------------+----------------------------------------------+
90
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
183 | ``--sort-output`` | generate sorted output (default False) |
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
184 +-----------------------------+----------------------------------------------+
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
185 | ``--sort-by-file`` | sort output by file location (default False) |
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
186 +-----------------------------+----------------------------------------------+
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
187 | ``--msgid-bugs-address`` | set email address for message bug reports |
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
188 +-----------------------------+----------------------------------------------+
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
189 | ``--copyright-holder`` | set copyright holder in output |
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
190 +-----------------------------+----------------------------------------------+
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
191 | ``--add-comments (-c)`` | place comment block with TAG (or those |
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
192 | | preceding keyword lines) in output file. |
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
193 | | Separate multiple TAGs with commas(,) |
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
194 +-----------------------------+----------------------------------------------+
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
195
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
196 These options can either be specified on the command-line, or in the
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
197 ``setup.cfg`` file. In the latter case, the options above become entries of the
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
198 section ``[extract_messages]``, and the option names are changed to use
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
199 underscore characters instead of dashes, for example:
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
200
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
201 .. code-block:: ini
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
202
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
203 [extract_messages]
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
204 keywords = _, gettext, ngettext
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
205 mapping_file = babel.cfg
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
206 width = 80
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
207
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
208 This would be equivalent to invoking the command from the command-line as
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
209 follows::
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
210
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
211 $ setup.py extract_messages -k _ -k gettext -k ngettext -F mapping.cfg -w 80
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
212
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
213 Any path names are interpreted relative to the location of the ``setup.py``
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
214 file. For boolean options, use "true" or "false" values.
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
215
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
216
181
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
217 init_catalog
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
218 ============
90
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
219
181
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
220 The ``init_catalog`` command is basically equivalent to the GNU ``msginit``
90
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
221 program: it creates a new translation catalog based on a PO template file (POT).
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
222
160
80e51aabc440 Add MO file generation. Closes #21.
cmlenz
parents: 144
diff changeset
223 If the command has been correctly installed or registered, a project's
90
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
224 ``setup.py`` script should allow you to use the command::
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
225
181
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
226 $ ./setup.py init_catalog --help
90
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
227 Global options:
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
228 --verbose (-v) run verbosely (default)
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
229 --quiet (-q) run quietly (turns verbosity off)
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
230 --dry-run (-n) don't actually do anything
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
231 --help (-h) show detailed help message
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
232
181
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
233 Options for 'init_catalog' command:
90
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
234 ...
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
235
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
236 Running the command will produce a PO file::
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
237
181
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
238 $ ./setup.py init_catalog -l fr -i foobar/locales/messages.pot \
90
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
239 -o foobar/locales/fr/messages.po
181
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
240 running init_catalog
90
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
241 creating catalog 'foobar/locales/fr/messages.po' based on 'foobar/locales/messages.pot'
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
242
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
243
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
244 Options
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
245 -------
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
246
181
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
247 The ``init_catalog`` command accepts the following options:
90
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
248
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
249 +-----------------------------+----------------------------------------------+
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
250 | Option | Description |
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
251 +=============================+==============================================+
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
252 | ``--domain`` | domain of the PO file (defaults to |
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
253 | | lower-cased project name) |
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
254 +-----------------------------+----------------------------------------------+
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
255 | ``--input-file`` (``-i``) | name of the input file |
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
256 +-----------------------------+----------------------------------------------+
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
257 | ``--output-dir`` (``-d``) | name of the output directory |
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
258 +-----------------------------+----------------------------------------------+
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
259 | ``--output-file`` (``-o``) | name of the output file |
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
260 +-----------------------------+----------------------------------------------+
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
261 | ``--locale`` | locale for the new localized string |
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
262 +-----------------------------+----------------------------------------------+
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
263 | ``--omit-header`` | do not include msgid "" entry in header |
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
264 +-----------------------------+----------------------------------------------+
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
265 | ``--first-author`` | name of the first author |
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
266 +-----------------------------+----------------------------------------------+
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
267 | ``--first-author-email`` | email address of the first author |
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
268 +-----------------------------+----------------------------------------------+
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
269
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
270 If ``output-dir`` is specified, but ``output-file`` is not, the default filename
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
271 of the output file will be::
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
272
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
273 <output_dir>/<locale>/LC_MESSAGES/<domain>.po
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
274
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
275 These options can either be specified on the command-line, or in the
e43bb7dc7eec Some doc improvements on distutils integration.
cmlenz
parents: 80
diff changeset
276 ``setup.cfg`` file.
181
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
277
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
278
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
279 update_catalog
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
280 ==============
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
281
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
282 The ``update_catalog`` command is basically equivalent to the GNU ``msgmerge``
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
283 program: it updates an existing translations catalog based on a PO template
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
284 file (POT).
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
285
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
286 If the command has been correctly installed or registered, a project's
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
287 ``setup.py`` script should allow you to use the command::
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
288
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
289 $ ./setup.py update_catalog --help
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
290 Global options:
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
291 --verbose (-v) run verbosely (default)
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
292 --quiet (-q) run quietly (turns verbosity off)
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
293 --dry-run (-n) don't actually do anything
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
294 --help (-h) show detailed help message
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
295
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
296 Options for 'update_catalog' command:
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
297 ...
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
298
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
299 Running the command will update a PO file::
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
300
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
301 $ ./setup.py update_catalog -l fr -i foobar/locales/messages.pot \
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
302 -o foobar/locales/fr/messages.po
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
303 running update_catalog
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
304 updating catalog 'foobar/locales/fr/messages.po' based on 'foobar/locales/messages.pot'
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
305
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
306
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
307 Options
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
308 -------
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
309
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
310 The ``update_catalog`` command accepts the following options:
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
311
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
312 +-----------------------------+----------------------------------------------+
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
313 | Option | Description |
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
314 +=============================+==============================================+
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
315 | ``--domain`` | domain of the PO file (defaults to |
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
316 | | lower-cased project name) |
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
317 +-----------------------------+----------------------------------------------+
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
318 | ``--input-file`` (``-i``) | name of the input file |
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
319 +-----------------------------+----------------------------------------------+
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
320 | ``--output-dir`` (``-d``) | name of the output directory |
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
321 +-----------------------------+----------------------------------------------+
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
322 | ``--output-file`` (``-o``) | name of the output file |
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
323 +-----------------------------+----------------------------------------------+
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
324 | ``--locale`` | locale for the new localized string |
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
325 +-----------------------------+----------------------------------------------+
191
cf09490f22b3 Add an option to the frontend commands for catalog updating that removes completely any obsolete messages, instead of putting them comments.
cmlenz
parents: 181
diff changeset
326 | ``--ignore-obsolete`` | do not include obsolete messages in the |
cf09490f22b3 Add an option to the frontend commands for catalog updating that removes completely any obsolete messages, instead of putting them comments.
cmlenz
parents: 181
diff changeset
327 | | output |
cf09490f22b3 Add an option to the frontend commands for catalog updating that removes completely any obsolete messages, instead of putting them comments.
cmlenz
parents: 181
diff changeset
328 +-----------------------------+----------------------------------------------+
181
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
329
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
330 If ``output-dir`` is specified, but ``output-file`` is not, the default filename
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
331 of the output file will be::
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
332
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
333 <output_dir>/<locale>/LC_MESSAGES/<domain>.po
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
334
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
335 If neither the ``input_file`` nor the ``locale`` option is set, this command
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
336 looks for all catalog files in the base directory that match the given domain,
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
337 and updates each of them.
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
338
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
339 These options can either be specified on the command-line, or in the
9a1acb41e7dd The frontends now provide ways to update existing translations catalogs from a template. Closes #22.
cmlenz
parents: 177
diff changeset
340 ``setup.cfg`` file.
Copyright (C) 2012-2017 Edgewall Software