Sivuston kehitysdokumentaatio
Sivusto rakentuu GitHub Pages palvelulle, Hacker-teemalle (millekä muullekaan tällaisella kurssilla?) ja MarkDown-kielelle. Hacker-teema käyttää lisenssiä CC0 joka mahdollistaa teeman vapaan muokkaamisen.
Sivuston konfiguraatio
Sivuston konfiguraatio löytyy tiedostosta _config.yml. Sivusto buildataan tämän tiedoston pohjalta GitHub Pages sivuksi. Tehtyjä muutoksia _config.yml:ssä ovat:
- Sisällysluettelogeneraattori:
markdown: kramdown- Mahdollistaa md-sivulla sisällysluettelon generoimisen koodilla {:toc}
Sivuston navigaatio
Hacker-teema ei tarjoa valmista navigaatioratkaisua. Sivunavigaatio olisi vaikuttanut luonnolliselta vaihtoehdolta, mutta kapeat näyttöleveydet tai laitteet olisivat vaatineet kunnollisen responsiivisen ratkaisun, joten päädyin ylänaviin joka on vain keskitetty.
- Navigaation mallina käytetty David J. Birnbaumin ratkaisua
- _includes-kansio sisältää nav.html:n joka puolestaan saadaan käyttöön _layouts-kansiossa olevaa default.html:ään lisäämällä {% include nav.html %} header-elementin loppuun.
Taulukot
Markdown taulut lisäosa GH Pagesille (valmiina): https://github.github.com/gfm/#tables-extension-
Koodiblokit
Koodiblokeissa käytössä syntaksin korostus (valmiina): https://www.markdownguide.org/extended-syntax/#syntax-highlighting
Erikoismerkit
Markdown parser jättää erikoismerkit {% raw %}{% endraw %} blokkien sisällä käsittelemättä ja esittää ne sellaisenaan: https://github.com/Shopify/liquid/wiki/Liquid-for-Designers/#raw
Statistiikan kerääminen
Sivuille voisi harkita oman statistiikkapalvelimen pystyttämistä huvin ja urheilun kannalta jos aikaa riittää.