GitHub Pages dla każdego repozytorium

GitHub Pages nie muszą być tylko blogiem czy naszą stroną domową. Równie ważne jest tworzenie dokumentacji projektowej.

Lub po prostu więcej stron powiązanych z naszą stroną domową.

Page może być stworzony z brancha master lub gh-pages lub z folderu /docs na branchu master.

Dokuemntacja GitHub konfiguracji Pages

Mnie podoba się rozwiązanie z dedykowanym branchem.

I tą opcję wybrałam tworząc podstronę z opisem wydarzeń Śląskiej Grupy Microsoft.

Stworzenie brancha gh-pages 

automatycznie dodaje konfigurację włączonych Pages

Adres domyślny do naszej strony składa się z głównego adresu pages czyli NazwaKonta.github.io +
nazwa repozytorium czyli w przykładzie, który używam to  https://slaskagrupamicrosoft.github.io/meetingshistory/

Od strony GitHubato już wszystko.

Teraz jednak zaskoczył mnie Jekyll i konfiguracja, która zdawała się w ogóle nie działać. I to tak dziwnie - zawartość była, ale theme jakby gubił ścieżkę, jakby nie ładowały się wszystkie cssy i skrypty.

To dlatego że dokładnie tak było. Ustawienia wskazywały na domyślną stronę (na której już
funkcjonowała inna strona z innym schematem strony niż oczekiwany na
podstronie) wystarczy ustawić w _config.yml zmienna base url:

baseurl: "/meetingshistory" # the subpath of your site, e.g. /blog

url: "" # the base hostname & protocol for your site

To praktycznie jedyna wymagana konfiguracja.

W ten sposób każde repozytorium może mieć swoją stronę z dowolnym theme. Może to być proste MD a może to być rozbudowana dokumentacja czy kolejna śliczna strona.