Secciones anidadas

Esta página vive en una subsección anidada —authoring/advanced/— así que es ella misma el ejemplo en vivo al que apunta la página de Navegación. Abre la barra lateral: “Authoring Docs › Advanced › Nested Sections” está expandido porque estás en él.

Cómo funciona el anidamiento

Coloca una carpeta dentro de una carpeta de sección. plasmoid desciende a cualquier profundidad: cada carpeta se convierte en un grupo plegable y cada archivo .md en un elemento.

authoring/
  navigation.md
  advanced/
    _category.toml          # title = "Advanced", order = 5
    nested-sections.md       # ← you are here
    assets-and-images.md

La URL de salida refleja la ruta de la carpeta:

/<version>/en/authoring/advanced/nested-sections/

Cada nivel se configura a sí mismo

Cada carpeta puede llevar su propio _category.toml. El título y la posición order sitúan el grupo entre sus hermanos; pages ordena los elementos propios de ese grupo. Los prefijos numéricos NN- también funcionan en todos los niveles y se eliminan de la URL.

Expansión automática del rastro activo

Los grupos de la barra lateral se renderizan como elementos nativos <details>. En tiempo de compilación, plasmoid añade el atributo open al grupo que contiene la página actual —y a todos sus ancestros— de modo que el lector siempre llega con su sección expandida y su ubicación visible. Todo lo demás permanece plegado para mantener un árbol grande fácil de escanear.

No interviene JavaScript: es el widget de despliegue integrado del navegador, lo que significa que funciona con los scripts desactivados y es accesible por teclado de forma gratuita.

Mantenlo poco profundo cuando puedas

La profundidad está soportada, no es obligatoria. Dos niveles (sección › página) sirven para la mayoría de los documentos; recurre a un tercero solo cuando una sección realmente tenga subtemas. Al lado, Recursos e imágenes muestra otro detalle de creación de contenido.