文档是可以保存的 Markdown 笔记，能够关联到任意数量的客户与项目、添加标签，并导出为 PDF。每次更改内容时，先前的版本都会自动归档，以便回顾或还原它——请参阅文档版本。
你可以做什么
在文档页面通过文本搜索与标签筛选浏览所有文档，并可随时创建新文档。打开某个文档即可阅读其完整内容，然后使用其中的操作来编辑它、查看其版本历史、导出为 PDF 或删除它。
每个文档都会获得一个形如 D-7 的 ID。你可以在常规设置中更改字母前缀。
你要填写的字段
- 名称 — 必填，文档标题。
- 内容 — 必填的 Markdown 文本。
- 说明 — 选填的摘要，显示在详情页面内容上方。
- 客户 — 选填的关联；文档随即会出现在每个已关联客户的相关文档中。
- 项目 — 选填的关联；文档会出现在每个已关联项目的相关文档中。
- 标签 — 选填，与其余标签共用。
在编辑器中撰写
编辑器有两种模式：所见即所得的富文本编辑器（默认）与原始 Markdown 文本框。使用编辑器工具栏中的切换开关在两者之间切换——以可视化方式撰写，或在需要时切换到 Markdown 源代码。无论哪种方式，内容都以 Markdown 保存。没有斜杠命令、嵌入媒体或图片上传。内容为必填；其余均为选填。
列表
文档列表显示 ID、名称（以说明作为副标题）、客户、项目、标签与最后更新日期。客户与项目列会将每个已关联实体列为可点击链接，当数量超过可容纳范围时会以“+N”溢出呈现。你可以跨名称、说明与内容搜索，并按标签筛选（文档必须带有你所选的所有标签）。可选择每页 50、100 或 200 个文档。
列表不直接提供客户或项目筛选——若要查看某个特定客户或项目的文档，请打开该客户或项目并使用其相关文档列表。
详情页面
文档的详情页面显示标题、说明、所有已关联客户与项目的可点击名称、标签、最后更新时间与完整内容。PDF 导出区域会列出你已生成的所有 PDF。在此你可以编辑、查看历史、删除或关闭。
工作流程
创建文档
- 打开新文档表单。
- 输入名称并以 Markdown 撰写内容。
- 可选择关联一个或多个客户与项目，并添加标签。
- 保存。文档会获得下一个 ID。
更新文档
使用编辑，进行更改后保存。若内容确实发生更改，先前的版本会在新内容取而代之之前被归档。仅编辑名称、说明、客户、项目或标签不会创建新版本。
导出为 PDF
使用详情页面上的导出 PDF操作。每次导出都会捕获文档在当下的原貌——名称、内容、标签与已关联的客户／项目——因此日后的编辑绝不会改变过去的导出。导出区域会列出每个 PDF 及其大小与日期；可单独下载或删除它们。PDF 包含生成当下的文档文本；不包含任何版本历史。
它如何与 Ceum 的其余部分关联
- 客户与项目 — 文档可关联到任意数量的客户与项目（皆为选填）。它会出现在每个已关联客户与项目的相关文档中。若你删除其中一个客户或项目，文档会保留——只是失去那一个关联。
- 标签 — 与 Ceum 各处的标签系统共用。
- 历史 — 文档编辑通过版本快照追踪，而非常规的实体变更日志；请参阅文档版本。
提示与边界情况
- 删除是永久性的。 移除文档也会移除其版本历史与已导出的 PDF——没有回收站。
- 文档以 Markdown 保存。 你可以在富文本模式下以可视化方式编辑，或在原始 Markdown 中编辑，但没有嵌入媒体，也没有独立的图片上传。
- 版本控制仅在内容更改时执行。 重命名、重新加标签或重新关联文档不会创建版本快照。
- 没有字段级的变更日志。 对文档而言，版本时间轴就是历史界面——没有“谁更改了什么”的审计记录。
在移动设备上
- 在原生底部弹出表单中创建与编辑文档；离线时的编辑会排入队列并在重新连接时发送——请参阅离线支持。
- 你可以阅读文档并将其导出为 PDF（通过原生分享面板分享），但版本历史与还原仅限网页版。