Sådan publiceres en Github-side
Github Pages tillader udviklere at være vært for en statisk hjemmeside for deres projekt gratis. Det er en af Githubs nøglefaciliteter, der har gjort opretholdelse af frie open source-projekter mere økonomiske især for indie-udviklere.
Bootstrap og Normalize.css er et par populære Github-sider. For at oprette en behøver du kun at oprette en ny gren af dit projektopbevaringssted og kalde det gh-pages
. Udgiv filialen til Github.
Når det er op, er webstedet tilgængeligt via URL'en, der er angivet i forhold til dit Github-brugernavn samt opbevaringsnavnet. Username .github.io / repository-navn
.
Du kan opsætte et brugerdefineret domæne til din Github-side. Vi har vist det, hvordan du gør det i vores tidligere vejledning.
Github Sider Forenklet
Oprettelse af en Github-side er let og hurtigt. Men der er en lille advarsel.
Tag en af demo-lagrene i vores Github-konto, Advent Calendar, for eksempel. Vi har to grene - mestre
og gh-pages
som deler nøjagtig samme kodenafdelinger.
Vi skal sørge for, at koderne i gh-pages
er altid synkroniseret med mestre
afdeling.
Heldigvis har Github for nylig gjort det enklere ved at fjerne gh-pages
filial krav. Vi kan nu i stedet foder webstedet direkte gennem mestre
afdeling.
For at gøre det skal du gå til et af dine Github repository Settings skærmbillede. Rul ned til sektionen Githubsider, og vælg master branchen menu fra udvælgelsen.
Du er helt indstillet og kan sikkert fjerne gh-pages
filial fra depotet.
Betjener dokumentation
Nogle projekter som Bootstrap, Foundation eller Skeleton kræver en dokumentationsside. Og deres udviklere serverer normalt også disse dokumentations sider gennem gh-pages
dokument.
Så har bevarelsen nu to grene med et helt andet sæt koder og formål; den ene er den hovedkilde, mens den anden værtsdokumentationer og også nogle kodestykker. I denne situation kan du ofte finde forandringskonflikter, når du skifter mellem disse to grene.
Med denne nye ændring fra Github kan udviklere nu betjene dokumentationssider gennem et mappenavn / docs /
indenfor mestre
afdeling. Gå derefter til Github Pages og vælg den næste mulighed, master filial / docs mappe.
Nu er opretholdelsen af kildekoden og dokumentationen blevet mere stremalineret.