revi-archive/phorge-phorge
1
0
Fork 0
mirror of https://we.phorge.it/source/phorge.git synced 2025-04-04 08:28:22 +02:00
Code Issues Releases Wiki Activity

Link libphutil docs

Browse source
This commit is contained in:
vrana 2012-06-18 19:09:27 -07:00
parent 8a8a48cc8f
commit c53ed032c9
1 changed files with 13 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

23
src/docs/contributing/internationalization.diviner
View file

@ -5,10 +5,12 @@ What is required from developers to get Phabricator translatable.
= API = = API =
Translator API is provided by libphutil. It gives us `PhutilTranslator` class Translator API is provided by libphutil. It gives us
and global `pht()` function built on top of it. @{class@libphutil:PhutilTranslator} class and global @{function@libphutil:pht}
function built on top of it.
Developers are supposed to call `pht()` on all strings that require translation. Developers are supposed to call @{function@libphutil:pht} on all strings that
require translation.
Phabricator provides translations for this translator through Phabricator provides translations for this translator through
@{class:PhabricatorTranslation} class. @{class:PhabricatorTranslation} class.
@ -23,13 +25,13 @@ and you will be able to specify this class in the global configuration
= Adding a New Language = = Adding a New Language =
Adding a language involves all steps as adding a translation plus specifying the Adding a language involves all steps as adding a translation plus specifying the
language rules in `PhutilTranslator::chooseVariant()`. language rules in @{method@libphutil:PhutilTranslator::chooseVariant}.
= Singular and Plural = = Singular and Plural =
Different languages have various rules for using singular and plural. All you Different languages have various rules for using singular and plural. All you
need to do is to call `pht()` with a text that is suitable for both forms. need to do is to call @{function@libphutil:pht} with a text that is suitable for
Example: both forms. Example:
pht('%d beer(s)', $count); pht('%d beer(s)', $count);
@ -41,14 +43,15 @@ Translators will translate this text for all different forms the language uses:
// Czech translation // Czech translation
array('%d pivo', '%d piva', '%d piv'); array('%d pivo', '%d piva', '%d piv');
The ugly identifier passed to `pht()` will remain in the text only if the The ugly identifier passed to @{function@libphutil:pht} will remain in the text
translation doesn't exist. only if the translation doesn't exist.
= Male and Female = = Male and Female =
Different languages use different words for talking about males, females and Different languages use different words for talking about males, females and
unknown genders. Callsites have to call `pht()` passing @{class:PhabricatorUser} unknown genders. Callsites have to call @{function@libphutil:pht} passing
(or other implementation of `PhutilPerson`) if talking about the user. Example: @{class:PhabricatorUser} (or other implementation of
@{interface@libphutil:PhutilPerson}) if talking about the user. Example:
pht('%s wrote', $actor); pht('%s wrote', $actor);