Discourse 文档分类

5 个帖子已拆分到新主题:在侧边栏中高亮显示由索引中的 slug 标识的当前文档主题

使用文档分类 (Doc Categories) 后,当我查看该分类下的主题时,侧边栏导航中不再显示“管理”(admin) 链接,这是正常的吗?我觉得这很烦人,但我不知道是普遍问题还是我设置的问题。在我看来,“管理内容”的访问权限应该在网站管理员可以稳定访问的位置?

1 个赞

是的,这是正常的。常规侧边栏被“文档分类”侧边栏取代了。管理内容在一个固定的位置……一旦你返回:

1 个赞

好的——有没有办法自定义这个“文档分类”侧边栏?我非常喜欢文档列表,但像“我的帖子”之类的“常规”侧边栏内容突然消失了,这让人感到困惑,特别是当其余设计并没有真正改变时。我想,如果查看“文档分类”时整体外观有很大不同,就不会那么令人困惑了。我知道当我第一次来到 Meta 时,整个“文档”部分让我感到困惑,因此我避开它了一段时间 :face_with_peeking_eye:(我当时想:“天哪,我现在在哪里?”)。

3 个赞

一点 CSS 就可以给文档侧边栏一个不同的背景颜色——也许那会有帮助?

.discourse-docs-sidebar-panel {
background-color: darkmagenta;
}

5 个赞

这是一个好主意,谢谢!我将更仔细地研究 Discourse 页面布局的不同选择器。我想某处应该有参考资料。
我不记得之前是否问过这个问题,但有没有办法根据用户所属的组或 TL(信任等级)应用 CSS 规则?

3 个赞

我已将一个包含一些提示的主题分离出来:Finding CSS selectors for page layout, user groups

4 个赞

供日后参考:我刚刚按照所有说明进行了全新安装,但仍需按照“添加索引 → 保存索引 → 删除索引 → 重新添加索引”的步骤添加并删除索引文件,才能使“文档”类别正常显示。

或许可以在该插件的安装说明中,将上述操作或 Rake 任务作为注意事项添加进去。

4 个赞

嗨 :smiley:
这个插件运行得非常顺畅,非常感谢!:heart:
只是有一个小问题……它似乎“破坏”了帖子内超链接锚点的行为。
视图确实能从 A 跳转到 B,但页面并没有像往常一样平滑滚动,而是重新加载了(尽管定位到了正确的锚点位置)。

有什么办法可以修复这个问题吗?

有没有办法像分类卡片那样,在文档分类中以“卡片”形式显示主题?(例如,在 Google Drive 中选择“卡片视图”而非“列表视图”来查看文档)

为了使该插件与运行 v2026.1 长期支持版(Extended Support Release)的自建实例兼容,我应该使用哪个分支?我看到有针对 2026.5、2026.4、2026.3 和 2026.2 的 d-compat 分支。

感谢任何帮助!

该插件目前还不支持卡片视图。:smiley:

自定义主题组件可能可以实现这一功能,但据我所知,目前没有现成的开箱即用的解决方案。

自您的版本发布后,我们改用兼容性分支,但该插件在 .discourse-compatibility 文件中固定了一个提交哈希值:

2 个赞

我刚安装并启用了这个插件,但在分类的设置页面中完全看不到“文档模式”部分。它应该位于邮件设置下方吗?还是在其他位置?

我已经按照本线程中的说明运行了 db:migrate 和 rake 任务。

编辑: 找到了,果然需要重新运行 assets:precompile。

2 个赞

现在我已经成功运行了它,感觉还不错。不过现在我得在“索引主题”中的子类别、标签和版块之间做出选择,但总体来说这算是一个改进。

有计划把简单模式也带到移动端吗?

1 个赞

我想,你们应该不至于不愿意考虑让指向外部网站的链接在站内以框架(frame)的形式打开吧?这样我就不必把我之前在旧 xwiki 站点上创建的所有文档都重新搭建一遍了。

我添加一个链接后,它在侧边栏里显示得很正常,但一旦点击,当前页面就会被替换掉,想再看目录还得手动返回……

1 个赞

能否更具体地告诉我你的使用场景是什么?我开发了一个功能,它会在标签页上保留索引,这与你描述的情况非常相似。

目前的官方行为是仅在索引主题中显示侧边栏。我认为这对大多数应用来说已经足够了,但我们中的一些人觉得稍微扩展一下也挺有意思的。

1 个赞

你是什么意思?它在移动端应该能正常工作。

我想提供一个针对外部链接的选项可能也有道理。是指索引中的所有外部链接,还是针对每个单独的链接?

我不太清楚,但在我手机上,文档主题旁边仍然会显示头像之类的元素。而桌面端的简单模式则会去掉这些内容。

1 个赞

明白了。我以为你指的是默认不隐藏帖子。

我刚才在想,如果外部链接存在于索引页面中,那么它应该指向与该索引相关的文档,因此应该在它所属站点的上下文中进行解析,而不是离开当前站点并加载一个全新的页面。

1 个赞