Categorías de Documentos en Discourse

No necesitas apuntar el plugin Docs a la categoría; este plugin reemplaza al plugin Docs. Eso podría ser lo que está afectando las cosas, ya que causaría un conflicto y uno anularía al otro.

Todo lo que necesitas hacer es asegurarte de que doc categories enabled esté marcado y luego crear el tema índice en la categoría, añadiéndolo a la configuración de la categoría en el campo Index topic. Si todavía tienes la categoría configurada en la configuración del antiguo plugin Docs, deberías eliminarla de allí.

¡Hola Hugh, gracias por tu rápida respuesta! Si dije los plugins de Docs, mis disculpas. Solo tengo instalado el plugin Doc Categories aquí.

Así que aquí está el útil informe para encontrar Temas no indexados. Solo tengo 2 temas de prueba por ahora.

Luego, aquí está la pantalla de configuración. ¡Sé que estoy cerca, pero me faltan uno o dos pasos! ¡Gracias!

¿Has configurado el ajuste de categoría?

Además, ¿cómo es tu índice? ¿Está estructurado así?

¡Hola Marc! Sí, la Categoría está configurada (obviamente) a través del informe anterior, ¿verdad? Pero aquí está.

La página de Categoría se ve así:

Sé que me falta algo. ¿A qué te referías con esta página? ¿Está estructurada así?

Esto enlaza a un índice para la Documentation en Meta. Tu tema designado necesita parecerse a eso para que el índice se genere. Por tus capturas de pantalla, creo que entendiste mal/leíste algo mal. Lee desde aquí.

Además, un poco fuera de tema, pero quizás por la noche. ¿Necesito el plugin de tema de la barra lateral para mostrar el índice también a la derecha? ¿o eso también es automático? ¡Gracias!

No estoy seguro de lo que quieres decir, según mi entendimiento, la barra lateral es predeterminada/central y no un plugin.

Entendido, ¿te referías a las secciones de encabezado/subencabezado? Estuve buscando eso en el editor, pero no me quedó claro (al menos para mí) si necesitaba encabezados HTML como <h1> y demás. Agradezco nuevamente las rápidas respuestas.

Los encabezados son h1, los enlaces son por viñetas. Puedes copiar y pegar literalmente el índice de metadatos, te dará un ejemplo para empezar si tienes dificultades.

De esta manera:

## algo útil
* esto es eso: https://forum.example.tld/t/777
* aquello es otra cosa: https://forum.example.tld/t/666

Etc.

Soy perezoso, así que no lo hice manualmente, pero usé la IA del foro.

1 me gusta

Gracias. Así que copié una parte del índice de la documentación de arriba, tal como lo proporcionó @MarcP, pero no veo el índice de la barra lateral, lo cual es extraño, a menos que de nuevo me esté perdiendo algo…

Esa captura de pantalla no muestra la estructura. ¿Estás totalmente seguro de que estás usando el formulario * description: url y que indicas el nombre, la URL o el ID de ese tema en la configuración de esa categoría?

¿Como esto?

1 me gusta

Sí. Si ves algo similar a esto en composer (no te preocupes por el idioma tan extraño, la idea debería quedar clara):

Esto se usa en el menú de hamburguesa para mostrar las 20 cadenas con más reacciones en la categoría #koiramaailma . Una especie de escaparate, por así decirlo.

## Top 20 de las cadenas con más reacciones

* ¿Qué demonios está pasando en veterinaria 🤬: https://foorumi.katiska.eu/t/mita-helvettia-elainlaakinnassa-tapahtuu/6772
* Anuncios de comida seca: Casos reales divertidos: https://foorumi.katiska.eu/t/kuivamuonamainokset-hassut-aidot-tapaukset/479

Esas descripciones no se muestran en la barra lateral.

1 me gusta

Bueno, como puedes ver, nada en el lado derecho :frowning:

Si le sirve de ayuda a alguien, aquí está la lista de plugins que he instalado también…

    cmd:
      - git clone https://github.com/discourse/docker_manager.git
      - git clone https://github.com/discourse/discourse-solved.git
      - git clone https://github.com/discourse/discourse-user-notes.git
      - git clone https://github.com/discourse/discourse-openid-connect.git
      - git clone https://github.com/discourse/discourse-ai.git
      - git clone https://github.com/discourse/discourse-yearly-review.git
      - git clone https://github.com/paviliondev/discourse-custom-wizard.git
      - git clone https://github.com/discourse/discourse-doc-categories.git
      - git clone https://github.com/discourse/discourse-reactions.git
      - git clone https://github.com/discourse/discourse-akismet.git
      - git clone https://github.com/discourse/discourse-data-explorer.git
      - git clone https://github.com/discourse/discourse-oauth2-basic.git
      - git clone https://github.com/discourse/discourse-assign.git
      - git clone https://github.com/discourse/discourse-templates.git
      - git clone https://github.com/discourse/discourse-policy.git
      - git clone https://github.com/discourse/discourse-gamification.git
      - git clone https://github.com/discourse/discourse-category-experts.git
      - git clone https://github.com/merefield/discourse-ai-topic-summary.git
      - git clone https://github.com/MonDiscourse/discourse-formatting-toolbar.git
      - git clone https://github.com/discourse/discourse-custom-topic-lists.git
      - git clone https://github.com/thoka/discourse-send-pdf-inline.git
      - git clone https://github.com/discourse/discourse-prometheus.git
      - git clone https://github.com/communiteq/discourse-user-response-times.git
      - git clone https://github.com/discourse/discourse-fingerprint.git
      - git clone https://github.com/discourse/discourse-bcc.git
      - git clone https://github.com/featheredtoast/discourse-pushover-notifications.git
      - git clone https://github.com/discourse/discourse-saved-searches.git

Normalmente, la barra lateral está a la izquierda (rojo). La barra lateral de la documentación simplemente reemplaza el contenido predeterminado. A la derecha (morado) ves una tabla de contenido que se añade con el componente temático DiscoTOC - automatic table of contents.

DiscoTOC también es un componente de tema instalado. Tampoco puedo hacerlo funcionar. Algo anda mal…

No estoy seguro, pero tus capturas de pantalla no son claras. ¿Tomas la captura de pantalla y no muestras ninguna barra lateral? ¿No se muestra la barra lateral del documento? ¿O no se muestra la barra lateral en absoluto (¿no está simplemente oculta, intenta presionar =)?

Editar; pensando en esto, deberías ser claro si tienes problemas con discoTOC (tabla de contenido para el OP) o con las doc-categories (barra lateral del índice del documento).

1 me gusta

Hola Marc:

Así que DiscoTOC funciona. Volví a comprobar y, de hecho, crea una tabla de contenido lateral después de ir a engranajes e insertar la tabla de contenido como dicen las instrucciones.

Todas mis capturas de pantalla incluyen la barra lateral, así que estoy mostrando el paisaje abierto sin ninguna barra lateral visible.

Tengo la extraña sensación de que será una solución muy simple, pero aún no he llegado :frowning:

No veo ninguna barra lateral en tus capturas de pantalla; todas muestran solo el contenido de la publicación. ¿Podrías publicar una captura de pantalla de la pantalla completa de Discourse cuando estés en una categoría que debería mostrar un índice?

3 Me gusta