Начало работы

Это руководство поможет вам запустить Xingluo для локальной разработки и производственных сборок с нуля.

Требования

Совет: управляйте версиями Node с помощью fnm или nvm.

Установка

После клонирования репозитория установите зависимости:

bash
pnpm install

После установки зависимостей справочные проекты в references/ автоматически исключаются из компиляции TypeScript и сборок (см. exclude в tsconfig.json).

Локальная разработка

Запустите сервер разработки (по умолчанию http://localhost:4321/):

bash
pnpm dev

В режиме разработки:

• Черновики и запланированные посты все видны (для предпросмотра); они фильтруются только при производственных сборках
• Изменения коллекций контента вызывают горячую перезагрузку
• Клиентское поведение (переключение темы, View Transitions и т.д.) соответствует продакшену

Синхронизация типов

После изменения схем или типов коллекций контента запустите sync для обновления .astro/types.d.ts:

bash
pnpm sync

Сборка

Производственная сборка состоит из трех шагов (см. скрипт build в package.json):

bash
pnpm build

1. astro check: проверка типов TypeScript и шаблонов Astro; любая ошибка прерывает сборку
2. astro build: статически генерирует весь сайт в dist/ (включая динамические OG-изображения, RSS, sitemap, robots.txt)
3. node scripts/generateSearchIndex.mjs: сканирует dist/ для создания индекса полнотекстового поиска в dist/search/

Примечание: Индекс поиска генерируется скриптом Node после сборки.

Предпросмотр сборки

Просмотрите результат сборки в dist/ локально:

bash
pnpm preview

Качество кода

Следующие шаги

• Прочитайте Руководство по настройке для настройки информации о сайте и функций
• Прочитайте Создание контента чтобы начать писать
• Прочитайте Развертывание чтобы опубликовать сайт