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

本集结果
完成这一集后,工作区中应该有:
- 一项位于
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 次阅读分享:
访客身份
还没有评论