Cum să publicați o pagină Github

Paginile Github permit dezvoltatorilor să găzduiască gratuit un site web static al proiectului lor. Este una dintre facilitățile cheie ale Github care a făcut menținerea gratuită a proiectelor open source mai economice, mai ales pentru dezvoltatorii independenți.

Bootstrap și Normalize.css sunt câteva pagini populare Github. Pentru a crea una, trebuie doar să creați o nouă filială a depozitului de proiecte și să o numiți GH-pagini. Publicați sucursala la Github.

Odată ce site-ul este sus, site-ul este accesibil prin adresa URL care este setată în funcție de numele dvs. de utilizator Github, precum și numele repozitorului. Username .github.io / depozit-name.

Puteți configura un domeniu personalizat pentru pagina dvs. Github. Am arătat-o ​​cum să facem acest lucru în tutorialul nostru anterior.

Pagini Github simplificate

Crearea unei pagini Github este ușor și rapidă. Dar există o mică avertizare.

Luați unul dintre arhivele demo în contul nostru Github, Calendar Advent, de exemplu. Avem două ramuri - maestru și GH-pagini care împărtășesc exact aceleași ramuri de cod.

Trebuie să ne asigurăm că codurile din GH-pagini sunt întotdeauna sincronizate cu maestru ramură.

Din fericire, Github a făcut recent simplificarea eliminării GH-pagini cerință de sucursală. Acum putem alimenta site-ul direct prin maestru ramură.

Pentru a face acest lucru, mergeți la oricare din ecranul Setări pentru depozitele Github. Derulați în jos până la secțiunea Pagini Github și selectați ramura principală meniu din selecție.

Sunteți setați și puteți elimina în siguranță GH-pagini ramură din depozit.

Servirea documentației

Unele proiecte, cum ar fi Bootstrap, Foundation sau Skeleton, necesită o pagină de documentare. Și dezvoltatorii lor, de obicei, servesc, de asemenea, aceste pagini de documentare prin GH-pagini document.

Deci, depozitul are acum două ramuri cu un set complet diferit de coduri și scopuri; unul este sursa principala, în timp ce cealaltă documentația gazdă precum și câteva fragmente de cod. În această situație, puteți găsi adesea conflicte de schimbare atunci când comutați între aceste două filiale.

Odată cu această nouă modificare de la Github, dezvoltatorii pot acum să difuzeze paginile de documentare printr-un nume de folder / docs / în cadrul maestru ramură. Apoi, accesați paginile Github și selectați următoarea opțiune, directorul / dosarul principal.

Acum, menținerea codului sursă și a documentației a devenit mai puternic.