Home

Welkom bij de inf2019-wiki!

We beschrijven hier hoe de website georganiseerd is, en hoe je de pagina's kunt aanpassen.

De website inf2019 maakt gebruik van Jekyll en Github Pages:

• https://jekyllrb.com
• https://pages.github.com

Een aanpassing in de bronbestanden (.md-bestanden, enz.) wordt door deze programma's automatisch verwerkt tot een statische html-website.

We gebruiken als

• "staging website": repository infvo/inf2019, website-url: https://infvo.github.io/inf2019/; en als
• "production website": repository ieni/inf2019, website-url: https://ieni.github.io/inf2019/.

Aanpassingen worden eerst uitgetest in de staging website; als dit er goed uit ziet, kun je een "Pull Request" indienen om de veranderingen over te brengen naar de production website. We handelen deze verzoeken handmatig af, maar we proberen dit altijd zo vlot mogelijk te doen.

Markdown

De .md-pagina's zijn geschreven in Markdown; voor niet al te ingewikkelde teksten werkt dit veel handiger dan puur html. In de GitHub-editor kun je "Markdown" instellen; dan krijg je ook een aantal knoppen met veel gebruikte instellingen en een "hulp"-knop bovenin. Bovendien kun je via de "Preview"-tab zien hoe e.e.a. er geformatteerd uitziet.

Meer informatie over (GitHub-)Markdown vind je bijvoorbeeld via:

• https://guides.github.com/features/mastering-markdown/
• https://help.github.com/en/articles/basic-writing-and-formatting-syntax
• https://commonmark.org

Jekyll

Jekyll gebruikt, zoals gezegd, Markdown voor de opmaak van tekst, en daarnaast Liquid als templating engine. Deze laatste wordt onder andere gebruikt voor het opmaken van pagina's, zie bijvoorbeeld de bestanden in _layouts en _includes. Haakjesparen als {{ ... }} en {% ... %} geven het gebruik van Liquid-elementen aan.

• https://jekyllrb.com/docs/liquid/

links

• Voor een absolute interne link gebruik je {{ site.baseurl }}/map/bestand. Voor map gebruik je geen _: deze wordt alleen in de bronversie gebruikt, in de html-versie verdwijnt deze. Voor bestand gebruik je geen .md: het markdown-bestand (.md) wordt omgezet in een html-bestand, de link wordt daarop automatisch aangepast.