Presentamos el editor de índice visual para categorías de Discourse Doc

Las categorías de documentos ahora pueden crear su índice lateral directamente en la interfaz de administración. El editor de índice es un cambio próximo para el Complemento de Categorías de Documentos, y elimina la necesidad de mantener un tema de índice separado.

Dos formas de crear un índice

Al editar una categoría, ahora hay una pestaña Índice de documentos con un selector de modo:

  • Editor crea el índice en el lugar, como secciones que contienen enlaces.
  • Tema de índice es el comportamiento existente, donde los encabezados y listas de un tema se convierten en el índice.
  • Desactivado apaga el índice lateral para esa categoría.

Las categorías que ya apuntan a un tema de índice seguirán funcionando exactamente como lo hacen hoy.

Crear un índice

Una sección contiene enlaces, y un enlace apunta ya sea a un tema o a cualquier URL que escribas. Cada enlace puede llevar su propio icono, y el editor te advierte cuando dos enlaces resuelven al mismo lugar o cuando dos secciones comparten un título.

También se te muestra cuando los temas en la categoría no aparecen en el índice, y puedes agregar estos temas en bloque:

La sección Auto-índice se rellena a sí misma desde los temas de la categoría, por lo que puedes listar las páginas que te interesan manualmente y dejar que todo lo demás se recopile en un solo lugar. Puede volver a sincronizarse en cada guardado.

Las secciones y los enlaces se reordenan arrastrando. Cada asa de arrastre es también un punto de tabulación ordinario que abre un menú de movimiento, por lo que se puede reorganizar todo el índice desde el teclado. Un modo por lotes maneja la selección múltiple, para eliminar varias filas a la vez o arrastrar una selección completa junta.

Actívalo en tu sitio

El editor de índice es un cambio próximo experimental. Activa Editor de índice de categorías de documentos en /admin/config/upcoming-changes. Afecta solo a las categorías de documentos, y solo a lo que los administradores ven al editar una de ellas.

Nos encantaría recibir tus comentarios

Cuéntanos cómo se comporta frente a un índice real: si crear uno aquí supera a mantener un tema, qué falta antes de que moverías una categoría a este método, y cualquier cosa que parezca tosca.

14 Me gusta

La PR inicial FEATURE: Add visual doc category index editor - Pull Request #87 - discourse/discourse-doc-categories - GitHub acaba de fusionarse como parte de un cambio experimental pendiente. Es probable que la funcionalidad pase por más ajustes en la próxima semana o dos antes de pasar a Alpha.

1 me gusta