侧边栏控制

侧边栏是您的 Docsbook 文档站点的左侧导航面板：页面树，以及可选的搜索、面包屑导航、语言切换器和每页图标。此处的每项设置都是显示选项，不会消耗您的项目余额。

侧边栏设置#

如何配置侧边栏#

1. 打开您的文档站点。
2. Float Widget → 设计 → 左侧边栏选项卡。
3. 切换所需的选项。
4. 保存。

从页面编辑侧边栏#

以下大部分内容都可以完全不用打开设置面板进行更改。在文档站点上，点击工具栏中的编辑器，然后点击要更改的侧边栏条目。其上方会出现一个小型操作栏，提供以下选项：

• 重命名 — 更改侧边栏中显示的标签。
• 图标 — 选择一个图标、描述你想要的图标，或移除图标。
• 分析 — 询问读者实际如何使用该页面。

在此处重命名只会更改标签。页面地址保持不变，因此所有指向该页面的链接——无论来自你自己的文档、Google，还是其他人的博客——都能继续正常使用。如果你希望更改 URL 本身，请改为在代码仓库中重命名文件。

每个操作都会作为请求发送到 AI 聊天中，然后由 AI 应用该操作。你可以看到提出了什么请求以及进行了哪些更改，还可以在同一对话中说“撤销刚才的操作”。

侧边栏中的语言切换器#

侧边栏语言切换器是显示在左侧面板中的语言选择器，读者可以通过它切换翻译语言。

使用时机：当您的页眉已经拥挤，包含其他元素时启用此选项。

注意：请启用侧边栏切换器或页眉语言选择器，不要同时启用。将其显示在两个位置会造成重复。

至少需要启用一种翻译语言。在此之前，在您自己的网站上打开切换器会显示激活语言，并将您直接带到翻译设置。您的读者则会看到一条简单的未添加语言提示。 设置翻译 →

在侧边栏中搜索#

侧边栏搜索是显示在 Docsbook 网站左侧边栏面板中的搜索输入框。

这是页眉搜索按钮的替代方式。一些读者更喜欢侧边栏搜索，因为它不会遮挡页面内容。

了解更多搜索选项 →

面包屑#

面包屑以页面标题上方的路径形式显示当前页面在文档中的位置：

Home > Guides > Custom Domain

面包屑帮助大型文档网站的读者了解所在位置，并快速向上导航一级。

推荐：对于包含超过 20 个页面或多个嵌套部分的文档，请启用面包屑。

侧边栏图标#

在左侧边栏中的任意单独页面或文件夹旁添加图标，让读者可以通过视觉而不仅仅是标签来浏览树状结构。

配置方法

1. 打开您的文档站点。
2. 依次进入 Float Widget → 设计 → 左侧边栏选项卡。
3. 在侧边栏图标卡片中，搜索要标记的页面或文件夹，然后为其选择一个 lucide 图标（例如 rocket、book-open）。
4. 为其他页面或文件夹重复上述操作。
5. 保存。

选择器仅提供当前 lucide 图标集中的图标名称——按名称搜索（例如“rocket”“book”“folder”）可以缩小结果范围。一个图标分配仅适用于一个页面或一个文件夹；文件夹的图标需要与其中的页面分别分配。

使用时机：在较长或层级较深的侧边栏中，图标可以帮助读者一眼找到关键部分（入门指南、API 参考、常见问题）。对于只有少量顶级页面的小型文档站点，图标是可选的。

子标题文件夹#

子标题文件夹会将任何顶级存储库文件夹转换为子标题中的独立标签页——该标签行显示在文档页面的主标题下方。每个已启用的文件夹还可以在其标签页上显示一个 lucide 图标。

配置方法

1. 打开您的文档站点。
2. 依次点击 Float Widget → 设计 → 标题标签页。
3. 在子标题文件夹卡片中，打开您希望显示为子标题标签页的任意顶级文件夹。
4. 可选：点击已启用文件夹旁边的图标按钮，为其标签页选择一个 lucide 图标（或点击移除图标以清除已设置的图标）。
5. 保存。

显示在子标题中的文件夹也可以独立设置为从左侧边栏隐藏或保留；请参阅“子标题文件夹”旁边的文件夹可见性卡片以切换此设置。

有一个文件夹例外：开始使用始终保留在边栏中，其切换开关也处于锁定开启状态。读者如果提前关闭介绍页面，需要返回此处，因此隐藏它会让读者无法返回。

相关#

• 页眉布局和导航 — 顶部栏，以及语言切换器可以放置的另一个位置
• 搜索选项 — 侧边栏搜索框搜索的内容
• 翻译设置 — 切换器提供的语言
• 主题 — 浅色、深色、系统 — 主题切换器可以放置的另一个位置