ข้ามไปที่เนื้อหา

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.

เริ่มใช้งานฟรี

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
ค้นหาเอกสาร
ค้นหาหน้าเอกสาร
ศูนย์ช่วยเหลือ