Jak publikovat stránku Github

Stránky Github umožňují vývojářům hostit statické webové stránky svého projektu zdarma. Je to jedno z klíčových zařízení společnosti Github, díky němuž je udržování bezplatných open source projektů ekonomičtější, zejména pro nezávislé vývojáře.

Bootstrap a Normalize.css jsou pár populárních stránek Github. Chcete-li jej vytvořit, stačí vytvořit novou větev úložiště projektu a zavolat ji gh-pages. Publikovat pobočku Github.

Jakmile je stránka hotová, je dostupná prostřednictvím adresy URL, která je nastavena vzhledem k vašemu uživatelskému jménu Github a názvu úložiště. username .github.io / repository-name.

Pro stránku Github můžete nastavit vlastní doménu. Ukázali jsme, jak to udělat v našem předchozím tutoriálu.

Zjednodušené stránky Github

Vytvoření stránky Github je snadné a rychlé. Ale je tu malá námitka.

Vezměte si jeden z demo repozitářů v našem Github účtu, například Adventním kalendáři. Máme dvě pobočky - mistr a gh-pages které sdílejí přesně stejné kódové větve.

Musíme se ujistit, že kódy v gh-pages jsou vždy synchronizovány s mistr větev.

Naštěstí Github to nedávno učinil jednodušším odstraněním gh-pages požadavku pobočky. Můžeme nyní místo toho nakrmit místo přímo přes mistr větev.

Chcete-li tak učinit, přejděte na libovolnou obrazovku Nastavení úložiště Github. Přejděte dolů do sekce Stránky Github Pages a vyberte možnost hlavní větve menu.

Všichni jste nastaveni a můžete bezpečně odstranit gh-pages pobočky z úložiště.

Podávání dokumentace

Některé projekty jako Bootstrap, Foundation nebo Skeleton vyžadují stránku s dokumentací. A jejich vývojáři obvykle také slouží těmto dokumentačním stránkám gh-pages dokument.

Repozitář má nyní dvě větve s úplně odlišným souborem kódů a účelu; jeden je hlavní zdroj, zatímco druhá dokumentaci hostitele a také některé úryvky kódu. V této situaci často dochází ke změně konfliktů při přepínání mezi těmito dvěma pobočkami.

S touto novou změnou od společnosti Github mohou nyní vývojáři poskytovat dokumentační stránky prostřednictvím názvu složky / docs / v rámci mistr větev. Poté přejděte na stránku Github Pages a vyberte další možnost, složka master / docs.

Nyní, udržování zdrojového kódu a dokumentace se stalo více stremalined.