Rust I18n

Rust I18n是一个用于从一组YAML映射文件加载本地化文本的crate。这些映射在编译时转换为Rust程序可读的数据，然后可以通过调用提供的format_t!宏来加载本地化文本。

此crate的API受到ruby-i18n和Rails I18n的启发。

特性

• 编译时生成代码，将翻译包含到二进制中。
• 全局format_t!宏，用于在所有地方加载本地化文本。
• 使用YAML进行本地化文本映射，并支持多个YAML文件的合并。
• cargo i18n命令行工具，用于检查并提取未翻译文本到YAML文件中。

安装

Rust I18n还提供了一个cargo i18n命令行工具，帮助您处理翻译。

$ cargo install i18n-again

用法

在Cargo.toml中添加crate依赖项并设置I18n配置

[dependencies]
once_cell = "1.10.0"
i18n-again = "0"

[package.metadata.i18n]
# The available locales for your application, default: ["en"].
# available-locales = ["en", "zh-CN"]

# The default locale, default: "en".
# default-locale = "en"

# Path for your translations YAML file, default: "locales".
# load-path = "locales"

在lib.rs中加载宏并初始化翻译

// Load I18n macro, for allow you use `format_t!` macro in anywhere.
#[macro_use]
extern crate i18n_again;

// Init translations for current crate.
i18n!("locales");

或者您可以直接导入使用

// You must import in each files when you wants use `format_t!` macro.
use i18n_again::format_t;

i18n_again::i18n!("locales");

fn main() {
    println!("{}", format_t!("hello"));
}

请确保所有YAML文件（包含本地化映射）都位于项目根目录的locales/文件夹中

.
├── Cargo.lock
├── Cargo.toml
├── locales
│   ├── en.yml
│   ├── zh-CN.yml
│   └── zh-HK.yml
└── src
    └── main.rs

在YAML文件中，指定本地化键及其对应值，例如，在en.yml

en: # The language code of this mapping file
  hello: Hello world # A simple key -> value mapping
  messages:
    hello: Hello, %{name} # A nested key.sub_key -> value mapping, in this case "messages.hello" maps to "Hello, %{name}"

以下是zh-CN.yml的示例

zh-CN:
  hello: 你好世界
  messages:
    hello: 你好, %{name}

Rust中加载本地化字符串

从当前包导入 format_t! 宏到您的当前作用域

use i18n_again::format_t;

然后，在需要本地化字符串的地方简单地使用它

format_t!("hello");
// => "Hello world"

format_t!("hello", locale = "zh-CN");
// => "你好世界"

format_t!("messages.hello", name = "world");
// => "Hello, world"

format_t!("messages.hello", locale = "zh-CN", name = "Jason");
// => "你好, Jason"

设置和获取全局区域设置

您可以使用 i18n_again::set_locale 在运行时设置全局区域设置，这样您就不必在每个 format_t! 调用中指定区域设置。

i18n_again::set_locale("zh-CN");

let locale = i18n_again::locale();
assert_eq!(locale, "zh-CN");

提取未翻译的文本

Rust I18n 提供了一个 i18n 二进制文件，帮助您从源代码中提取未翻译的文本，然后写入 YAML 文件。

$ cargo install i18n-again
# Now you have `cargo i18n` command

之后，未翻译的文本将被提取并保存到 locales/TODO.en.yml 文件中。

您还可以使用 --locale 选项指定特定的区域设置

$ cd your_project_root_directory
$ cargo i18n

Checking [en] and generating untranslated texts...
Found 1 new texts need to translate.
----------------------------------------
Writing to TODO.en.yml

Checking [fr] and generating untranslated texts...
Found 11 new texts need to translate.
----------------------------------------
Writing to TODO.fr.yml

Checking [zh-CN] and generating untranslated texts...
All thing done.

Checking [zh-HK] and generating untranslated texts...
Found 11 new texts need to translate.
----------------------------------------
Writing to TODO.zh-HK.yml

运行 cargo i18n -h 查看详细信息。

$ cargo i18n -h
cargo-i18n 0.5.0
---------------------------------------
Rust I18n command for help you simply to extract all untranslated texts from soruce code.

It will iter all Rust files in and extract all untranslated texts that used `format_t!` macro.
And then generate a YAML file and merge for existing texts.

https://github.com/drahnr/i18n-again

USAGE:
    cargo i18n [OPTIONS] [--] [source]

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

ARGS:
    <source>    Path of your Rust crate root [default: ./]

调试代码生成过程

当在编译时生成代码时，可以使用 RUST_I18N_DEBUG 环境变量来打印一些调试信息。

$ RUST_I18N_DEBUG=1 cargo build