Uso editorial
Metadatos y sidebar
El front matter manda. Si está bien definido, el motor puede construir la web sin ayuda de un structure.json.
Formato recomendado#
Para la mayoría de páginas basta con esta forma simple:
---
category: S360 Proyectos
title: Creación de cuotas
icon: wallet
order: 40
tags:
- Operativa funcional
- Cuotas
---
Campos disponibles#
| Campo | Obligatorio | Uso |
|---|---|---|
category |
Recomendado | Valida la categoría declarada |
title |
Recomendado | Título visible en la web |
slug |
No | URL personalizada |
icon |
No | Icono del artículo |
order |
No | Orden de navegación |
tags |
No | Ruta simple de secciones |
navigation |
No | Ruta avanzada con icono y colapsado |
tags frente a navigation#
Usa tags cuando#
- solo necesites nombrar secciones o subsecciones
- quieras un formato corto y fácil de mantener
- el editor funcional no deba preocuparse de opciones visuales
Usa navigation cuando#
- quieras definir
icon - necesites indicar
collapsed: true - quieras dejar la intención visual declarada por artículo
Ejemplo avanzado:
---
title: Diagnóstico
order: 90
navigation:
- title: Soporte
icon: life-buoy
collapsed: false
- title: Resolución de incidencias
icon: wrench
collapsed: true
---
No mezcles tags y navigation en el mismo artículo.
Cómo se agrupa el sidebar#
- dos artículos con la misma ruta quedan en la misma sección
- el primer artículo que introduce una sección fija su posición visual
- la profundidad del sidebar depende del número de elementos en
tagsonavigation
Cómo definir URLs limpias#
Si no declaras slug, el motor usa la ruta del fichero:
introduccion.mdgeneraintroduccion/guias/instalacion.mdgeneraguias/instalacion/
Si necesitas una URL concreta:
---
title: Registro manual de DLL
slug: soporte/registro-manual-dll
---
Enlaces y assets dentro del Markdown#
Puedes enlazar artículos y ficheros con rutas relativas:
[Ver despliegue local](despliegue-local.md)
El motor reescribe ambas rutas durante el build.
Plantillas recomendadas#
Errores habituales
Los fallos más frecuentes son mezclar tags con navigation, repetir slugs dentro de una categoría o declarar una category que no coincide con la carpeta real.