用 Obsidian 和 Hugo 搭建人工审核的双语发布流水线

Wed, 22 Jul 2026 00:18:29 +0800

在用 Obsidian、Hugo 和 GitHub Pages 搭建从私有笔记到公开网站的发布流水线一文中，我介绍了如何划清边界，将私有仓库与公开网站分开。

那套方案解决了文章应该存放在哪里，却留下了另一个问题：同一篇文章需要以两种语言发布时，该怎么办？

起初，我以为双语发布无非是翻译：把 Markdown 交给模型，让它生成中文或英文，再将结果保存在原文旁边。真正动手后我才发现，翻译反而是整个问题中最简单的一环。

真正棘手的是一系列架构问题：

哪个版本才是唯一可信的原文？
改写正文时，怎样确保代码块、链接、图片和 Hugo 元数据完好无损？
一项耗时很长的任务究竟仍在运行、已经失败，还是根本没有启动，我该如何判断？
生成的草稿由谁决定能否进入公开网站？

我最终搭建的系统没有把本地化做成一个翻译按钮，而是将它纳入一条受控的发布流水线。

核心规则很简单：

文章在 Obsidian 中写作，发布工具的代码在 Hugo 仓库中维护。生成的草稿未经人工批准，一律不得进入网站。

原文始终是唯一可信版本链接到标题

一篇文章可以先用英文写，也可以先用简体中文写。发布工具会识别原文语言，再生成另一种语言的版本：

英文原文 -> 中文本地化版本
中文原文 -> 英文本地化版本

最初的 Obsidian 笔记始终是权威原文。本地化文章只是从中生成的派生版本，不是另一份需要独立维护的原稿。

这一点很重要。两份都能独立编辑的原稿很快就会出现偏差：日期可能只在英文文章中得到修正，中文文章却没有同步；重写后的结论可能只出现在一种语言中，另一种语言仍沿用早先的论证。一旦把两个文件都视为原稿，之后的每次修改都会变成一道同步难题。

原始笔记只需声明允许自己进入发布流水线：

publish: true

系列文章还需要记录阅读顺序：

series: Remote Agent Workflow
seriesOrder: 2

系统只根据 seriesOrder 选择系列中的下一篇文章，绝不随机挑选。这看似只是一条不起眼的操作规则，却能避免自动化系统将内容本身没有问题的文章按错误的叙事顺序发布。

为什么一次翻译远远不够链接到标题

如果要求一个提示词一次完成所有工作，它承担的任务就太多了：既要理解论证，又要用自然的目标语言写作，还要保留所有事实，并确保 Markdown 毫发无损。这些要求混在一起，产出的文章即使流畅，也可能出错；即使忠实，也可能满是翻译腔。

因此，我把整个过程拆成四个阶段。

0. 理解文章链接到标题

第一轮不做翻译，只提取文章的核心主张、目标读者、推理链、事实、术语、语气和结构元素。

用 Obsidian、Hugo 和 GitHub Pages 搭建从私密笔记到公开网站的发布流程

Tue, 21 Jul 2026 09:11:29 +0800

最近，我重新搭建了个人网站。出发点很简单：

继续把 Obsidian 作为私密内容的唯一可信来源，只从中挑选适合公开的笔记，发布到一个干净的个人网站上。

这篇文章与其说是 Hugo 教程，不如说是在讨论一个问题：私密知识库与公开网站之间的发布边界，究竟该怎么划定。

下面记录的是我最终采用的架构、做过的取舍，以及实际的发布流程。

文中的仓库名、URL 和网站页面都来自我自己的配置。如果你也想采用这套方案，请换成自己的 GitHub 用户名、仓库名、域名和导航结构。

最终，我搭出了一条从私密内容通往公开网站的发布管线：

它实现了这些效果：

我仍然可以在 Obsidian 里自由地写笔记。
私密目录结构永远不会暴露在公开网站上。
公开笔记可以用一条命令发布。
GitHub Pages 会自动完成部署。

为什么我没有直接从 Obsidian 发布链接到标题

很多教程都建议直接发布 Obsidian 仓库里的内容。

但我没有这么做。

因为我的 Obsidian 仓库不只是写作空间，还是我的私密知识系统。

里面有这样的目录：

00-Inbox/
Projects/
Career/
内部笔记/
随想/

如果直接从仓库发布，就会带来边界问题：

私密目录结构会出现在公开 URL 中
内部笔记的组织方式会随之暴露
写作时还要顾及发布要求，反过来限制笔记的组织方式

比如这篇笔记：

00-Inbox/Kafka 设计.md

最终可能对应这样的公开路径：

/posts/00-inbox/kafka-design/

我不希望公开网站照搬自己梳理思路时使用的内部结构。

因此，我加了一层中间边界：Publish/。

这个目录是可公开内容的一份干净投影。

最终架构链接到标题

最终的架构将写作结构与发布结构分开了。

事实证明，这是整套方案中最关键的设计决定：私密仓库仍然可以围绕思考与整理来组织，公开网站接收到的则只有干净、适合发布的 Markdown。

第 1 步 — 创建 Hugo 网站链接到标题

先安装 Hugo。

Project on Armstrong Yan

用 Obsidian 和 Hugo 搭建人工审核的双语发布流水线

原文始终是唯一可信版本 链接到标题

为什么一次翻译远远不够 链接到标题

0. 理解文章 链接到标题