diff options
| author | Chris McDonough <chrism@agendaless.com> | 2010-04-25 12:35:47 +0000 |
|---|---|---|
| committer | Chris McDonough <chrism@agendaless.com> | 2010-04-25 12:35:47 +0000 |
| commit | df3beb147ebb69b3176a5cad859df76298538c0d (patch) | |
| tree | 20904b7ee60a8cfda9f0af4a039d499ff26b9c02 /docs | |
| parent | 8e3b346d17ee206a8d5322df35a843547c65d639 (diff) | |
| download | pyramid-df3beb147ebb69b3176a5cad859df76298538c0d.tar.gz pyramid-df3beb147ebb69b3176a5cad859df76298538c0d.tar.bz2 pyramid-df3beb147ebb69b3176a5cad859df76298538c0d.zip | |
Docs.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/glossary.rst | 14 | ||||
| -rw-r--r-- | docs/narr/i18n.rst | 22 |
2 files changed, 27 insertions, 9 deletions
diff --git a/docs/glossary.rst b/docs/glossary.rst index 026db614a..05a6c1479 100644 --- a/docs/glossary.rst +++ b/docs/glossary.rst @@ -739,4 +739,16 @@ Glossary Message Catalog A :term:`gettext` ``.mo`` file containing translations. - + Internationalization + The act of creating software with a user interface that can + potentially be displayed in more than one language or cultural + context. Often shortened to "i18n" (because the word + "internationalization" is I, 18 letters, then N). See also: + :term:`Localization`. + + Localization + The process of displaying the user interface of an + internationalized application in a particular language or + cultural context. Often shortened to "l10" (because the word + "localization" is L, 10 letters, then N). See also: + :term:`Internationalization`. diff --git a/docs/narr/i18n.rst b/docs/narr/i18n.rst index ae04f5ba3..577551656 100644 --- a/docs/narr/i18n.rst +++ b/docs/narr/i18n.rst @@ -9,10 +9,16 @@ Internationalization and Localization ===================================== -:mod:`repoze.bfg` offers internationalization (i18n) and localization -(l10n) subsystems that can be used to translate the text of buttons, -the text of error messages and other software- and template-defined -values into the native language of a user of your application. +:term:`Internationalization` (i18n) is the act of creating software +with a user interface that can potentially be displayed in more than +one language or cultural context. :term:`Localization` (l10n) is the +process of displaying the user interface of an internationalized +application in a *particular* language or cultural context. + +:mod:`repoze.bfg` offers internationalization and localization +subsystems that can be used to translate the text of buttons, error +messages and other software- and template-defined values into the +native language of a user of your application. .. note: The APIs and functionality described in this chapter are new as of :mod:`repoze.bfg` version 1.3. @@ -29,10 +35,10 @@ Creating a Translation String While you write your software, you can insert specialized markup into your Python code that makes it possible for the system to translate text values into the languages used by your application's users. This -markup generates a :term:`translation string`. A translation string -is an object that behave mostly like a normal Unicode object, except -that it also carries around extra information related to its job as -part of the :mod:`repoze.bfg` translation machinery. +markup creates a :term:`translation string`. A translation string is +an object that behave mostly like a normal Unicode object, except that +it also carries around extra information related to its job as part of +the :mod:`repoze.bfg` translation machinery. Using The ``TranslationString`` Class ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |