Erste Schritte

Diese Anleitung hilft Ihnen, Xingluo für die lokale Entwicklung und Produktions-Builds von Grund auf einzurichten.

Voraussetzungen

Tipp: Verwalten Sie Node-Versionen mit fnm oder nvm.

Installation

Nach dem Klonen des Repositoriums, installieren Sie die Abhängigkeiten:

bash
pnpm install

Sobald die Abhängigkeiten installiert sind, werden die Referenzprojekte unter references/ automatisch von der TypeScript-Kompilierung und den Builds ausgeschlossen (siehe exclude in tsconfig.json).

Lokale Entwicklung

Starten Sie den Entwicklungsserver (Standard http://localhost:4321/):

bash
pnpm dev

Im Entwicklungsmodus:

• Entwürfe und zeitgesteuerte Beiträge sind alle sichtbar (für Vorschau); sie werden nur bei Produktions-Builds gefiltert
• Änderungen an der Content Collection lösen Hot Reload aus
• Clientseitige Verhaltensweisen (Theme-Umschaltung, View Transitions usw.) entsprechen der Produktion

Typ-Synchronisation

Nach dem Ändern von Content-Collection-Schemas oder -Typen führen Sie sync aus, um .astro/types.d.ts zu aktualisieren:

bash
pnpm sync

Build

Der Produktions-Build besteht aus drei Schritten (siehe das build-Skript in package.json):

bash
pnpm build

1. astro check: TypeScript- und Astro-Vorlagen-Typüberprüfung; jeder Fehler bricht den Build ab
2. astro build: generiert die gesamte Website statisch in dist/ (einschließlich dynamischer OG-Bilder, RSS, Sitemap, robots.txt)
3. node scripts/generateSearchIndex.mjs: durchsucht dist/ und generiert den Volltextsuchindex in dist/search/

Hinweis: Der Suchindex wird nach dem Build von einem Node-Skript generiert.

Build-Vorschau

Zeigen Sie die Build-Ausgabe in dist/ lokal an:

bash
pnpm preview

Code-Qualität

Nächste Schritte

• Lesen Sie den Konfigurationsleitfaden, um Website-Informationen und Funktionen anzupassen
• Lesen Sie Inhaltserstellung, um mit dem Schreiben zu beginnen
• Lesen Sie Bereitstellung, um Ihre Website zu veröffentlichen