Base de Conocimiento

:warning: La funcionalidad de este componente del tema ha sido reemplazada por el plugin Discourse Docs

Este componente del tema habilita una vista de tipo base de conocimientos para categorías seleccionadas.

:link: Enlace al repositorio

:link: Vista previa en Theme Creator


Se añade un botón \u003ckbd\u003eKB\u003c/kbd\u003e a las pestañas de navegación para cualquier categoría habilitada en la configuración.

Una vez activada la vista, la base de conocimientos muestra una versión simplificada de la lista de temas más recientes.

Haz clic en una etiqueta en la barra lateral y la lista de temas se filtrará automáticamente por esa etiqueta. Puedes seleccionar tantas etiquetas como desees, y la lista de etiquetas mostrará solo las etiquetas agregadas a los temas filtrados para facilitar la navegación por mucha documentación.

¿Quieres buscar? Simplemente escribe un término en el cuadro. Los resultados de la búsqueda también se limitan a las etiquetas que hayas seleccionado.

Consideraciones

Las siguientes configuraciones del sitio son requeridas para que este componente funcione: activar etiquetado y mostrar filtro por etiqueta

\u003cstrike\u003eEste componente del tema actualmente no tiene una vista móvil.\u003c/strike\u003e

Dicho esto, estamos trabajando en crear una versión más avanzada de esto. ¡Asegurémonos de avisarte aquí en Meta cuando esté lista!

27 Me gusta

Este commit ahora agrega una vista móvil básica.

Ten en cuenta que no es perfecto, ya que si hay muchas etiquetas, puedes hacer scroll sobre ellas. Estoy considerando algunas ideas para solucionar eso.

9 Me gusta

¡Llevamos usando Discourse como nuestra base de conocimientos durante más de 4 años y tenemos alrededor de 350 publicaciones específicas de la base de conocimientos, así que esto es muy emocionante!

No estoy seguro de si esto es posible mediante un componente de tema, pero ¿hay alguna forma de que esta “vista” sea la predeterminada cuando alguien abre una categoría? Es decir, en lugar de ir a: /c/knowledge-base, ¿podría cargarse automáticamente como /c/knowledge-base?kb=active?

Hemos habilitado el componente de tema KB y nos gusta mucho, pero nos preocupa que la gente no esté viendo la vista de la base de conocimientos porque están usando el enlace /c/knowledge-base que tenían guardado anteriormente.

Gracias por su trabajo en esto.

6 Me gusta

¡Me pondré a investigar la posibilidad de añadir una configuración para esto! Gracias por la sugerencia y me alegra que te resulte útil.

6 Me gusta

Esto ahora se implementó como una configuración del tema. ¡También se admiten ahora las subcategorías!

9 Me gusta

¡Acabo de actualizar. Se ve genial, ¡gracias!

3 Me gusta

¿Cómo se aplica esto a una subcategoría? ¿Existe una sintaxis especial?

¡Muchas gracias por esto! Tenemos una categoría en nuestra comunidad que sería perfecta para aplicar este componente, pero estamos enfrentando un problema: las categorías no aparecen en el menú desplegable “kb categories”, por lo que no podemos seleccionar la categoría para aplicar el componente. ¿Alguna sugerencia?

Simplemente puedes escribir el slug de la categoría y crearla. No es extremadamente intuitivo. No he podido averiguar cómo obtener subcategorías, pero si tu categoría está en el primer nivel, es bastante fácil.

1 me gusta

Ok, realmente no es intuitivo. Escribí y “creé” la categoría, y funcionó. Pero aún no aparece como se esperaba.

Hice una instalación nueva de Discourse para probar, configuré ambos componentes:

br%20a170a9ec422c

(D.I.Y. / diy es la categoría para la que quiero activar KB, y tiene un enlace superior específico creado con el componente Enlaces de navegación superior personalizados)

br%2086f9546a1534

Pero la categoría D.I.Y. aparece con la vista normal:

La URL muestra al final: /c/diy?kb=active

1 me gusta

No hay sintaxis especial: simplemente ingresa el slug de la categoría (subcategoría o no) en la configuración del tema kb categories, actualiza tu navegador y debería funcionar.

Esta es una limitación de las configuraciones del tema por ahora; tendrás que escribir el slug como sugirió @Sean_R.

¿Lograste solucionarlo, @TowerBR? ¿Actualizaste después de agregar la categoría a la configuración? ¿Hiciste clic en el botón KB? Disculpa las preguntas tontas, pero estoy tratando de llegar al fondo del asunto.

1 me gusta

Funcionó, gracias :slight_smile:

Me gusta así, ya que puedo nombrar todas mis subcategorías de la KB de la misma manera y solo necesito añadirlas una vez.

Sin embargo, noto que si accedo a la categoría mediante el menú desplegable, no cambia automáticamente a la vista de la KB.

Todos los demás métodos de navegación parecen funcionar, pero el menú desplegable de subcategorías no lo hace.

2 Me gusta

¿Tienes activada la opción predeterminado a vista de KB? Acabo de probarlo en uno de mis sitios y parecía funcionar con subcategorías.

2 Me gusta

Sí, y funciona la mayor parte del tiempo, solo no si uso el menú desplegable de subcategorías para cambiar de una categoría a otra.

Eso es extraño, vale. Si puedes reproducirlo de manera consistente, avísame y lo revisaré. No he podido lograr que ese comportamiento se active usando el menú desplegable de subcategorías.

2 Me gusta

Sí, ya lo había hecho; mira la imagen del post anterior:

br%2086f9546a1534

Eliminé el componente “Enlaces de navegación superior personalizados”. Ahora es una instalación completamente “limpia”:

br%20346e44618d61

Sí, y también limpié la caché.

Sí. Cuando selecciono la categoría desde el menú desplegable principal, ya carga la página de la categoría con /c/diy?kb=active al final de la URL. Al pasar el cursor sobre el botón KB, muestra la URL “normal” sin este “complemento”, pero al hacer clic en él no ocurre nada.

¿Estás ejecutando la última versión del componente del tema? ¿Estás usando tests-passed o stable para tu versión de Discourse?

2 Me gusta

Ocurre cada vez. Puedo hacer clic en “KB” o actualizar y se soluciona, pero no cuando voy a la categoría desde el menú desplegable.

Sí:

params:
   version: tests-passed
3 Me gusta

¡Esto es increíble! Acabo de instalarlo para echar un vistazo y ya veo que es muy útil.

Este componente del tema parece entrar en conflicto con https://meta.discourse.org/t/knowledge-base-plugin/115288 de @angus. Puedo confirmar que el plugin debe desinstalarse antes de activar este componente del tema; de lo contrario, ocurre lo siguiente al ver una categoría de la base de conocimientos. Fíjate en la extraña línea horizontal junto al menú y en el círculo giratorio.

Me encantaría saber más sobre la versión avanzada y lo que tienen planeado. Aquí va algún feedback:

  • ¿Error? Cuando seleccionas una etiqueta del menú izquierdo para filtrar por ella y luego haces clic en otra categoría o en “más recientes”, etc., al volver a hacer clic en kb para regresar a la base de conocimientos, sigues filtrando por esa etiqueta.
  • Al hacer clic en la etiqueta bajo un título, te lleva a la página de esa etiqueta, no a una vista filtrada de la base de conocimientos como ocurre cuando haces clic en la etiqueta del menú izquierdo.
  • Al hacer clic en el título de la categoría de etiquetas del menú izquierdo, te lleva a la vista de “más recientes” de la categoría. Sugeriría que no tenga enlace alguno. Además, el título de la categoría probablemente no debería tener #, ya que distrae.
  • Sería útil ver el número de temas con cada etiqueta en el menú izquierdo.
  • Sería útil poder ordenar los temas de la base de conocimientos alfabéticamente o incluso en un orden personalizado.
4 Me gusta