床前明月光,
疑是地上霜。
举头望明月,
低头思故乡。

阅读说明

本文先给出诗文,再说明它在 Daybook 中如何与英文版本配对。诗句本身保持原样;后面的说明只介绍站点组织方式。

双语文章配对

这篇文章与英文版使用同一个:

i18n_key: thoughts-in-a-quiet-night

中文文件使用 lang: zh_CN,英文文件使用 lang: en_US。两份 Markdown 各自保存标题、摘要、标签和正文,Daybook 在构建时再把它们归入同一个文章组,因此读者可以在文章元数据中切换语言。

同一个 i18n_key 下,每种语言只能有一个版本。建议双语版本保持相同的发布日期,并为 listed 等影响文章可见性的字段采用一致设置。

完整字段说明见 文章 Frontmatter。如果文章只有一种语言,则不需要填写 i18n_key。

发布前检查

  • 同一个 i18n_key 下,每种语言只保留一个文件;
  • 双语版本的 date、listed 和 draft 保持一致;
  • 切换语言后,标题、摘要和正文都应指向对应语言的文件。