Deutsch
Über dieses Handbuch

Dieses Handbuch gehört zu QuartzControl in der Fassung 1.1.0 und erklärt jeden seiner Bildschirme; jeder Bildschirm verweist auf seine Seite hier.

Wie man Notizen schreibt, damit daraus gute Seiten werden, steht im Example-Handbuch.

5.1 – Die Vorschau

Der Dev-Server baut die Website, liefert sie lokal aus und baut bei jeder Änderung an einer Notiz neu. Das ist der Zustand, in dem man schreibt.

Vorschau & Build: Dev-Server, gefundene Server, einmaliger Build.

Starten

Auf Vorschau & Build, oder direkt von der Übersicht aus. Danach steht dort, seit wann er läuft und auf welchem Port.

Unter Server-Einstellungen, aufklappbar, stehen zwei Einstellungen, die sich nur bei gestopptem Server ändern lassen — QuartzControl sagt das auch:

  • Port und WS-Port — der zweite ist der Kanal, über den die Seite von selbst neu lädt. Ist einer davon beim Start belegt, etwa durch den Server eines anderen Projekts, nimmt der Server den nächsten freien; die Konsole sagt, welchen. Zwei Ausnahmen: Läuft für dieses Projekt schon ein Server, den nicht QuartzControl gestartet hat (aus einem Terminal etwa), startet es keinen zweiten, denn beide würden in denselben Ausgabeordner bauen; die Karte Laufende Server auf diesem Rechner zeigt ihn und kann ihn beenden. Und mit Remote-Dev-Host weicht der Server nicht aus, weil ein Tunnel genau diese Ports weiterreicht; ist einer belegt, startet er nicht.
  • Remote-Dev-Host — nur nötig, wenn die Vorschau durch einen Tunnel erreichbar sein soll.

Ansehen

Der laufende Server mit der Live-Vorschau in QuartzControl — hier zeigt sie dieses Handbuch.

Zwei Wege:

  • Im Browser, unter http://localhost:<Port>.
  • In der Live-Vorschau direkt in QuartzControl, mit einer Umschaltung der Breite: Desktop, Tablet, Mobil, volle Breite. Das ist der schnelle Weg, um zu sehen, ob ein Frame auf dem Smartphone noch aufgeht.

Darunter steht die Ausgabe des Vorschau-Servers. Sie ist keine Zierde: Wenn eine Notiz einen Fehler enthält oder ein Plugin sich beschwert, steht es dort.

Eine 404-Seite unter der Adresse der Website

Dann fehlt im Content-Ordner die index.md. Die Seite sagt es über der Karte und führt zu Startseite anlegen.

Wenn er stehen bleibt

Wird der Server unerwartet beendet, sagt QuartzControl das mit dem Exit-Code, und die Übersicht meldet es unter Handlungsbedarf. Der Grund steht fast immer in der Ausgabe darüber — ein Fehler im eigenen CSS ist der häufigste.

Er gehört nicht zum Fenster

Ein laufender Server überlebt das Verlassen des Projekts, und auf Wunsch auch das Beenden von QuartzControl — was dabei passiert, steht in den Einstellungen unter Beim Beenden. Die Startseite zeigt bei jedem Projekt an, ob einer läuft.

Das ist Absicht: Wer QuartzControl zumacht, will nicht unbedingt die Vorschau verlieren, an der im Browser gerade jemand liest.