4 releases

0.1.3 Mar 18, 2023
0.1.2 Oct 4, 2022
0.1.1 Mar 28, 2020
0.1.0 Sep 6, 2019

#91 in Internationalization (i18n)

27 downloads per month

MIT license

18KB
168 lines

mdBook-i18n

Simple mdBook i18n plugin.

Installation

It requires mdbook >= 0.3.1.

# cargo install mdbook
# cargo install mdbook-i18n

Usage

  1. Add language to book section in your book.toml.
  2. Add output.i18n.translations table to your book.toml. Every record in this table must contains language and title. Also records can contains fields authors (must be array), translators (also must be array), description and src. If src not present in record, then this field creates as <book's root>/translations/<language name>.
  3. Write translations.
  4. Run mdbook build for build all books. Every book saves in destination directory in folder with locale name.

How it works?

Source book from config converts to translation config. Common configs shares between all translations. After that mdbook runs for every translation.

Limitations

  1. Custom values from main config don't send to mdbook config. For now this project used native RenderContext what have private rest field in config (this field contains custom values from config).
  2. Books don't share assets. Because native render of mdbook can build only one build, every build generate full tree of assets.
  3. Books don't has links to different l10n. Because used native render without custom templates.
  4. Maybe everything else what i forget.

License

MIT

Dependencies

~12–25MB
~336K SLoC