- Docs
- Hilfe
- Build-Ausgabe
Docs for VelinStyle 1.3.x · verified against 1.3.0
Build-Ausgabe fehlt 1.3.0
Prüfe die veröffentlichten Distributionsdateien und die Konfiguration der Produktionsausgabe. English
Problem
Erwartetes CSS/JS unter dist/ oder dist/velin-production/ fehlt oder ist unvollständig.
Erste Prüfung
Führe zuerst die allgemeine Diagnose im Projektverzeichnis aus.
npx @birdapi/velinstyle doctor
Tiefer prüfen
npx @birdapi/velinstyle production . --explain
npx @birdapi/velinstyle blueprint --strict
Schnellcheck
- Im richtigen Projektverzeichnis ausführen.
- Nur dokumentierte Profile und Flags verwenden.
- Nach jeder Änderung erneut prüfen.
Distributionsdateien fehlen
Ursache: Die Seite referenziert Assets, die nie gebaut oder nie in den Deploy-Baum kopiert wurden.
- Lösung 1: Stelle sicher, dass
dist/velinstyle.min.css und dist/velinstyle-components.min.js für 1.3.0 existieren. - Lösung 2: Verlinke HTML auf diese Pfade (oder passende Themes unter
dist/themes/). - Lösung 3: Synchronisiere Framework/Site erneut, damit Deploy und Paket übereinstimmen.
Erneut prüfennpx @birdapi/velinstyle doctor
npx @birdapi/velinstyle check ./index.html --profile docs
Produktionsausgabe ist unvollständig
Ursache: production hat ein getrimmtes Bundle geschrieben, in dem nötige Klassen oder Assets fehlen.
- Lösung 1: Prüfe zuerst mit
npx @birdapi/velinstyle production . --explain. - Lösung 2: Füge nur nötige dynamische Klassen per
--safelist hinzu (Beispiel: --safelist .my-dynamic-class). - Lösung 3: Baue nach
dist/velin-production/ und prüfe die Seite gegen diese Ausgabe.
Erneut prüfennpx @birdapi/velinstyle doctor
npx @birdapi/velinstyle check ./index.html --profile docs
VelinStyle