Personalizar enlace de texto del plugin de docs

Soporte
1

Hola comunidad de Discourse,
Habilité el plugin discourse-docs y lo agregué al menú superior. Por defecto, su enlace es, por ejemplo, www.example.com/docs, ¿cómo puedo cambiarlo a algo como www.example.com/my-docs?

2

Hola Hyan :wave:

Esto no es posible. Esta parte de la URL está codificada aquí:\n\ndiscourse-docs/plugin.rb at main · discourse/discourse-docs · GitHub hay ninguna configuración para cambiar esto.\n\nEditar: Pero puedes cambiarlo usando una variable de entorno en tu app.yml. Consulta la publicación de @RGJ a continuación.

1 me gusta
3

Gracias, @Canapin. Veo que hay algunos sitios que enlazan a la documentación de forma personalizada. Quizás modificaron el código de alguna manera. Probablemente haya razones para no exponer la configuración en el panel de administración.

4

¿Puedes compartirlos?

5

Me enteré de que el sitio web se personalizó cambiando el código. Pensé que solo la línea de código necesitaba cambiarse si intentaba hacerlo. Marca la respuesta como resuelta. :grinning:

6

La idea principal de esa configuración es hacerla configurable. Lo único que está codificado de forma rígida es el valor predeterminado.

Puedes establecer DISCOURSE_DOCS_PATH en tu app.yml para cambiarlo.

3 Me gusta
7

He añadido una sección al documento :+1: https://meta.discourse.org/t/discourse-docs-documentation-management/130172#renaming-the-docs-path-5

5 Me gusta
8

Oh. Muchas gracias por informarme sobre estas variables de entorno. @RGJ Tengo una pregunta más sobre cómo funcionan los frameworks Discourse o Rails. Supongo que si el comportamiento de Discourse o sus plugins se puede cambiar a través de una variable de entorno, entonces debe haber el mismo nombre de variable de entorno mencionado en su código relevante. En este caso, DISCOURSE_DOCS_PATH debería aparecer en el código de GitHub - discourse/discourse-docs, pero no encontré ningún código relacionado. ¿Cómo funciona?

9

Un resumen muy breve es que las variables de entorno DISCOURSE_XYZ están disponibles en el código como GlobalSettings.xyz o SiteSettings.xyz.

En este caso específico, puedes encontrar GlobalSettings.docs_path aquí.

2 Me gusta
10

Gracias, @RGJ. Descubre cómo los nombres de la configuración del entorno se corresponden con la configuración en Discourse.

11

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