Agregar páginas

Todos los archivos con la extensión md y mdx que agregues en tu carpeta docs se convertirá automaticamente en una página.

Agregando una página

Agregar una nueva página a la documentación es tan sencillo como agregar un nuevo archivo md o mdx dentro del directorio /docs.

public
src
- docs
- content.config.ts
astro.config.mjs

Si creas un archivo dentro de la carpeta docs este generará una url autómaticamente tomando el nombre del archivo.

Si creas el archivo: descripción.md

src
- docs
  - descripcion.md
- content.config.ts
astro.config.mjs

La url para acceder a el será: “/descripcion”

Pro tip

Igual puedes crear nuevas secciones agregando carpetas dentro de la carpeta docs.

Si creas una carpeta llamada Guias y dentro de ella un archivo styles.md

public
src
- docs
  - descripcion.md
  - guías
    
    styles.md
- content.config.ts
astro.config.mjs

La ruta que se genera es: /guias/styles

Composición de la url

La url se construye tomando el nombre del archivo que estas creando.

Si creas una carpeta para agrupar contenido, el nombre de la carpeta sera usado en la url. Entonces la url es: nombre_carpeta/…/nombre_archivo

Pro tip

Puedes crear tantas carpetas como necesites.

Puedes anidar tantas carpetas como necesites.

Contenido del archivo

Para los decumentos que crearás es necesario conocer que tu archivo va a estar dividido en dos partes:

Front Matter
Contenido

Front Matter

Te servirá para personalizar el contenido de las páginas.

Advertencia

Estos valores se deben incluir en la parte superior del docummento y entre --- giuones separadores

   

---

title: titulo de la página
description: breve descripción del contenido
displayName: Nombre para el menú lateral

---

contenido en markdown ...