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

6.2 – GitHub Pages

2 Min. Lesezeit

GitHub Pages ist der Weg, den QuartzControl am weitesten begleitet: Repository anlegen, Ziel einrichten, Pages konfigurieren, eigene Domain, HTTPS — alles aus QuartzControl heraus.

Dafür braucht es einen GitHub-Token mit der Berechtigung repo in den Einstellungen.

1. Ein Repository

Gibt es noch keines, legt Git-Sync eines an: Name, öffentlich oder privat, und es wird gleich als origin eingetragen.

Privat und Pages passen im kostenlosen Konto nicht zusammen

GitHub Pages gibt es für private Repositories nur in den bezahlten Tarifen. Wer über Pages veröffentlichen will, braucht im kostenlosen Konto ein öffentliches Repository. Ändern lässt sich das auf GitHub später.

2. Ein Ziel der Art „Git-Branch“

Anbieter GitHub, dazu der Branch, auf den veröffentlicht wird — üblicherweise gh-pages.

Nicht der Branch, auf dem gearbeitet wird. Ein Deploy ersetzt den Ziel-Branch vollständig durch den aktuellen Build; QuartzControl fragt vor jedem Deploy ausdrücklich danach und lehnt den aktuellen oder den Standard-Branch ab.

3. Pages einrichten

Die Karte GitHub Pages liest den Zustand direkt bei GitHub und zeigt vier Zustände: Veröffentlicht, Wird gebaut, Fehlgeschlagen, Noch nie gebaut.

Sind für das Repository noch keine Pages eingerichtet, legt ein Button sie an und stellt sie auf diesen Branch. Zeigt origin nicht auf github.com, sagt QuartzControl das und verweist auf Git-Sync — von hier aus geht es dann nicht.

4. Eigene Domain und HTTPS

Eigene Domain trägt die Adresse bei GitHub ein, nicht in den Branch. Das ist der entscheidende Unterschied zu einer CNAME-Datei: Sie überlebt jedes Deploy, obwohl das den Branch vollständig ersetzt.

HTTPS erzwingen lässt sich erst einschalten, wenn GitHub das Zertifikat ausgestellt hat — das dauert nach dem Setzen der Domain einige Minuten. Versucht man es zu früh, sagt QuartzControl genau das und schlägt vor, es später noch einmal zu versuchen.

Ohne eigene Domain ist der Schalter gesperrt, und auch das mit Begründung: Eine Adresse auf github.io wird ohnehin immer über HTTPS ausgeliefert.

Andere Anbieter mit demselben Weg

Das Ziel „Git-Branch“ kennt drei Anbieter, und QuartzControl sagt zu jedem, was danach passiert:

  • GitHub — in den Repository-Einstellungen muss Pages auf diesen Branch zeigen.
  • Codeberg — liefert den Branch pages direkt aus; nach dem ersten Push ist die Seite ohne weitere Einstellungen erreichbar.
  • GitLab — der Branch allein veröffentlicht dort noch nichts. Ein CI-Job muss die Dateien als public-Artefakt ausliefern. Der Push funktioniert trotzdem, nur passiert danach nichts von selbst.