Unter der Vorschau und unter dem Build steht je eine Konsole. Sie zeigt, was Quartz sagt — wörtlich, ohne Übersetzung, weil es die Ausgabe eines fremden Programms ist.
Was normal ist
Ein gelungener Build: Ergebnis und Dauer über der Ausgabe.
Ein gelungener Lauf sieht ungefähr so aus:
Quartz v5.0.0
Cleaned output directory `public` in 20ms
Found 114 input files from `content` in 15ms
Parsing input files using 1 threads
Parsed 114 Markdown files in 621ms
Filtered out 0 files in 238μs
Emitting files
Emitted 461 files to `public` in 8s
Done processing 114 files in 8s
Vier dieser Zeilen beantworten vier Fragen — wie viele Dateien wurden gefunden, wie viele gelesen, wie viele durch die Ausschlussmuster entfernt, wie viele geschrieben.
Die erste Zahl ist die nützlichste. Steht dort eine Zahl, die viel zu klein ist, zeigt der Content-Ordner nicht dorthin, wo man denkt.
Die häufigen Fehler
| Was dasteht | Was dahintersteckt |
|---|---|
bad indentation of a mapping entry | Ein Frontmatter-Wert mit Doppelpunkt, der nicht in Anführungszeichen steht. Der Bau bricht an der ersten betroffenen Datei ab. |
| Ein SCSS-Fehler mit Zeilennummer | Das eigene CSS lässt sich nicht übersetzen. Der Tab dort prüft das, ohne zu bauen. |
Cannot find package oder Cannot find module | Eine Abhängigkeit fehlt. In einem frisch geklonten Projekt fehlen alle, und die erste Meldung lautet Cannot find package 'yargs'. |
| Ein Plugin meldet sich namentlich | Dann ist es dessen Meldung; das Repository des Plugins ist die richtige Adresse. |
Wenn die Vorschau nicht startet
Ein belegter Port ist kein Grund dafür: Der Server nimmt dann den nächsten freien, und die Konsole
sagt es, etwa Port 8080 ist belegt — der Server nimmt 8082. Was den Port hält, zeigt die Karte
Laufende Server auf diesem Rechner — siehe 5.4.
Startet die Vorschau trotzdem nicht, steht der Grund in der Konsole; die häufigen Meldungen nennt die Tabelle oben.
Wenn die Ausgabe leer bleibt
In seltenen Fällen meldet QuartzControl, dass es die Ausgabe des Servers nicht mitschreiben kann. Dann läuft der Server trotzdem — nur diese Konsole bleibt für diesen Lauf leer. Im Browser ist die Vorschau normal erreichbar.