Skip to content

Estructura del Proyecto

Entendiendo la organización del proyecto y los archivos clave.

2 min read

Connect your agent today

Draft from chat, review in your calendar, and publish only what you approve.

Start for $0

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 markdown
  • navigation.ts — Genera la navegación del sidebar desde la estructura de archivos
  • types.ts — Tipos TypeScript para docs, navegación y configuración
  • toc.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úsqueda
  • theme/ — Cambio de modo oscuro
  • docs/ — Componentes de documentación (Callout, Tabs, Steps, etc.)
  • ui/ — Biblioteca de componentes base (shadcn-svelte)

Archivos de Configuración

ArchivoPropósito
svelte.config.jsConfiguración de SvelteKit + MDSvex
vite.config.tsConfiguración de Vite + Tailwind CSS
src/lib/docs/config.tsConfiguración del sitio de documentación
components.jsonConfiguración de shadcn-svelte
Search documentation
Find a docs page
Discord Support