| 1 | .TH "make-messages.py" "1" "August 2007" "Django Project" ""
|
|---|
| 2 | .SH "NAME"
|
|---|
| 3 | make-messages.py \- Internationalization utility for the Django
|
|---|
| 4 | web framework
|
|---|
| 5 | .SH "SYNOPSIS"
|
|---|
| 6 | .B make-messages.py [options] -l
|
|---|
| 7 | .I <language>
|
|---|
| 8 | .sp
|
|---|
| 9 | .B make-messages.py [options] -a
|
|---|
| 10 |
|
|---|
| 11 | .SH "DESCRIPTION"
|
|---|
| 12 | This script creates or updates one or more message files for a Django app,
|
|---|
| 13 | a Django project or the Django framework itself. It should be run from one
|
|---|
| 14 | of three places: the root directory of a Django app; the root directory
|
|---|
| 15 | of a Django project; or the root django directory (the one in your PYTHONPATH,
|
|---|
| 16 | not the root of a Subversion checkout).
|
|---|
| 17 | .sp
|
|---|
| 18 | When run with the -l flag and a language code (in locale format), the script
|
|---|
| 19 | will run over the source tree of your app, your project or Django itself
|
|---|
| 20 | (depending on where it is invoked), pulling out all strings marked for
|
|---|
| 21 | translation and creating or updating a message file for the specified
|
|---|
| 22 | language. (See Django's internationalization documentation for details of
|
|---|
| 23 | where this file is created.) Translations can be added to this message file
|
|---|
| 24 | using a regular text editor.
|
|---|
| 25 | .sp
|
|---|
| 26 | When run with the -a flag, the script will process the source tree and
|
|---|
| 27 | create/update message files for all languages supported by Django.
|
|---|
| 28 |
|
|---|
| 29 | .SH "OPTIONS"
|
|---|
| 30 | .TP
|
|---|
| 31 | .I \-d <domain>
|
|---|
| 32 | Specifies the domain. Valid domains are 'django' or 'djangojs', depending on
|
|---|
| 33 | whether you wish to generate translation strings for the Python or JavaScript
|
|---|
| 34 | components of your app, your project or the framework itself. The default
|
|---|
| 35 | domain is 'django'.
|
|---|
| 36 | .TP
|
|---|
| 37 | .I \-v
|
|---|
| 38 | Run verbosely.
|
|---|
| 39 |
|
|---|
| 40 | .SH "ENVIRONMENT"
|
|---|
| 41 | .TP
|
|---|
| 42 | .I DJANGO_SETTINGS_MODULE
|
|---|
| 43 | This environment variable defines the settings module to be read.
|
|---|
| 44 | It should be in Python-import form, e.g. "myproject.settings".
|
|---|
| 45 |
|
|---|
| 46 | .SH "SEE ALSO"
|
|---|
| 47 | The internationalization documentation:
|
|---|
| 48 | .sp
|
|---|
| 49 | .I http://www.djangoproject.com/documentation/i18n/
|
|---|
| 50 |
|
|---|
| 51 | .SH "AUTHORS/CREDITS"
|
|---|
| 52 | Originally developed at World Online in Lawrence, Kansas, USA. Refer to the
|
|---|
| 53 | AUTHORS file in the Django distribution for contributors.
|
|---|
| 54 |
|
|---|
| 55 | .SH "LICENSE"
|
|---|
| 56 | New BSD license. For the full license text refer to the LICENSE file in the
|
|---|
| 57 | Django distribution.
|
|---|
| 58 |
|
|---|