跳转到主要内容

框架集成

i18n-rosetta 与主流框架的逐步设置指南。

Hugo (TOML / YAML / Markdown)​

项目结构​

Hugo 使用 i18n/ 进行字符串翻译，使用 content/ 管理页面内容：

my-hugo-site/
├── i18n/
│   ├── en.toml             ← source of truth
│   ├── fr.toml
│   └── ja.toml
├── content/
│   ├── posts/
│   │   ├── hello.md        ← source (English)
│   │   ├── hello.fr.md
│   │   └── hello.ja.md
│   └── about.md
└── .env.local

设置​

npm install --save-dev i18n-rosetta
i18n-rosetta.config.json
{
  "version": 3,
  "inputLocale": "en",
  "localesDir": "./i18n",
  "contentDir": "./content",
  "format": "auto",
  "languages": ["fr", "de", "ja", "es", "ko", "zh"]
}
i18n-rosetta sync           # sync i18n string files + content files
i18n-rosetta sync --dry     # preview changes without writing

内容翻译详情​

Front matter：支持 YAML (---) 和 TOML (+++) 分隔符。默认翻译 title、description、summary、subtitle、caption 和 linkTitle。所有其他字段（date、draft、tags、weight、slug 等）将保持不变。你可以在配置中使用 translatableFields 进行自定义。

块保护：代码块、Hugo shortcodes、内联代码和原生 HTML 会使用 Unicode 占位符自动进行保护。它们会原样保留，不被修改。

文件名约定：遵循 Hugo 的按文件名翻译模式：

  • my-post.md → my-post.fr.md
  • my-post.en.md → my-post.fr.md（去除源语言后缀）

跳过已有文件：现有的已翻译文件绝不会被覆盖。如需强制重新翻译，请删除目标文件。

复数形式​

TOML 和 YAML 语言环境支持 CLDR 复数形式：

[items]
one = "{{ .Count }} item"
other = "{{ .Count }} items"

在内部表示为 items.one 和 items.other 以便进行差异比较，然后在写入时重新序列化为正确的分段格式。