So veröffentlichen Sie eine Github-Seite
Mit Github Pages können Entwickler kostenlos eine statische Website ihres Projekts hosten. Es ist eine der wichtigsten Funktionen von Github, die die Wartung freier Open Source-Projekte besonders für Indie-Entwickler wirtschaftlicher macht.
Bootstrap und Normalize.css sind ein paar beliebte Github-Seiten. Um einen zu erstellen, müssen Sie lediglich einen neuen Zweig Ihres Projekt-Repositorys erstellen und ihn aufrufen gh-pages. Veröffentlichen Sie den Zweig an Github.
Nach dem Start ist die Site über die URL erreichbar, die relativ zu Ihrem Github-Benutzernamen sowie dem Repository-Namen festgelegt ist. Benutzername .github.io / Repository-Name.
Sie können eine benutzerdefinierte Domäne für Ihre Github-Seite einrichten. Wir haben es in unserem vorherigen Tutorial gezeigt, wie das geht.
Vereinfachte Github-Seiten
Das Erstellen einer Github-Seite ist einfach und schnell. Es gibt jedoch einen kleinen Vorbehalt.
Nehmen Sie eines der Demo-Repositories in unserem Github-Konto, zum Beispiel den Adventskalender. Wir haben zwei Niederlassungen - Meister und gh-pages die die gleichen Codezweige teilen.
Wir müssen sicherstellen, dass die Codes in gh-pages sind immer mit dem synchronisiert Meister Ast.
Glücklicherweise hat es Github kürzlich durch das Entfernen des Moduls vereinfacht gh-pages Branchenanforderung. Wir können die Site jetzt stattdessen direkt durch die Site laden Meister Ast.
Wechseln Sie dazu zu einem beliebigen Bildschirm Ihres Github-Repository-Einstellungen. Blättern Sie nach unten zum Abschnitt Github-Seiten und wählen Sie die Option Hauptzweig Menü aus der Auswahl.
Sie sind fertig und können das Gerät sicher entfernen gh-pages Verzweigung aus dem Repository.
Dokumentation bereitstellen
Für einige Projekte wie Bootstrap, Foundation oder Skeleton ist eine Dokumentationsseite erforderlich. Und ihre Entwickler bieten diese Dokumentationsseiten normalerweise auch über die gh-pages dokumentieren.
Das Repository hat nun also zwei Zweige mit völlig unterschiedlichen Codes und Zwecken. einer ist der Hauptquelle, während der andere Host-Dokumentationen und auch einige Code-Schnipsel. In dieser Situation finden Sie häufig Änderungskonflikte, wenn Sie zwischen diesen beiden Zweigen wechseln.
Mit dieser neuen Änderung von Github können Entwickler Dokumentationsseiten nun über einen Ordnernamen bereitstellen / docs / innerhalb des Meister Ast. Gehen Sie dann zu den Github-Seiten und wählen Sie die nächste Option, Hauptzweig / docs Ordner.
Die Pflege des Quellcodes und der Dokumentation ist jetzt strenger geworden.
