Hoe een Github-pagina te publiceren

Met Github-pagina's kunnen ontwikkelaars gratis een statische website van hun project hosten. Het is een van Github's belangrijkste faciliteiten die het onderhoud van gratis open-sourceprojecten zuiniger heeft gemaakt, vooral voor indie-ontwikkelaars.

Bootstrap en Normalize.css zijn een aantal populaire Github-pagina's. Om er een te maken, hoeft u alleen maar een nieuwe tak van uw projectrepository aan te maken en deze te bellen gh-pagina's. Publiceer de branch naar Github.

Als het eenmaal zover is, is de site toegankelijk via de URL die is ingesteld ten opzichte van uw Github-gebruikersnaam en de naam van de repository. Username .github.io / repository-name.

U kunt een aangepast domein instellen voor uw Github-pagina. We hebben het laten zien hoe dit te doen in onze vorige tutorial.

Github-pagina's vereenvoudigd

Een Github-pagina maken is gemakkelijk en snel. Maar er is een kleine waarschuwing.

Neem bijvoorbeeld een van de demo-repository's in ons Github-account Adventskalender. We hebben twee takken - meester en gh-pagina's die exact hetzelfde delen van codetakken.

We moeten ervoor zorgen dat de codes in gh-pagina's zijn altijd gesynchroniseerd met de meester tak.

Gelukkig heeft Github het onlangs eenvoudiger gemaakt door de gh-pagina's tak vereiste. We kunnen de site nu rechtstreeks via de feed doorsturen meester tak.

Om dit te doen, ga naar een van uw Github repository Instellingen scherm. Blader omlaag naar het gedeelte Github-pagina's en selecteer de hoofdtak menu uit de selectie.

U bent helemaal klaar en kunt het veilig verwijderen gh-pagina's branch van de repository.

Presentatie van documentatie

Voor sommige projecten, zoals Bootstrap, Foundation of Skeleton, is een documentatiepagina vereist. En hun ontwikkelaars dienen deze documentatiepagina's meestal ook via de gh-pagina's document.

Dus de repository heeft nu twee takken met een compleet andere reeks codes en doel; een is de hoofdbron, terwijl de andere hostdocumentaties en ook enkele codefragmenten. In deze situatie vindt u vaak veranderingsconflicten bij het schakelen tussen deze twee branches.

Met deze nieuwe wijziging van Github kunnen ontwikkelaars nu documentatiepagina's aanbieden via een mapnaam / Docs / binnen de meester tak. Ga vervolgens naar de Github-pagina's en selecteer de volgende optie, hoofdtak / docs map.

Het onderhouden van de broncode en documentatie is nu meer in de openbaarheid komen te staan.