Skip to content

Translation: add i18n and L10n keywords. #912

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Dec 16, 2011
Merged

Translation: add i18n and L10n keywords. #912

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 14 additions & 9 deletions book/translation.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,12 @@
Translations
============

The term "internationalization" refers to the process of abstracting strings
and other locale-specific pieces out of your application and into a layer
where they can be translated and converted based on the user's locale (i.e.
language and country). For text, this means wrapping each with a function
capable of translating the text (or "message") into the language of the user::
The term "internationalization" (often abbreviated `i18n`_) refers to the process
of abstracting strings and other locale-specific pieces out of your application
and into a layer where they can be translated and converted based on the user's
locale (i.e. language and country). For text, this means wrapping each with a
function capable of translating the text (or "message") into the language of
the user::

// text will *always* print out in English
echo 'Hello World';
Expand Down Expand Up @@ -321,10 +322,12 @@ taste.
Creating Translations
~~~~~~~~~~~~~~~~~~~~~

Each file consists of a series of id-translation pairs for the given domain and
locale. The id is the identifier for the individual translation, and can
be the message in the main locale (e.g. "Symfony is great") of your application
or a unique identifier (e.g. "symfony2.great" - see the sidebar below):
The act of creating translation files is an important part of "localization"
(often abbreviated `L10n`_). Translation files consist of a series of
id-translation pairs for the given domain and locale. The id is the identifier
for the individual translation, and can be the message in the main locale (e.g.
"Symfony is great") of your application or a unique identifier (e.g.
"symfony2.great" - see the sidebar below):

.. configuration-block::

Expand Down Expand Up @@ -837,6 +840,8 @@ steps:

* Manage the user's locale, which is stored in the session.

.. _`i18n`: http://en.wikipedia.org/wiki/Internationalization_and_localization
.. _`L10n`: http://en.wikipedia.org/wiki/Internationalization_and_localization
.. _`strtr function`: http://www.php.net/manual/en/function.strtr.php
.. _`ISO 31-11`: http://en.wikipedia.org/wiki/Interval_%28mathematics%29#The_ISO_notation
.. _`Translatable Extension`: https://github.com/l3pp4rd/DoctrineExtensions