Mercurial > babel > old > mirror
annotate doc/index.txt @ 57:e7080996fc46
`new_catalog` now accepts another argument, `--domain`, which is used to build the output file path, which now is of the form `<output_dir>/<locale>/<domain>.po`, the correct form.
Removed the language and coutry arguments of `write_po`, which instead accepts a `babel.core.Locale` object to retrieve the needed object.
| author | palgarvio |
|---|---|
| date | Fri, 08 Jun 2007 10:37:47 +0000 |
| parents | 496a5c3f9d6d |
| children | 98b27ffe1c3a |
| rev | line source |
|---|---|
| 4 | 1 .. -*- mode: rst; encoding: utf-8 -*- |
| 2 | |
| 3 ===== | |
| 4 Babel | |
| 5 ===== | |
| 6 | |
|
16
03c36aaddaf8
Add a temporary/placeholder logo. Not the real thing, I promise ;-)
cmlenz
parents:
4
diff
changeset
|
7 .. image:: logo_small.png |
|
03c36aaddaf8
Add a temporary/placeholder logo. Not the real thing, I promise ;-)
cmlenz
parents:
4
diff
changeset
|
8 :width: 158 |
|
03c36aaddaf8
Add a temporary/placeholder logo. Not the real thing, I promise ;-)
cmlenz
parents:
4
diff
changeset
|
9 :height: 85 |
|
03c36aaddaf8
Add a temporary/placeholder logo. Not the real thing, I promise ;-)
cmlenz
parents:
4
diff
changeset
|
10 :align: center |
|
03c36aaddaf8
Add a temporary/placeholder logo. Not the real thing, I promise ;-)
cmlenz
parents:
4
diff
changeset
|
11 :alt: Babel |
|
03c36aaddaf8
Add a temporary/placeholder logo. Not the real thing, I promise ;-)
cmlenz
parents:
4
diff
changeset
|
12 :class: logo |
| 4 | 13 |
| 14 --------------------------------------------------- | |
| 15 Simple Internationalization for Python Applications | |
| 16 --------------------------------------------------- | |
| 17 | |
| 18 Babel is an integrated collection of utilities that assist in | |
| 19 internationalizing and localizing Python applications, with an | |
| 20 emphasis on web-based applications. | |
| 21 | |
| 22 * `Working with Message Catalogs <catalogs.html>`_ | |
| 23 * `Locale Display Names <display.html>`_ | |
| 24 * `Number and Date Formatting <formatting.html>`_ | |
| 25 * `Command-Line Interface <cmdline.html>`_ | |
| 26 * `Distutils/Setuptools Integration <setup.html>`_ | |
| 27 * `Generated API Documentation <api/index.html>`_ | |
| 28 | |
| 29 Introduction | |
| 30 ------------ | |
| 31 | |
| 32 The functionality Babel provides for internationalization (I18n) and | |
| 33 localization (L10N) can be separated into two different aspects: | |
| 34 | |
| 35 * tools to build and work with ``gettext`` message catalogs, and | |
| 36 * a Python interface to the CLDR (Common Locale Data Repository), providing | |
| 37 access to various locale display names, localized number and date | |
| 38 formatting, etc. | |
| 39 | |
| 40 While the Python standard library includes a | |
| 41 `gettext <http://docs.python.org/lib/module-gettext.html>`_ module that enables | |
| 42 applications to use message catalogs, it requires developers to build these | |
| 43 catalogs using GNU tools such as ``xgettext``, ``msgmerge``, and ``msgfmt``. | |
| 44 And while ``xgettext`` does have support for extracting messages from Python | |
| 45 files, it does not know how to deal with other kinds of files commonly found | |
| 46 in Python web-applications, such as templates, nor does it provide an easy | |
| 47 extensibility mechanism to add such support. | |
| 48 | |
| 49 Babel addresses this by providing a framework where various extraction methods | |
| 50 can be plugged in to a larger message extraction framework, and also removes | |
| 51 the dependency on the GNU ``gettext`` tools for common tasks, as these aren't | |
| 52 necessarily available on all platforms. See `Working with Message Catalogs`_ | |
| 53 for details on this aspect of Babel. | |
| 54 | |
| 55 Furthermore, while the Python standard library does include support for basic | |
| 56 localization with respect to the formatting of numbers and dates (the | |
| 57 `locale <http://docs.python.org/lib/module-locale.html>`_ module, among others), | |
| 58 this support is based on the assumption that there will be only one specific | |
| 59 locale used per process (at least simultaneously.) Also, it doesn't provide | |
| 60 access to other kinds of locale data, such as the localized names of countries, | |
|
40
496a5c3f9d6d
Started implementation of datetime parsing, using a very basic approach for now.
cmlenz
parents:
16
diff
changeset
|
61 languages, or time-zones, which are frequently needed in web-based applications. |
| 4 | 62 |
| 63 For these requirements, Babel includes data extracted from the `Common Locale | |
| 64 Data Repository (CLDR) <http://unicode.org/cldr/>`_, and provides a number of | |
| 65 convenient methods for accessing and using this data. See `Locale Display | |
| 66 Names`_ and `Number and Date Formatting`_ for more information on this aspect | |
| 67 of Babel. | |
| 68 |