此插件即将被弃用，取而代之的是实验性的 Doc Categories 插件。我们将继续支持 Docs 插件，直到新插件不再被视为实验性为止。
|||
-|-|-|
| 摘要 | Discourse Docs 提供查找和筛选知识库主题的功能
| 仓库链接 | https://github.com/discourse/discourse-docs
| 安装指南 | 如何在 Discourse 中安装插件
功能
Discourse Docs 插件是一个强大的工具，可将您的 Discourse 论坛转变为社区驱动的知识库。它提供了一个专用的 Docs 部分，用户可以在其中创建、更新和整理文档。此插件包含一个 Docs 按钮，方便用户访问该部分。这是利用社区集体智慧并为重要信息提供集中资源的绝佳方式。
本质上，Docs 允许在定义的一组类别和/或标签中更轻松地展示知识库风格的帖子。
通过标签筛选列表，通过搜索栏搜索，并点击帖子查看第一楼——所有操作均无需离开知识库浏览器的上下文。
需要从 Discourse 的其他位置查找知识库帖子？使用新的搜索助手：in:kb。
配置
-
通过开启
docs enabled设置来启用插件。 -
在
docs categories和docs tags设置中添加类别和标签。 -
在导航菜单中找到 Docs 链接。
- 通过更便捷的知识访问获取收益！
设置
| 名称 | 描述 |
|---|---|
| docs enabled | 启用 Docs 插件 |
| docs categories | 包含在 docs 中的类别 slug 列表 |
| show tags by group | 使用标签组组织标签。创建组对相关的标签进行分类。 |
| docs tag groups | 用于按组显示标签的标签组 |
| docs tags | 包含在 docs 中的标签列表 |
| docs add solved filter | 添加已解决帖子的过滤器——需要安装并启用 Discourse Solved |
| docs add to top menu | 在顶部菜单中添加链接以导航到 Docs 视图 |
| docs add search menu tip | 在搜索菜单随机提示中添加 “in:docs” 提示 |
推荐搭配
重命名 /docs 路径
如果您有服务器访问权限，可以通过在 app.yml 中添加 DISCOURSE_DOCS_PATH: 环境变量来更改 /docs 链接的路径：
要使更改生效，您可以运行 ./launcher rebuild app，或者由于它是环境变量，您可以运行 ./launcher destroy app && ./launcher start app 以尽量减少停机时间。这里有一些更多信息 - Set Environmental Variables
您可能还需要更改站点显示文本以保持一致。您可以在 /admin/customize/site_texts 页面搜索所有包含 ‘docs’ 的实例，但主要的包括：
- js.docs.title
- js.sidebar.docs_link_text
/docs路径仅在我们的企业计划中可用。如果您想了解更多信息，请联系我们。
开发历史
Docs 插件是 Knowledge Explorer 主题组件 的延续。