页面树与内容块

奥宏文档的内容由两层结构组成:页面树负责组织目录,内容块负责承载具体内容。

页面树

一个项目的所有页面组成一棵树,支持多级嵌套。你可以这样管理它:

  • 在编辑器左侧的目录区,点「+」添加子页面或同级页面
  • 按住页面名称拖拽,可以调整层级和排序
  • 把一个页面拖到另一个页面下方,它就成了对方的子页面
  • 页面可以设为「分组」,分组只作为目录节点,不渲染正文

每个页面也有自己的 UID,它决定这个页面在阅读链接里的地址。

六种内容块

页面内部由若干个内容块从上到下排列,你可以在以下六种类型里挑选:

类型 适合写什么
Markdown 普通图文内容,最常用
代码 带语法高亮的代码段,支持文件下载
脑图 思维导图,梳理知识结构
BPMN 流程图 业务流程、工作流图
HTML 自定义网页内容,灵活度最高
iframe 嵌入第三方页面或在线工具

如何添加内容块

  1. 打开某个页面
  2. 在已有内容块之间或最下方,点「+ 添加内容块」
  3. 选择块类型,输入内容
  4. 保存后内容块立即生效

内容块之间可以拖拽调换顺序,也可以单独为某个块设置语言版本。

分组页面

如果某个页面只想当目录分类用,不写正文,可以在页面设置里勾选「作为分组」。分组页面在阅读视图里只展示它的子页面,自己不渲染内容块。适合用来给一大堆子页面做归类。

页面 UID 与阅读链接

页面的 UID 直接拼在阅读链接里。比如页面 UID 是 getting-started,那它的链接大概长这样:

/read/username/project-uid/getting-started/zh-cn/1.html

给页面起一个有意义的 UID,链接更好记,也方便分享给别人。

原文标题:页面和内容块

原文文档:奥宏文档

原文地址:/read/augushong/ulthon-document/zh-cn/1.0.0/quick-start/pages-and-blocks.html

原文平台:奥宏文档

1.0.0