Estructura de carpetas

Estructura de carpetas

Este texto fue traducido automáticamente con IA a partir del original en English. Puede tener errores.

Ver el original (English)

Cómo las carpetas y las notas se convierten en las páginas del sitio.

El mapa

Site/                     la carpeta con las notas del sitio
├── _index.md             página de inicio y ajustes del sitio
├── Docs/                 sección de documentación (blup: docs)
│   ├── _index.md         página de apertura de la documentación
│   └── Getting started/  un grupo en el menú lateral
├── Roadmap/              tablero de hoja de ruta (blup: roadmap)
├── Changelog/            lista de versiones (blup: changelog)
├── Help/                 centro de ayuda (blup: help)
├── Blog/                 blog (blup: blog)
├── Feedback/             tablero de solicitudes (blup: feedback)
├── Writers/              perfiles de autores (blup: authors)
└── Attachments/          imágenes, audio y otros archivos

Las reglas

  • Cada nota se convierte en una página.
  • Cada carpeta se convierte en un grupo o una sección.
  • La nota _index de una carpeta le da un título, una descripción y un texto de apertura.
  • En Bento, la propiedad blup en el _index de una carpeta de nivel superior indica qué tipo de sección es: docs, roadmap, changelog, help, blog, feedback o authors. Puedes darle a la carpeta el nombre que quieras.
  • Una carpeta llamada en, es o pt junto a una nota contiene su traducción. Consulta Sitios multilingües.

Lo que no aparece en el sitio

  • Las notas con draft: true (solo se muestran en la vista previa).
  • Las carpetas que empiezan con un punto, como .blup.
  • La carpeta de plantillas (Templates).
  • La carpeta de autores: solo se convierte en los datos del perfil.
  • Las guías para agentes de IA (AGENTS.md, CLAUDE.md y GEMINI.md), que el Studio crea al abrir la terminal.
  • Los adjuntos que ninguna nota utiliza.

Carpetas que Blup usa en segundo plano

  • .blup, dentro de la carpeta de notas: contiene el archivo site.toml, la parte de los ajustes que viaja con la sincronización.
  • La carpeta del sitio (fuera de tus notas): blup.toml, los archivos del generador, la papelera del Studio y el estado de la sincronización. Nunca necesitas abrirla.

Direcciones de las páginas

La dirección se forma a partir de los nombres de carpetas y notas, sin acentos y con guiones: la nota “Folder structure” dentro de “Getting started” se convierte en /docs/getting-started/folder-structure/.