Insights

官网发布文章SOP

三、 正文撰写规范

  1. 一级标题 (#)：解析器会自动识别第一个 # 标题 作为正文起始点。
  • 注：前端页面会自动隐藏 Markdown 里的第一个 H1，避免与页面大标题重复。
  1. 二级标题 (##)：用于文章小节，已在官网完成样式优化，自带美观的间距。
  2. 图片与链接：直接在 Outline 中插入即可，系统会自动同步。

四、 发布与更新流程

  1. 初次发布：在"官网发布"集合中新建文档 -> 填写元数据 -> 点击 Outline 的 Save 或 Publish。
  2. 更新内容：直接修改文档内容 -> 点击 Save。
  • 系统会在 5-10 秒内自动完成：解析内容 -> 更新数据库 -> 刷新官网页面缓存。
  1. 下线文章：
  • 方式一：将元数据中的 published 改为 false 并保存。
  • 方式二：将文章移出"官网发布"集合。

五、 如何验收

发布成功后，您可以从两个入口检查：

  1. 文章列表页：访问 <https://www.jitianbio.com/zh/cases> (<https://www.jitianbio.com/zh/cases>)，在下方的"最新洞察"列表中查看。
  2. ## 文章详情页：访问 [https://www.jitianbio.com/zh/insights/\[您的slug\]。](https://www.jitianbio.com/zh/insights/%5B%E6%82%A8%E7%9A%84slug%5D%E3%80%82)

六、 常见问题排除

  • 官网没出现文章？
  • 检查 published 是否拼写正确且值为 true。
  • 检查 slug 是否唯一，且没有特殊字符（仅限英文字母、数字和连字符 -）。
  • 内容还是旧的？
  • 通常是缓存延迟，请在 Outline 里随便改一个字并再次点击 Save，强制触发重新验证。
  • API 状态检查：
  • 访问 <https://api.jitianbio.com/health> (<https://api.jitianbio.com/health>) 确认 outline 状态为 ok。

---