Skip to content

Latest commit

 

History

History
49 lines (32 loc) · 1.37 KB

TRANSLATING.md

File metadata and controls

49 lines (32 loc) · 1.37 KB

Translation Guidelines

Translation workflow

Preparation

RBE uses mdbook-i18n-helpers as a translation framework. The following tools are required.

  • GNU gettext utilities ( msgmerge and msgcat )
  • mdbook-i18n-helpers ( cargo install mdbook-i18n-helpers )

Creating and Updating Translations

Please see the mdbook-i18n-helpers USAGE file for the detailed usage of mdbook-i18n-helpers. The summarized command list is below:

Generating a message template

The generated message templete po/messages.pot is required to create or update translations.

MDBOOK_OUTPUT='{"xgettext": {"pot-file": "messages.pot"}}' \
  mdbook build -d po

Creating a new translation resource

xx is ISO 639 language code.

msginit -i po/messages.pot -l xx -o po/xx.po

Updating the existing translation resource

msgmerge --update po/xx.po po/messages.pot

Editing translation resources

After generating a translation resource po/xx.po, you can write translation messages in msgstr entry of po/xx.po. To build a translated book, the following command can be used.

MDBOOK_BOOK__LANGUAGE=xx mdbook build
MDBOOK_BOOK__LANGUAGE=xx mdbook serve