Yamyam: 1版をインポートしました

2018-06-28T19:46:00Z

1版をインポートしました

wiki>Xiaoxiangquan: /* I18N Approaches */

2011-09-06T16:39:34Z

‎I18N Approaches

新規ページ

=Notes for Developers=
First of all, you are strongly recommended to read the [[User:Xiaoxiangquan/GoogleSummerOfCode/2011/Internationalization/design|Implementation Design]] before reading this page, as that page contains important foundations.

=For C Code=

== Foundations ==
Include the header, which contains _() and N_() Macro:
<source lang="c">
#include "BLF_api.h"
</source>

If the compiler complains that no "BLF_api.h" has been found, please edit the right CMakelists.txt and SConstruct to add the header directory /source/blender/blenfont.

And of course, make sure that you have configured the building system with INTERNATIONAL enabled, and call any i18n functions after BLF_lang_set("").

== I18N Approaches ==
- For simple texts, try to use _("msgid") directly. It combines marking and runtime translation together.

- For texts that cannot be stored localizedly, for example, those ID strings which should be kept in English while also needed to be displayed in the UI, just use N_("msgid") to mark them, and do the runtime translation at the last moment.

- For texts in some arrays or structs initialization that cannot contain a function call like _(), use N_("msgid") to mark them, and run a special gettext initialization somewhere before making use of the arrays or structs.

Note that we have marked the target texts. This is the necessary step to help xgettext to gather them.

== Special Points for RNA==
The rna files are linked as makesrna firstly, which will generate rna_*_gen.c. These are the real parts linked into blender. So we needn't do anything in rna_*.c except marking.

Mark strings with N_(). The commonest situations are:

<source lang="c">
...
/* EnumPropertyItem arrays, mostly show as options */
static EnumPropertyItem rotation_units[] = {
{0, "DEGREES", 0, N_("Degrees"), N_("Use degrees for measuring rotation")},
{USER_UNIT_ROT_RADIANS, "RADIANS", 0, N_("Radians"), ""},
{0, NULL, 0, NULL, NULL}};
</source>

<source lang="c">
...
/* Property */
prop= RNA_def_property(srna, "use_separate", PROP_BOOLEAN, PROP_NONE);
RNA_def_property_boolean_sdna(prop, NULL, "flag", USER_UNIT_OPT_SPLIT);
RNA_def_property_ui_text(prop, N_("Separate Units"), N_("Display units in pairs"));
RNA_def_property_update(prop, NC_WINDOW, NULL);
</source>

After first build, you can check the generated source files and find out which property list the texts belongs to, and add it to the rna_access.c:RNA_types_init_gettext()'s target struct array. Then the collection and translation will take place.

=For Python Code=
We have supplied blf.gettext(msgid) and blf.fake_gettext(msgid) which do the same things as _() and N_() in C code. Generally, functions can be called in most places in python, so you can just act like this:

<source lang="python">
from blf import gettext as _
...
label = -("String")
</source>

Make sure rename gettext as _, and fake_gettext as N_, or the xgettext cannot gather the texts.

So far, there is only one special case that we cannot apply _() to a python doc:

<source lang="python">
class A:
'''doc'''
</source>

We'll handle it like:

<source lang="python">
class A:
'''doc'''
--doc-- = -('doc')
</source>

All these are true for add-on scripts, too.

=Gather New Text Sources=
Everytime you have marked the first string in a source file, add it to the /po/POTFILES.in, so that they can be gathered.

Then execute /po/update_pot.py, which will call the system's xgettext command. Checking the /po/blender.pot, you'll find those texts have been collected.

=Add a New Language=
If you want to add a new language, just add a new empty X.po under the /po, and run update_po.py, then you can edit the initialized X.po.

Next, make a folder at /release/bin/.blender/locale/X, run update_mo.po to compile the new PO file to a MO.

Then, edit the /source/blender/makesrna/intern/rna_userdef.c : rna_def_userdef_system(), add an item in the language_items array. This will be shown in the language selection menu.

At last, edit the /source/blender/blenfont/intern/blf_lang.c, add an item in the lang_to_locale array. This will set the real language when application starts.

- Done! Enjoy it.

← 古い版	2018年6月28日 (木) 19:46時点における版
(相違点なし)

利用者:Xiaoxiangquan/GoogleSummerOfCode/2011/Internationalization/notes for developers - 版の履歴

Yamyam: 1版 をインポートしました

wiki>Xiaoxiangquan: /* I18N Approaches */

Yamyam: 1版をインポートしました