Baklib AI 助手

Docs

模板名称：Docs

Wiki 类文档主题，将知识库呈现为结构清晰的产品文档站，支持侧栏导航、页内目录、全站搜索与 AI 问答侧栏，适合产品手册与操作指南。
属性 值
模板类型 Wiki
当前版本 1.2.1
开源地址 github.com/baklib-templates/docs

功能要点

Docs 是 Wiki 类应用模板：创建应用时需绑定知识库，文档在知识库中编写与维护，前台自动同步展示。
前台主要能力包括：
  • 三套首页布局：经典布局、树形文档布局、卡片文档布局，可按品牌风格切换；后台配置可在变体间迁移。
  • 文档正文页：侧栏目录、页内大纲、搜索弹窗、页面反馈与分享到 AI 助手等阅读工具。
  • AI 与搜索：AI 问答侧栏、热门搜索关键词、可配置 AI 回答结束语。
  • 多语言：支持中文简体、繁体及多种外语前台文案。
  • 界面定制：Logo、页头页脚、自定义导航与统计代码等。

截图预览

首页（经典） 封面（缩略图）
index.png cover.png
树形首页 文档页（含 AI）
index-tree.png page-ai.png

安装与配置

安装

在 Baklib 工作台进入应用库，打开应用市场，找到 Docs 模板，点击安装，按向导填写应用名称与访问域名即可完成创建。详细入口说明见 创建您的第一个应用。

安装后配置

安装完成后，建议在应用后台完成以下基础设置：
  1. 绑定知识库：创建向导中选择或新建知识库，作为文档内容来源。
  2. 首页样式：在站点设置中将首页切换为经典、树形或卡片布局之一；可按需填写主标题、热门搜索与快速指引。
  3. 界面与品牌：上传 Logo，配置页头页脚与 AI 助手相关文案。
  4. 导航与统计（可选）：在自定义代码区域添加顶部导航链接或访问统计代码。
预期结果：前台呈现所选首页布局，知识库文档可通过侧栏与搜索访问，AI 问答侧栏可用。

操作注意事项

💡
Wiki 与 CMS 的区别：Docs 属于 Wiki 模板，必须绑定知识库。文档在知识库中编辑，不在应用后台的页面管理中单独维护正文。
  • 首页变体：经典布局适合产品文档默认场景；树形布局突出层级导航；卡片布局集成侧栏搜索与全站导航。
  • 快速指引：子页面可勾选「显示在首页快速指引」，引导读者从首页直达常用章节。
  • AI 侧栏：需在组织已开通 AI 能力的前提下使用；可在主题设置中调整助手名称与结束语。
  • 多语言：切换站点语言后，前台文案随语言包变化；知识库正文需自行维护对应语言版本。

最佳实践

  1. 知识库结构：按产品模块或用户旅程划分一级目录，控制单页篇幅，便于侧栏浏览。
  2. 首页选型：对外产品文档推荐经典或树形首页；需要强搜索入口时选卡片首页。
  3. 热门搜索：配置 5～8 个读者常搜问题，降低首次访问门槛。
  4. 页内目录：长文启用页内大纲，配合侧栏目录形成双层导航。
  5. 反馈收集：对关键文档页开启读者反馈，便于持续改进内容质量。

案例实践

Demo 站点
真实案例
Baklib Docs.png
Baklib 文档中心
[https://www.baklib.com/docs][2]{: bke-link-type=”external”}
Boox Docs.png
Boox Help Center
[https://help.boox.com/][3]{: bke-link-type=”external”}

常见问题

Q：Docs 模板需要绑定知识库吗？
A：需要。Docs 是 Wiki 类模板，创建应用时必须选择知识库；文档在知识库中编写，前台自动同步。
Q：三种首页布局怎么选？
A：经典布局带渐变首屏与入门卡片；树形布局强调文档层级；卡片布局侧栏集成 Logo 与全站导航。在站点首页模板设置中切换即可。
Q：AI 问答侧栏不显示怎么办？
A：请确认组织已开通 AI 能力，并在主题设置中检查 AI 相关开关与文案配置。
Q：Docs 和 Help 模板有什么区别？
A：Docs 侧重产品文档与 API 指南式阅读体验；Help 侧重客户自助与 FAQ、支持站等帮助中心场景，首页样式更偏支持门户。

相关阅读