Estructura del Proyecto
Entendiendo la organización del proyecto y los archivos clave.
Connect your agent today
Draft from chat, review in your calendar, and publish only what you approve.
Vista General
La plantilla sigue las convenciones de SvelteKit con un motor de documentación dedicado en src/lib/docs/.
Directorios Clave
src/content/docs/
Aquí es donde vive tu documentación. Cada archivo .md se convierte en una página. La estructura de directorios determina la navegación del sidebar.
src/content/docs/
├── index.md # /docs
├── getting-started-for-dev/
│ ├── installation.md # /docs/getting-started-for-dev/installation
│ └── project-structure.md # /docs/getting-started-for-dev/project-structure
└── documentation-contribution/
├── configuration.md
└── writing-content.md
src/content/docs-es/
├── getting-started-for-dev/ # /docs/es/getting-started-for-dev/...
│ ├── installation.md
│ └── project-structure.md
└── documentation-contribution/
├── configuration.md # /docs/es/documentation-contribution/configuration
└── writing-content.md # /docs/es/documentation-contribution/writing-content src/lib/docs/
El motor de documentación:
config.ts— Configuración del sitio (título, secciones del sidebar, enlaces sociales)content.ts— Cargador de contenido que descubre y analiza archivos markdownnavigation.ts— Genera la navegación del sidebar desde la estructura de archivostypes.ts— Tipos TypeScript para docs, navegación y configuracióntoc.svelte.ts— Gestión del estado de la tabla de contenidos
src/lib/components/
layout/— Componentes de diseño (header, sidebars)nav/— Componentes de navegación (breadcrumbs)search/— Paleta de búsquedatheme/— Cambio de modo oscurodocs/— Componentes de documentación (Callout, Tabs, Steps, etc.)ui/— Biblioteca de componentes base (shadcn-svelte)
Archivos de Configuración
| Archivo | Propósito |
|---|---|
svelte.config.js | Configuración de SvelteKit + MDSvex |
vite.config.ts | Configuración de Vite + Tailwind CSS |
src/lib/docs/config.ts | Configuración del sitio de documentación |
components.json | Configuración de shadcn-svelte |