跳到主要内容
系列文档 · 第 312 min

第 3 集 - 创建一篇有效的研究文章

正文

这一集把第 1 集选定的更新变成一篇私人文章。目标还不是 polished prose,而是一项系统可以解析、校验、索引并重新展示给你的有效内容。

创建 blog item、添加中文文件、校验内容源,并检查系统解析后的记录。

本集结果

完成这一集后,工作区中应该有:

  • 一项位于 content/resources/blog/new-research-result/ 的 blog item;
  • 一个英文正文文件;
  • 可选的中文正文文件;
  • 包含新 item 的已同步索引;
  • 可以通过 silan blog show 查看解析结果。

写作过程中,这项内容应该继续保持私人状态。

一、创建文章 item

silan blog new new-research-result

命令会创建规范 item 目录:

content/resources/blog/new-research-result/

生成的文件会分开保存稳定 item 身份、part 元数据和语言正文:

item.toml
parts/body/meta.toml
parts/body/en.md

如果要准备中文版本:

silan blog add-lang new-research-result zh

这会新增:

parts/body/zh.md

两个文件都会保持私人,直到第 4 集发布 blog item。

二、写第一版有用内容

用任意编辑器打开生成的 Markdown 文件。先写 claim,不要先写项目历史:

## 新部署证据改变了时间线

新公开的档案把首次部署时间从 2019 年提前到了 2017 年。
这会改变哪家机构能够可信地声称首次公开使用。

### 证据

- 扫描报告:<link>
- 日期范围:<这份证据能证明什么>
- 不确定性:<它还不能证明什么>

### 下一步

我会先把这份来源和 release note 对齐,再修改项目页。

这已经足够作为第一版。风格可以之后再改。先把 claim、证据和不确定性写清楚。

三、先校验,再增加复杂度

silan content lint
silan index sync
silan blog show new-research-result

把这三个命令理解为 review pipeline:

  • lint 检查内容源;
  • sync 重建索引;
  • show 确认系统实际解析到了什么。

这些命令都不会发布文章。完全干净时会显示 ok - 0 lint issues;带示例内容的工作区可能有非致命提示。只要汇总以 0 fatal 结束,就可以继续。

四、需要时补充来路关系

如果文章来自一条 moment,或属于某个项目,可以连接这些记录:

silan relation link \
  /moments \
  /blog/new-research-result \
  --type evolved_into

这个 relation 记录来路,不会把同一段话复制到多个页面。第一次成功时可以先不做这一步;一篇有效的私人文章本身已经是有用里程碑。

常见错误

  • 不要编辑生成的数据库文件,只编辑 content/
  • 不要为了看 lint 是否通过就发布;
  • 不要从翻译所有旧文章开始;
  • 不要让 Agent 在没有可审阅提案的情况下改写公开 claim。

第 4 集会审阅文章、明确发布 item,并区分本地预览和生产部署。

0 次点赞
Silan Hu1 次阅读分享:
访客身份
G

还没有评论