Primeros Pasos

Esta guía te ayuda a poner en marcha Xingluo para el desarrollo local y las compilaciones de producción desde cero.

Requisitos

Consejo: gestiona las versiones de Node con fnm o nvm.

Instalación

Después de clonar el repositorio, instala las dependencias:

bash
pnpm install

Una vez instaladas las dependencias, los proyectos de referencia en references/ se excluyen automáticamente de la compilación de TypeScript y las builds (ver exclude en tsconfig.json).

Desarrollo local

Inicia el servidor de desarrollo (por defecto en http://localhost:4321/):

bash
pnpm dev

En modo de desarrollo:

• Los borradores y las publicaciones programadas son todas visibles (para vista previa); solo se filtran durante las compilaciones de producción
• Los cambios en las colecciones de contenido activan la recarga en caliente
• Los comportamientos del lado del cliente (cambio de tema, View Transitions, etc.) coinciden con la producción

Sincronización de tipos

Después de modificar los esquemas o tipos de las colecciones de contenido, ejecuta sync para actualizar .astro/types.d.ts:

bash
pnpm sync

Compilación

La compilación de producción tiene tres pasos (ver el script build en package.json):

bash
pnpm build

1. astro check: verificación de tipos de TypeScript y plantillas Astro; cualquier error aborta la compilación
2. astro build: genera estáticamente todo el sitio en dist/ (incluyendo imágenes OG dinámicas, RSS, sitemap, robots.txt)
3. node scripts/generateSearchIndex.mjs: escanea dist/ para generar el índice de búsqueda de texto completo en dist/search/

Nota: El índice de búsqueda se genera mediante un script de Node después de la compilación.

Vista previa de la compilación

Previsualiza el resultado de la compilación en dist/ localmente:

bash
pnpm preview

Calidad del código

Próximos pasos

• Lee la Guía de configuración para personalizar la información del sitio y las funciones
• Lee Creación de contenido para empezar a escribir
• Lee Despliegue para publicar tu sitio