内容选项
内容选项是控制页面周围界面的 Docsbook 开关——包括导航和操作控件,而不是页面文字。所有选项都位于同一个选项卡中,并应用于网站上的每个页面。
想要更改内容本身的呈现方式——卡片、折叠面板、步骤、行动号召区块?这些属于内容小部件,需要写在 Markdown 中,而不是在此处切换。
每个选项的作用#
| 设置 | 作用 |
|---|---|
| 返回顶部按钮 | 将读者返回页面顶部的浮动按钮 |
| 上一页/下一页按钮 | 每个页面底部的导航箭头 |
| 面包屑 | 显示在页面标题上方的面包屑导航 |
| 询问 AI 按钮 | 显示在页面上的聊天按钮(所有者还会获得编辑器) |
| 大纲中的询问 AI | 显示在右侧目录面板中的 AI 按钮 |
| 复制页面菜单项 | 用于“复制页面”下拉菜单的七个独立开关 |
更改内容选项#
- 登录后打开您的文档网站。
- 打开 Float Widget → 设计 → 内容选项卡。
- 切换所需的选项。
- 点击保存。
滚动到顶部#
读者向下滚动后会出现一个小型浮动箭头。单击一次即可返回页面顶部。
对于较长的参考页面、API 表格,或任何高度超过一个屏幕的页面,请启用此功能。
上一个 / 下一个按钮#
在每个页面底部添加← 上一个和下一个 →箭头,链接到侧边栏顺序中的相邻页面。
对于按顺序阅读的文档(例如教程系列),请启用此功能。对于参考文档,请将其关闭,因为每个页面都是单独查阅的,而箭头会暗示一个并不存在的顺序。
面包屑导航#
显示当前页面的位置,作为标题上方的路径:
Home > Guides > Custom domain面包屑导航读取与侧边栏相同的文件夹结构,因此无需配置即可遵循存储库布局。有关相关导航控件,请参阅侧边栏设置。
复制页面菜单#
关闭任意项目,即可将下拉菜单精简为所需项目。当所有项目都关闭后,下拉菜单的 V 形箭头会消失,因为没有可打开的内容了。有关每个项目向读者提供的内容,请参阅“复制页面”下拉菜单。
询问 AI 按钮#
在页面上显示 AI 控件。需要启用 AI 代理。
在页面上,它会在内容上方的操作行中显示为一个询问 AI按钮,位于复制页面旁边。按下该按钮会在页面底部打开问题框,并自动针对当前正在阅读的页面;再次按下则会收起问题框。
你可以在两个位置显示它:
- 页面上的内容上方操作行中
- 右侧大纲面板中,位于目录旁边
这两个位置可以同时启用。与此选项卡中的其他选项不同,此选项会产生费用:助手生成的每个回答都会从项目余额中扣费,而按钮本身在读者提问之前不会产生任何费用。
后续步骤#
- 内容小部件 — 介绍直接在 Markdown 中编写的区块。
- 复制页面和复制 Markdown 按钮 — 说明“复制页面”下拉菜单会提供给读者的内容。
- 侧边栏设置 — 这些控件所在的导航树。