Jak opublikować stronę Github

Strony Github pozwalają programistom na prowadzenie statycznej strony internetowej swojego projektu za darmo. Jest to jeden z kluczowych narzędzi Github, dzięki któremu utrzymanie darmowych projektów open source jest bardziej ekonomiczne, zwłaszcza dla niezależnych programistów.

Bootstrap i Normalize.css to kilka popularnych stron Github. Aby je utworzyć, wystarczy utworzyć nową gałąź repozytorium projektu i wywołać ją gh-strony. Opublikuj gałąź w Github.

Po uruchomieniu witryna jest dostępna za pośrednictwem adresu URL ustawionego względem nazwy użytkownika Github oraz nazwy repozytorium. nazwa użytkownika .github.io / nazwa repozytorium.

Możesz ustawić niestandardową domenę dla swojej strony Github. Pokazaliśmy, jak to zrobić w naszym poprzednim samouczku.

Uproszczone strony Github

Tworzenie strony Github jest łatwe i szybkie. Ale istnieje małe zastrzeżenie.

Weź jeden z repozytoriów demo na naszym koncie Github, na przykład w Kalendarzu Adwentowym. Mamy dwa oddziały - mistrz i gh-strony które dzielą dokładnie te same gałęzie kodu.

Musimy się upewnić, że kody w gh-strony są zawsze synchronizowane z mistrz Oddział.

Na szczęście Github ostatnio ułatwił to, usuwając gh-strony wymóg oddziału. Możemy teraz zamiast tego karmić witrynę bezpośrednio przez mistrz Oddział.

Aby to zrobić, przejdź do dowolnego ekranu ustawień repozytorium Github. Przewiń w dół do sekcji Strony Github i wybierz gałąź master menu z wyboru.

Jesteś cały ustawiony i możesz bezpiecznie usunąć gh-strony gałąź z repozytorium.

Udostępnianie dokumentacji

Niektóre projekty, takie jak Bootstrap, Foundation lub Skeleton, wymagają strony z dokumentacją. A ich programiści zazwyczaj obsługują te strony dokumentacji za pośrednictwem gh-strony dokument.

Tak więc repozytorium ma teraz dwie gałęzie o zupełnie innym zestawie kodów i celu; jeden jest główne źródło, podczas gdy drugi dokumentacja hosta a także niektóre fragmenty kodu. W tej sytuacji często mogą wystąpić konflikty zmian podczas przełączania między tymi dwoma gałęziami.

Dzięki tej nowej zmianie od Github programiści mogą teraz obsługiwać strony z dokumentacją za pomocą nazwy folderu / docs / w obrębie mistrz Oddział. Następnie przejdź do stron Github i wybierz następną opcję, folder główny gałąź / docs.

Teraz utrzymanie kodu źródłowego i dokumentacji stało się bardziej płynne.