自定义文档插件文本链接

支持
1

您好 Discourse 社区，
我启用了 discourse-docs 插件并将其添加到顶部菜单。默认情况下，它的链接是例如 www.example.com/docs，如何将其更改为类似 www.example.com/my-docs？

2

您好 Hyan :wave:

这是不可能的。这部分 URL 是硬编码在这里的：

没有设置可以更改它。

**编辑：**但是您可以在您的 app.yml 中使用环境变量来更改它。请参阅 @RGJ 下面的帖子。

3

谢谢，@Canapin。我确实看到有些站点的文档链接是自定义的。也许他们以某种方式修改了代码。可能出于某些原因，不将配置暴露给管理员仪表板。

4

可以分享一下吗？

5

我了解到网站是通过代码更改进行定制的。我认为如果我想尝试这样做，只需要更改一行代码。将答案标记为已解决。:grinning:

6

该设置的整个理念是使其可配置。唯一硬编码的是默认值。

您可以在 app.yml 中设置 DISCOURSE_DOCS_PATH 来更改它。

7

我已在文档中添加了一个部分 :+1: https://meta.discourse.org/t/discourse-docs-documentation-management/130172#renaming-the-docs-path-5

8

哦。非常感谢您告知我这些环境变量。@RGJ 我还有一个关于 Discourse 或 Rails 框架如何工作的问题。我假设如果 Discourse 或其插件的运行行为可以通过环境变量更改，那么在其相关代码中一定提到了相同的环境变量名称。在这种情况下，DISCOURSE_DOCS_PATH 应该出现在 GitHub - discourse/discourse-docs 的代码中，但我没有找到任何相关代码。它是如何工作的？

9

简而言之，环境变量 DISCOURSE_XYZ 在代码中可作为 GlobalSettings.xyz 或 SiteSettings.xyz 使用。

在此特定情况下，您可以在此处找到 GlobalSettings.docs_path。

10

感谢 @RGJ，了解 Discourse 中的环境设置名称如何映射配置。