Personalizar link de texto do plugin de docs

Olá comunidade Discourse,
Habilitei o plugin discourse-docs e o adicionei ao menu superior. Por padrão, o link é, por exemplo, www.example.com/docs, como posso alterá-lo para algo como www.example.com/meus-docs?

Olá Hyan :wave:

Isso não é possível. Esta parte da URL está codificada aqui:\n\ndiscourse-docs/plugin.rb at main · discourse/discourse-docs · GitHub há configuração para alterar isso.\n\nEditar: Mas você pode alterá-la usando uma variável de ambiente em seu app.yml. Veja a postagem de @RGJ abaixo

1 curtida

Obrigado, @Canapin. Vejo que a documentação de alguns sites vincula de forma personalizada. Talvez eles modifiquem o código de alguma forma. Provavelmente há razões para não expor a configuração ao painel de administração.

Você pode compartilhá-los?

Fiquei sabendo que o site foi personalizado alterando o código. Pensei que apenas a linha de código precisaria ser alterada se eu tentasse fazer isso. Marque a resposta como resolvida. :grinning:

A ideia toda dessa configuração é torná-la configurável. A única coisa que está codificada é o valor padrão.

Você pode definir DISCOURSE_DOCS_PATH em seu app.yml para alterá-lo.

3 curtidas

Adicionei uma seção à documentação :+1: https://meta.discourse.org/t/discourse-docs-documentation-management/130172#renaming-the-docs-path-5

5 curtidas

Oh. Muito obrigado por me informar sobre essas variáveis de ambiente. @RGJ Tenho mais uma pergunta sobre como o Discourse ou o framework Rails funcionam. Presumo que, se o comportamento de execução do Discourse ou de seus plugins puder ser alterado por meio de uma variável de ambiente, então deve haver o mesmo nome de variável de ambiente mencionado em seu código relevante. Neste caso, DISCOURSE_DOCS_PATH deveria aparecer no código de GitHub - discourse/discourse-docs, mas não encontrei nenhum código relacionado. Como funciona?

Um resumo muito breve é que as variáveis de ambiente DISCOURSE_XYZ estão disponíveis no código como GlobalSettings.xyz ou SiteSettings.xyz.

Neste caso específico, você pode encontrar GlobalSettings.docs_path aqui.

2 curtidas

Obrigado, @RGJ. Saiba como os nomes das configurações de ambiente mapeiam a configuração no Discourse.

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.