Navegación a partir de la estructura de carpetas

plasmoid construye la barra lateral a partir de la disposición de tus carpetas: no hay una configuración de navegación aparte que mantener sincronizada. Una carpeta es una sección; un archivo .md es un elemento.

en/
  index.md                  # the home page (not shown in the sidebar)
  getting-started/          # a sidebar section
    installation.md         # an item
    quickstart.md
  reference/
    cli.md
    configuration.md

La estructura se lee del locale predeterminado; los demás locales la heredan y recaen en él página por página (consulta Localización).

Ordenación

Hay dos formas de ordenar las cosas, por prioridad:

1. Prefijos numéricos en el nombre de archivo. Antepón NN- a un archivo o carpeta para ordenarlo: 01-getting-started/, 02-authoring/. El prefijo se elimina de la URL y del título: 01-quickstart.md se sirve en /…/quickstart/.
2. _category.toml en una carpeta de sección, para un control explícito.

Sin ninguno de los dos, los elementos se ordenan alfabéticamente y las secciones se ordenan después de cualquiera que declare un orden.

_category.toml

Coloca un _category.toml en una carpeta de sección para sobrescribir su título y ordenación:

title = "Getting Started"   # else the folder name, titleized
order = 1                   # lower sorts first; missing sorts last
pages = ["install", "quickstart", "first-build"]

• title — el encabezado de la sección en la barra lateral.
• order — la posición de la sección entre sus secciones hermanas.
• pages — orden explícito de las páginas, por slug (el nombre de archivo sin la extensión .md y sin ningún prefijo NN-). Las páginas que no enumeres siguen, en el orden predeterminado.

Todos los campos son opcionales; un _category.toml vacío o ausente simplemente significa “usar los valores predeterminados”.

Secciones anidadas

Las carpetas se anidan a cualquier profundidad. Una carpeta dentro de una sección se convierte en una subsección plegable, renderizada como un elemento de despliegue nativo <details> —sin JavaScript:

en/
  authoring/
    navigation.md
    advanced/                 # a nested subsection
      _category.toml
      nested-sections.md
      assets-and-images.md

Cada nivel toma su propio _category.toml para el título y la ordenación, y la URL refleja la ruta de la carpeta (/…/authoring/advanced/nested-sections/). El grupo plegado de la página en la que estás —y todos sus ancestros— se expande automáticamente en tiempo de compilación, de modo que el lector siempre ve su ubicación en el árbol sin ningún estado que gestionar. Consulta la subsección Avanzado más abajo para ver un ejemplo en vivo.

Páginas de nivel superior

Un archivo .md directamente bajo la raíz del locale (no en una carpeta de sección) se convierte en un elemento suelto de nivel superior en la barra lateral. index.md es especial: es la página de inicio, no una entrada de la barra lateral.

Estado activo

La barra lateral marca la página actual con una clase active y aria-current="page" para que el lector siempre sepa dónde está —sin necesidad de JavaScript. Dentro de una sección anidada plegable, se expande todo el rastro de ancestros de la página activa.