文件名约定

标记内容语言有两种方式：

content/posts/foo.md          # 默认语言
content/posts/foo.zh-cn.md    # 中文版本
content/posts/foo.en.md       # 默认是 zh-cn 时显式标注英文

或者用目录划分：

content/en/posts/foo.md
content/zh-cn/posts/foo.md

主题对两种都兼容，按你的写作流程选一个即可。

语言切换

页眉有一个语言切换按钮。当前页有翻译时，按钮指向对应语言的同一篇；没有翻译时回退到目标语言的首页——不会出现死链或占位页。

i18n 字符串

UI 字符串放在 i18n/<lang>.toml。主题自带 en.toml 和 zh-cn.toml。要新增一种语言：

cp themes/inkstone/i18n/en.toml i18n/ja.toml
# 然后翻译里面的值

在站点配置里加上这一语言：

[languages.ja]
  label = "日本語"
  locale = "ja"
  weight = 3
  [languages.ja.params]
    description = "..."

阅读时间

阅读时间按页面的实际语言计算，用 Hugo 的 WordCount 与 ReadingTime。设了 hasCJKLanguage = true 之后，CJK 页面按 501 字符/分钟报，非 CJK 页面按 213 词/分钟报。主题读取页面真实语言并自动选公式。

这就是多语言模型的全部要点。底层模式见 Hugo 的 language management 文档↗ 。

1. 自动开启 hasCJKLanguage = true，让 .WordCount 按字符数（而不是空白分隔的 token 数）计算
2. .ReadingTime 用 Hugo 的 CJK 常量 501 char/min（而不是 213 word/min）
3. 字体栈优先 LXGW WenKai，回落到 Noto Serif SC 与系统衬线字体
4. 行高为 1.7（而不是英文的 1.6），适配中文字符更高的 baseline

长段落示例

读到一篇好文章，往往是从某个准确的句子开始的。比如博尔赫斯写的「我的脚踩到了你正在踩着的影子」——这里包含了一种几乎没有重量的存在论。把这种存在论翻译成 English 是困难的，因为英语的语序天然倾向 SVO，而中文允许把「踩到了」这个动作压缩到主谓之间，让影子的"被踩"瞬间放大。

混排时常见的问题：英文单词与中文字符之间没有空格时，浏览器有时会粘连。Inkstone 在 prose 区域加了 font-feature-settings: "palt" 让标点收紧，并通过 text-spacing-trim 处理首尾空白。

引用

「书是人类进步的阶梯。」——高尔基

“Reading furnishes the mind only with materials of knowledge; it is thinking that makes what we read ours.” — John Locke

中英文引用混在同一篇文章里，typography 应该在两种风格之间无缝切换。

代码块

中文注释和英文代码混合：

def calculate_reading_time(content: str, lang: str = "zh-cn") -> int:
    """
    根据语言计算阅读时间。
    Hugo 的 CJK 常量是 501 字符/分钟，英文是 213 词/分钟。
    """
    if lang.startswith("zh"):
        return max(1, len(content) // 501)
    else:
        return max(1, len(content.split()) // 213)

排版小细节

• 标点压缩：句号、逗号、问号、感叹号在 CJK 区会自动收窄
• 数字与中文之间：自动加 0.15em 间距（Pangu 风格，但只在 prose 区生效，不影响 UI）
• 首字下沉：可选 class="dropcap" 给段落，但 demo 默认不开
• 斜体处理：CJK 字体不支持斜体，主题在中文区域用 font-style: normal 回退，避免浏览器伪斜体

总结

如果你也写中英混排的长文，希望 Inkstone 的这些细节能让你少花一点心思在排版上，多花点在内容上。

标题

CJK 场景下，正文用 LXGW WenKai，回落到 Noto Serif SC 与系统衬线字体。标题默认继承同一字族，但可以通过 assets/css/variable.css 里的设计 token 按项目重新调整。

三级标题

读到一篇好文章，往往是从准确的句子开始的。一段克制而精确的描述比花哨的修辞更接近写作的核心，长文的节奏也由这些细小的判断累积而成。

四级标题

排版的目标不是让页面好看，而是让阅读不需要解释——读者翻开后立刻进入内容，意识不到字体、行高、间距的存在。

段间距

默认节奏是 1.6 倍行高，配合让一行 65–75 个字符的最大宽度。这是为桌面阅读调的；移动端会折叠为单列并调整间距。

中英混排的文本，主题会在原本基础上把行高再略微抬高，照顾中文字符更高的字身，同时不至于让纯英文段落显得过于稀松。

列表

无序列表：

• 第一项写一句有意义的话
• 第二项展示项目符号的视觉效果
• 第三项凑数
  • 嵌套项一
  • 嵌套项二

有序列表：

1. 数字列表用了略不同的节奏
2. 数字本身的颜色与正文风格一致
3. 嵌套有序列表也能正常工作：
   1. 缩进项一
   2. 缩进项二

行内元素

这一句里有 行内代码、粗体、斜体，以及一个 指向源码的链接↗ 。指向站外的链接会自动加上外链标记。

引用块

阅读对于头脑而言，正如锻炼之于身体。

——约瑟夫·艾迪生

代码块

def fibonacci(n: int) -> int:
    """经典的递归 fib——请不要在生产环境这样写。"""
    if n < 2:
        return n
    return fibonacci(n - 1) + fibonacci(n - 2)


if __name__ == "__main__":
    print([fibonacci(i) for i in range(10)])

const debounce = (fn, ms = 250) => {
  let t;
  return (...args) => {
    clearTimeout(t);
    t = setTimeout(() => fn(...args), ms);
  };
};

表格

引言（pullquote）

经典是这样一种作品——它永远没有把要说的话说完。 — 伊塔洛·卡尔维诺

差不多就是这些。完整的 shortcode 目录见 Shortcodes demo 。

为什么是 Inkstone？

Inkstone 围绕三条信念构建：

1. 阅读是首要场景。 每一个布局决策都为读者服务，不是作者的自我表达。
2. 双语是默认而非附加。 中英混排的内容会得到合适的行高、按字符数计算的阅读时间，以及不会用 CJK 字体渲染拉丁字符的字体回落链。
3. 渐进增强是底线。 搜索、灯箱、主题切换在禁用 JS 的环境下都能优雅降级。

内置 shortcodes

Inkstone 自带 25+ 内容 shortcodes，最常用的有：

• Callout 与 Admonition —— 五个严重程度（note、tip、warning、danger、success），标签会自动按 i18n 切换
• 画廊 —— 等高网格 + 灯箱，由 JSON 数据驱动
• 代码块 —— 用 Chroma 高亮，可选复制按钮和行号
• 图表 —— Mermaid、Markmap，按需通过 CDN 客户端渲染
• 数学公式 —— MathJax v4，只在用到的页面才加载

完整的 shortcode 参考与实时示例见 Shortcodes demo 页面 。

接下来

去 文章 区看更多示例，或直接跳到 Shortcodes demo 查阅完整参考。