Este plugin está siendo retirado en favor del experimental plugin de Categorías de Documentos. Seguiremos apoyando a Docs hasta que el nuevo plugin ya no se considere experimental.
 |
Resumen | Discourse Docs ofrece la capacidad de buscar y filtrar temas de la base de conocimientos |
 |
Enlace al repositorio | https://github.com/discourse/discourse-docs |
 |
Guía de instalación | Cómo instalar plugins en Discourse |
Características
El plugin Discourse Docs es una herramienta poderosa que transforma tu foro de Discourse en una base de conocimientos impulsada por la comunidad. Proporciona una sección dedicada de Documentos donde los usuarios pueden crear, actualizar y curar documentación. Este plugin cuenta con un botón de Documentos que permite un acceso fácil a esta sección. Es una excelente manera de aprovechar el conocimiento colectivo de tu comunidad y proporcionar un recurso centralizado para información importante.
En esencia, Docs permite una mayor visibilidad de temas con estilo de base de conocimientos en un conjunto definido de categorías y/o etiquetas.
Filtra la lista por etiquetas, busca mediante la barra de búsqueda y haz clic en los temas para ver la primera publicación, todo sin salir del contexto del explorador de conocimientos.
¿Necesitas encontrar un tema de la base de conocimientos desde otra parte de Discourse? Usa el nuevo asistente de búsqueda: in:kb.
Configuración
-
Habilita el plugin activando la configuración
docs enabled. -
Añade categorías y etiquetas a las configuraciones
docs categoriesydocs tags. -
Encuentra el enlace de Documentos en el menú de navegación.
- ¡Disfruta de un acceso más fácil al conocimiento!
Configuraciones
| Nombre | Descripción |
|---|---|
| docs enabled | Habilitar el plugin de Documentos |
| docs categories | Una lista de identificadores de categoría para incluir en Documentos |
| show tags by group | Organizar etiquetas usando Grupos de Etiquetas. Crea grupos para categorizar etiquetas relacionadas. |
| docs tag groups | Los Grupos de Etiquetas utilizados para mostrar etiquetas por grupo |
| docs tags | Una lista de etiquetas para incluir en Documentos |
| docs add solved filter | Añade un filtro para temas resueltos; requiere que Discourse Solved esté instalado y habilitado |
| docs add to top menu | Añade un enlace al menú superior para navegar a la vista de Documentos |
| docs add search menu tip | Añade el consejo “in:docs” a los consejos aleatorios del menú de búsqueda |
Combinaciones útiles
Cambiar el nombre de la ruta /docs
Si tienes acceso a tu servidor, puedes cambiar la ruta de tu enlace /docs añadiendo una variable de entorno DISCOURSE_DOCS_PATH: a tu app.yml:
Para que el cambio surta efecto, puedes ejecutar ./launcher rebuild app o, como es una variable de entorno, puedes ejecutar ./launcher destroy app && ./launcher start app para minimizar el tiempo de inactividad. Hay un poco más de información sobre esto aquí: Set Environmental Variables
También es posible que quieras cambiar el texto de visualización del sitio para que coincida. Puedes buscar todas las instancias de ‘docs’ desde tu página /admin/customize/site_texts, pero las principales serían:
- js.docs.title
- js.sidebar.docs_link_text
¿Alojado por nosotros? Cambiar el nombre de la ruta
/docssolo está disponible en nuestro plan Empresarial. Contáctanos si deseas saber más.
Historial de desarrollo
El plugin Docs fue una continuación del Componente de Tema Explorador de Conocimientos.