我认为令人困惑和困难之处可能在于索引主题必须采用特定格式，而文档中并未完全清楚地说明这一点（置顶帖）。
我自己安装了这个插件，仔细遵循了说明，但它的工作方式与 @dennisjbr 遇到的情况完全不同。
提供所需 Markdown 的示例可能比链接到 Meta 示例更有帮助，因为唯一的关键规则是必须有一个 Markdown 项目符号/编号列表。文档说“一个列表”，但“列表”这个词有普通的英语用法，包括非 Markdown 列表！
这可以作为一个索引主题：
* https://meta.discourse.org/t/discourse-doc-categories/322376
* 任意文本：https://meta.discourse.org/t/discourse-doc-categories/322376
这行不通：
https://meta.discourse.org/t/discourse-doc-categories/322376
任意文本：https://meta.discourse.org/t/discourse-doc-categories/322376
除此之外，您还可以使用 Markdown 标题来创建部分并使用多个列表，但除非有 Markdown 列表，否则侧边栏中不会显示任何内容。我明白这有点显而易见，可能没有难倒其他人，但它确实让我感到困惑（无论是否愚蠢），而且我对 Discourse、TC 和插件并不陌生。
4 个赞
hugh
(Hugh Lashbrooke)
49
8 个赞
MarcP
(MarcP)
51
我为我的文档类别有一个 AI 角色。有没有人考虑过为匿名用户提供 AI 角色？我认为至少可以提供一个临时的、匿名的聊天私信？这有可能实现吗？
MarcP
(MarcP)
52
当您访问索引中非常靠下的页面（需要滚动才能到达）时，主页面也会向下滚动到中间的某个位置：例如，在此文档项上
2 个赞
hugh
(Hugh Lashbrooke)
53
感谢您指出这一点！我们将看看我们能做些什么来防止这种情况再次发生。
3 个赞
Heliosurge
(Dan DeMontmorency)
55
实际上，在记录任何内容时，永远不应认为某事是“显而易见的”。此类反馈对于任何类型的项目都至关重要，以确保清晰度。
作者写下的任何内容通常都会因为他们对所写内容的深刻理解而变得有意义。而对其他人来说，这可能不太清楚。
我自己不喜欢“直观”这样的术语，因为只有在使用过类似的东西后，某事才是直观的。
6 个赞
大家在这个插件上做得太棒了！
我是新手，提前道歉！我一直在自己摸索这个问题，但到处都找不到解决方案。
我正试图使用这个插件来在类别级别上组织个人用户项目。
我们正试图创建一个论坛，上面将有大量的用户项目。我们最初将它们都放在“项目”类别下，所以当有人点击项目时，他们会看到所有的子类别框，以漂亮的 UI 外观列出所有单独的项目（类似项目市场）。
但这样做，我们就失去了一个数据组织层级，因为单独的项目是以子类别而不是类别开始的。
当我找到这个插件时，我非常兴奋，因为我认为它非常适合在类别级别上组织所有项目，从而使我们在项目内拥有更好的数据组织。
所以，我现在将单独的项目创建为单独的类别（钓鱼饵、项目 2、项目 3），并使用文档类别插件来基本上创建所有项目的目录，这样人们就可以点击由文档类别插件运行的新项目类别，并使用下拉菜单导航到我们在索引主题中选择列出的子类别和主题。
有没有办法将类别显示在中间列，使其类似于正常 Discourse 提要中“所有类别”页面的视图？
我希望当我点击项目文档类别时，它能在左侧的菜单中列出所有项目，但同时也能像正常显示子类别一样在主提要中以框的形式显示它们。我在这篇帖子上只允许放一张图片，所以我放了左侧菜单中项目的图片，并且我希望在我的主题帖子显示的中间位置显示类别框。
提前感谢任何帮助和指导。
3 个赞
您能否添加“相对链接”，例如“/t/topic/463”，这对于在不费力的情况下更改“域名”将非常有效。
1 个赞
MarcP
(MarcP)
59
目前这并不是什么费力的事情。只需执行一次搜索和替换——你多久更换一次域名？
2 个赞
hugh
(Hugh Lashbrooke)
60
这听起来就像我们在 Meta 上为文档子类别所做的那样。
您可以在主视图中看到子类别，它们也链接在侧边栏中：Documentation - Discourse Meta
为了实现这一点，我们在父文档类别中添加了一个索引主题，其中包含指向每个子类别的链接：https://meta.discourse.org/t/documentation-index/315730。
这能帮助您在您的实例中找到一个好的解决方案吗？
3 个赞
Heliosurge
(Dan DeMontmorency)
61
由于相对链接已可用。为什么不添加它并消除任何不必要的繁琐工作？毕竟，这些是内部链接，并且这将有助于 Discourse 的功能与内部链接在各种 TC 和插件中同样可用。
1 个赞
谢谢休！你们在子类别方面所做的工作是正确的方向，但我主要想让用户界面在中间列的框中显示类别，就像它对子类别那样。
我最终找到了并安装了子子类别插件。所以现在我正在使用这个插件来帮助我组织子类别，因为它们下面有两个级别的数据分发：子子类别和主题，所以它们实际上充当了“类别”。这实现了我增加用户项目内数据分发和组织级别的主要目标。所以现在我正在使用子子类别以及该插件，以在存根类别级别上获得两全其美。
我曾试图仅使用鸭子类别插件来创建项目类别，但我们不喜欢只有左侧菜单而中间没有任何供用户浏览的内容的用户界面。所以，我想让（作为类别的项目）显示在“类别”（所有项目）中，就像子类别通常可以做的那样。（我上一篇文章中的模拟图）
这是项目的主要类别：BETA - 将有其他子类别
这是“子子类别”在起作用，将子类别变成类别。
以及索引主题的便捷导航。
再次感谢你们所做的一切。
希望我在这篇文章中说得更清楚一些。
我已经找到了一个我们非常满意的解决方案，它是两个插件的组合。
2 个赞
这个插件与旧版文档插件相比有什么优势？
在旧版插件中，只要我维护标签，文档就可以放在任何类别中。现在似乎所有的文档主题都必须放在一个类别下。这是正确的吗？在这种情况下，它会失去上下文，因为一些（现有的）文档可能特定于某些组/类别（例如，仅供员工使用）。
您能否澄清这两种方法的区别，您为什么选择这种方法，以及您打算如何弥合旧版插件与新插件之间的差距？
关于“callouts”的OT评论
HedgeDoc 使用以下 Markdown 扩展来支持 callouts（他们称之为 alert areas）：
### Alert Area
:::success
是的 :tada:
:::
:::info
这是一个消息 :mega:
:::
:::warning
注意 :zap:
:::
:::danger
哦不！ :fire:
:::
将显示
（如果给定一个类，用 CSS 样式化会非常容易）。
关于懒惰和人工智能的OT评论
你能想象一下，仅仅三行你可以手动复制粘贴的 Markdown 所消耗的过量能量和水吗？ 
关于相对 vs 绝对 URL 的OT评论
实际上，复制粘贴主题 URL 更容易，如果你更改域名，你可能会导出/导入主题，然后 Discourse 会为你替换域名。
经过一点实验，这是我的（临时）结论：
- 使用类别描述主题来提供文档索引很有用（例如，https://ps.zoethical.org/t/singular-docs/8350）
- 顶级文档类别允许使用子类别来更改文档侧边栏索引（例如，“安装 Ruby”出现在 Documentation - petites singularités 的“操作指南”下，但在 Sysadmin Docs - petites singularités 的“技巧与窍门”下），以提供良好的结构（参见此处的 Documentation，将子类别显示为框）
- 文档主题可以位于论坛的任何位置，包括私有空间——尽管文档索引会显示它们的存在
- 侧边栏目前不稳定：
- 有时显示 URL，有时显示标题
- 有时只显示前缀文本
- 登出时，可能会缺少一些索引主题
- 从旧版文档插件迁移时，必须在侧边栏的自定义部分重新创建文档链接（但可以通过更改插件设置中的 /docs 为文档类别来自动生成，或创建/更改 /docs 的固定链接以链接到该类别）
- “返回论坛”链接感觉很奇怪，因为文档主题仍然是论坛主题：我们仍然在那里阅读文档！
- 过滤功能尚未考虑到文档主题所属的（子）类别名称。
3 个赞
MarcP
(MarcP)
65
\n最新更新引入了一个小的UI bug，当出现滚动条时。\n\n
\n\n我还认为，如果这个“filter”搜索框默认只是当前类别的自定义搜索查询（而不是在没有结果时询问这个），它会更有效。标题很短，所以在大多数情况下，非熟悉的用户输入的内容不会有匹配项。\n\n
\n\n[quote="hellekin, post:64, topic:322376"]\n* “返回论坛”链接感觉很奇怪，因为文档主题仍然是论坛主题：我们仍然在那里阅读文档！\n[/quote]\n\n但是你失去了常规的“论坛”侧边栏，所以返回论坛在这里有点道理。
1 个赞
kakaroto
(Youness Alaoui)
66
花了些时间才弄清楚侧边栏没有出现是因为导航菜单的设置被设为了“页眉下拉菜单”而不是“侧边栏”。对于那些也无法显示侧边栏的人来说，这可能是原因所在。
现在我被卡住了，正在试图弄清楚如何添加我们在这里看到的类别标题和子类别框：
我看不到任何启用/禁用该功能的设置，而且不幸的是，它似乎就是不想出现。
如果有人有什么想法，我很感激。
谢谢。
1 个赞
按标签过滤功能的缺失大大降低了该插件的实用性。在一个文档可以应用于多个类别的社区中，按标签过滤至关重要。
例如，一个名为“起落架组件”的文档适用于多个飞机型号，并且可以包含多个标签。使用标签过滤可以轻松找到正确的文档。
如果您必须为文档选择一个类别，那么当同一文档也应属于其他几个类别时，您该怎么做？
标签曾经是自动索引，现在却必须手动创建和维护。
6 个赞
