GitHub Pages Einrichten#

Mithilfe dieser Anleitung kann GitHub Page eingerichtet werden.

GitHub Pages ist ein Hosting-Service für statische Webseiten, der HTML-, CSS- und JavaScript-Dateien direkt aus einem Repository auf GitHub übernimmt, die Dateien optional durch einen Build-Prozess führt und eine Website veröffentlicht.

Um GitHub Pages zu aktivieren, muss man Administratorrechte besitzen. Wenn diese vorhanden sind, dann sollte in der Taskleiste als letzte Option Settings zu sehen sein. Nach dem Öffnen der Einstellungen sollte unter dem linken Menüpunkt Code and automation die Option Pages auffindbar sein.

Die einfachste Methode ist, unter Build and deployment die Option Deploy from a branch auszuwählen. Folglich muss daraufhin der Branche ausgewählt werden, in welcher sich die Dokumentation befindet. Normalerweise befindet sich die Dokumentation in einem Unterordner (/docs), weswegen dort der dementsprechende Pfad angegeben werden muss.

Nach dem Speichern kann es 5 - 10 Minuten dauern, bis die Webseite aufrufbar ist. Auch nach einem Commit dauert es einige Zeit, bis die Änderungen angezeigt werden. Die URL zur Seite erscheint nach der Wartezeit unter der im Bild gezeigten Seite. Zusätzlich wird eine Action erstellt, mit welcher der Status der Seite angezeigt werden kann.