Ein Build erzeugt die fertige Website einmalig — die HTML-Dateien, die Stylesheets, den Suchindex, die Bilder. Danach liegt ein Ordner da, den man hochladen, prüfen oder weiterreichen kann.
Zum Ansehen beim Schreiben ist der Dev-Server gedacht. Der Build ist der Schritt davor, wenn etwas veröffentlicht werden soll.
Während gebaut wird
Ein großes Projekt baut eine Weile. Solange es läuft, steht unter dem Button eine Zeile mit Uhr und Phase: „Build läuft seit 0:42 · schreibt die Seiten“. Die Phasen sind bereitet vor, liest die Notizen und schreibt die Seiten — solange die Uhr weiterläuft, hängt nichts.
Dieselbe Zeile steht auf der Übersicht, und sie bleibt, wenn man zwischendurch eine andere Seite öffnet. Ein zweiter Klick auf Jetzt bauen während eines Builds startet keinen zweiten, er wartet auf den laufenden. Der Dev-Server zeigt beim Start und nach jeder Änderung dieselbe Art Zeile in seiner eigenen Karte — nach einem Speichern in QuartzControl dauert sie fast so lange wie sein Start, weil er dann alles neu baut. Läuft gerade ein Build, bleibt dessen Zeile stehen.
Was danach dasteht
Die Karte zeigt, wann zuletzt gebaut wurde und wie viele Dateien im Ausgabeordner liegen — oder „Noch nie gebaut“. Ein Button öffnet den Ordner.
Darunter die Ausgabe des Builds, mit Ergebnis und Dauer: Erfolgreich in 4 s oder Fehlgeschlagen. Bei einem Fehlschlag steht der Grund darüber.
Der Ausgabeordner
Der einmalige Build mit Ausgabeordner, Dateizahl und Ergebnis.
Voreinstellung ist public/ im Projekt. Wer es ändert, sollte zwei Sätze gelesen haben, die auch
in QuartzControl stehen:
Jeder Build leert diesen Ordner vorher vollständig.
Gilt auch für Veröffentlichen: Dort wird aus demselben Ordner hochgeladen.
Der erste ist der wichtige. Ein Build ist kein Hinzufügen, sondern ein Ersetzen; was vorher darin lag, ist danach weg.
Deshalb prüft QuartzControl den Ordner, bevor es ihn benutzt. Liegen darin Dateien, die nicht nach einem Build aussehen, sagt es das mit der Zahl dazu und fragt nach:
Darin liegen 12 Einträge, die nicht nach einem Quartz-Build aussehen. Jeder Build löscht seinen Ausgabeordner vollständig. Das lässt sich nicht rückgängig machen.
Und manche Ordner lehnt sie ganz ab — den Projektordner selbst etwa. Dann nennt sie den Grund und schlägt einen eigenen Ordner vor.
Wann sich ein Build lohnt, obwohl der Server läuft
Drei Fälle:
- Vor dem Veröffentlichen. Was hochgeladen wird, ist der Inhalt des Ausgabeordners — nicht das, was der Dev-Server gerade im Speicher hat.
- Um Variablen einzulesen. Der Variablen-Tab kann anzeigen, was Theme und Plugins tatsächlich erzeugen — dafür braucht er einen Build.
- Zum Prüfen. Ein Build meldet Fehler, die der Server beim inkrementellen Bauen übergeht.