Så här publicerar du en Github-sida

Github Pages tillåter utvecklare att vara värd för en statisk webbplats för sitt projekt gratis. Det är en av Githubs viktigaste anläggningar som har gjort att öppna open source-projekt är mer ekonomiska, särskilt för indieutvecklare.

Bootstrap och Normalize.css är ett par populära Github-sidor. För att skapa en behöver du bara skapa en ny fil i ditt projektförteckning och ringa det gh-pages. Publicera filialen till Github.

När det är klart är webbplatsen tillgänglig via URL-adressen som är inställd i förhållande till ditt Github-användarnamn samt förvarets namn. Username .github.io / repository-namn.

Du kan konfigurera en anpassad domän för din Github-sida. Vi har visat hur vi gör det i vår tidigare handledning.

Githubs sidor förenklad

Skapa en Github-sida är enkelt och snabbt. Men det finns en liten tillflykt.

Ta en av demobutikerna i vårt Github-konto, Advent Calendar, till exempel. Vi har två grenar - bemästra och gh-pages som delar exakt samma kodgrenar.

Vi måste se till att koderna i gh-pages är alltid synkroniserade med bemästra gren.

Lyckligtvis har Github nyligen gjort det enklare genom att ta bort gh-pages grenskravet. Vi kan nu mata webbplatsen direkt via bemästra gren.

För att göra så, gå till någon av din Github-arkivinställningsskärm. Bläddra ner till sektionen Github Sidor och välj huvudgren meny från urvalet.

Du är helt och hållet och kan säkert ta bort gh-pages gren från förvaret.

Betjäna dokumentation

Vissa projekt som Bootstrap, Foundation eller Skeleton kräver en dokumentationssida. Och deras utvecklare brukar också tjäna dessa dokumentationssidor genom gh-pages dokumentera.

Så har förvaret nu två grenar med en helt annan uppsättning koder och ändamål. en är den huvudkälla, medan den andra värddokumentationer och även några kodsedelar. I denna situation kan du ofta hitta förändringskonflikter när du växlar mellan dessa två grenar.

Med den här nya ändringen från Github kan utvecklarna nu betjäna dokumentationssidor genom ett mappnamn / docs / inom bemästra gren. Gå sedan till Github Pages och välj nästa alternativ, master filial / docs mapp.

Nu är upprätthållandet av källkoden och dokumentationen mer begränsad.