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.

Graphansicht

1.5 – Die erste Website

3 Min. Lesezeit

Ein Durchgang, der wirklich funktioniert. Jeder Schritt hat später ein eigenes Kapitel; hier steht nur, was zu tun ist, und in welcher Reihenfolge.

Gerechnet werden sollte mit ein bis zwei Minuten Wartezeit in Schritt 2 — dabei wird Quartz heruntergeladen und dessen Abhängigkeiten werden installiert.

1. Notizen bereitlegen (oder nicht)

Wer schon einen Obsidian-Vault oder einen Ordner mit Markdown-Dateien hat: gut, der Pfad wird gleich gebraucht. Wer nicht: auch gut — QuartzControl legt einen leeren Content-Ordner mit einer Startseite an.

2. Projekt anlegen

Auf der Startseite Neues Projekt erstellen. Der Assistent fragt der Reihe nach:

  1. Wo soll das Projekt liegen? Ein Ordner, den es schon gibt, etwa „Dokumente“.

  2. Name des Projektordners. Nur der Ordnername — nicht der Titel der Website. Kleinbuchstaben und Bindestriche sind am einfachsten. Darunter zeigt QuartzControl, welcher Pfad daraus wird.

  3. Quartz-Grundgerüst. Welche Beispielseiten und Grundeinstellungen Quartz mitbringt; default ist der normale Startpunkt.

  4. Woher kommen die Notizen? Die wichtigste Frage des Assistenten — drei Antworten:

    • Neu anfangen — ein leerer Content-Ordner im Projekt.
    • Vorhandene Notizen kopieren — eine zweite, unabhängige Sammlung entsteht.
    • Auf vorhandene Notizen verweisen — der Content-Ordner wird eine Verknüpfung auf den gewählten Ordner. Geschrieben wird weiter dort, etwa in Obsidian.

    Umstellen lässt sich das später (siehe Kapitel 3), aber richtig entschieden spart Arbeit.

  5. Wie sind deine Wikilinks geschrieben? Nur bei kopierten oder verknüpften Notizen. Obsidian benutzt in der Voreinstellung die kürzeste Form; passt die Einstellung nicht zu den Notizen, finden die Links ihr Ziel nicht.

  6. Basis-URL. Die spätere Adresse, ohne https://. Wer sie nicht kennt, lässt localhost stehen und trägt sie später nach.

  7. Basis-Template mitinstallieren. Eine fertige Gestaltung — Farben für hell und dunkel, eigene Seitenraster, selbst gehostete Schriften, jede Komponente einzeln gestaltet, auch die, die zunächst ausgeschaltet sind. Empfehlenswert für den ersten Versuch, und hinterher überall änderbar. Die zugehörigen Beispielseiten sind nur wählbar, wenn der Content-Ordner neu angelegt wird: In fremde Notizen schreibt eine Vorlage nichts.

Dann Projekt anlegen und warten.

3. Vorschau starten

Nach dem Anlegen führt der Weg ins Projekt. In der Seitenleiste Veröffentlichung → Vorschau & Build, dort den Server starten. QuartzControl baut die Website und macht sie unter http://localhost:8080 erreichbar — oder unter dem nächsten freien Port, falls 8080 schon belegt ist; die Seite zeigt die Adresse. Die Ausgabe des Bauvorgangs steht darunter.

Ab jetzt gilt: Jede Änderung an einer Notiz baut die Seite neu. Wer den Content-Ordner mit einem Vault verknüpft hat, schreibt in Obsidian und sieht das Ergebnis im Browser.

Der Dev-Server läuft weiter, auch wenn man das Projekt verlässt — und auf Wunsch auch, wenn man QuartzControl beendet.

4. Etwas ändern

Zwei Dinge, die sich sofort lohnen:

  • Einrichtung → Konfiguration: Titel der Website und Sprache der festen Textbausteine.
  • Gestaltung → Stile: die Grundfarben für hell und dunkel.

Beides wird erst mit Speichern wirksam. Der laufende Server merkt es und baut neu.

5. Veröffentlichen — später

Dafür braucht es einen Ort, an dem die Website liegen soll, und die Zugangsdaten dorthin. Wie das geht, steht in Kapitel 6; nichts davon ist nötig, um die eigene Seite erst einmal lokal zu bauen und anzusehen.

Was du jetzt weißt

Ein Projekt ist ein Ordner. Der Content-Ordner sagt, woher die Notizen kommen. Der Server zeigt das Ergebnis. Alles andere in diesem Handbuch verfeinert diese drei Sätze.