So veröffentlichen Sie eine Github-Seite

Mit Github Pages können Entwickler eine statische Website ihres Projekts kostenlos hosten. Es ist eine der wichtigsten Einrichtungen von Github, die die Pflege freier Open-Source-Projekte insbesondere für Indie-Entwickler wirtschaftlicher macht.

Bootstrap und Normalize.css sind einige beliebte Github-Seiten. Um eines zu erstellen, müssen Sie nur einen neuen Zweig Ihres Projekt-Repositorys erstellen und es als gh-pages . Veröffentlichen Sie die Zweigstelle in Github.

Sobald es verfügbar ist, ist die Website über die URL zugänglich, die relativ zu Ihrem Github-Benutzernamen sowie dem Repository-Namen festgelegt ist. {username}.github.io/{repository-name} .

Sie können eine benutzerdefinierte Domain für Ihre Github-Seite einrichten. Wir haben es in unserem vorherigen Tutorial gezeigt.

Github Seiten vereinfacht

Das Erstellen einer Github-Seite ist einfach und schnell. Aber, es gibt eine kleine Einschränkung.

Nehmen Sie eines der Demo-Repositories in unserem Github-Account, zum Beispiel den Adventskalender. Wir haben zwei Zweige - master und gh-pages, die genau die gleichen Code-Zweige teilen.

Wir müssen sicherstellen, dass die Codes in gh-pages immer mit dem master Zweig synchronisiert sind.

Glücklicherweise hat Github es kürzlich einfacher gemacht, indem es die gh-pages Zweiganforderung entfernt hat. Wir können nun die Site direkt durch den master Zweig füttern.

Wechseln Sie dazu zu einem der Github-Repository-Einstellungen. Scrollen Sie nach unten zum Abschnitt "Github-Seiten" und wählen Sie das Master- Zweigmenü aus der Auswahl aus.

Sie sind alle eingestellt und können den Zweig gh-pages sicher aus dem Repository entfernen.

Dokumentation bereitstellen

Einige Projekte wie Bootstrap, Foundation oder Skeleton erfordern eine Dokumentationsseite. Und ihre Entwickler bieten diese Dokumentationsseiten normalerweise auch über das gh-pages Dokument an.

So hat das Repository jetzt zwei Zweige mit einem völlig anderen Satz von Codes und Zweck; Einer ist die Hauptquelle, während der andere eine Host-Dokumentation und auch einige Code-Schnipsel enthält. In dieser Situation finden Sie häufig Änderungskonflikte, wenn Sie zwischen diesen beiden Zweigen wechseln.

Mit dieser neuen Änderung von Github können Entwickler jetzt Dokumentationsseiten über einen Ordnernamen /docs/ innerhalb der master Zweigstelle /docs/ . Gehen Sie dann zu den Github-Seiten und wählen Sie die nächste Option, den Zweig / docs-Ordner .

Jetzt ist der Quellcode und die Dokumentation immer strikter geworden.