Home

Welcome to the slo-website wiki!

Opmerkingen, vragen, suggesties, enz. bij de website kun je plaatsen via de "issues"-tab van het project. Hiervoor heb je een (gratis) GitHub-account nodig.

Om de tekst van de website aan te kunnen passen, als lid van een ontwikkelteam, moet je als "collaborator" bij dit project aangemeld worden. Neem daarvoor contact op met .... Ook hiervoor heb je een GitHub-account nodig.

Deze website gebruikt GitHub voor het bewaren van de bestanden, en GitHub Pages voor het publiceren. Een verandering in een pagina in dit GitHub-project resulteert na enige tijd (enkele seconden, meestal) in een verandering van de gepubliceerde website. Dit betekent dat je voorzichtig moet zijn met de "save" functie in de GitHub editor: gebruik eerst de "preview" om het resultaat te beoordelen.

Deze (statische) website gebruikt GitHub Pages via Jekyll. Jekyll genereert de html-bestanden voor de website uit de bronbestanden (.md-bestanden, include-bestanden, enz.). De meeste bronbestanden zijn in het Markdown-formaat (.md). Binnen Markdown kun je, als je dat nodig denkt te hebben, ook rechtstreeks html-code gebruiken.

Zowel de .md- als de .html-bronbestanden worden verwerkt door de Liquid template-machinerie. Deze verwerkt de constructies met accolades, zoals {{ page.title }} en {% if %}.

Elk thema-ontwikkelteam heeft een eigen plek op deze website:

• een "home" pagina <<thema>>.md in /_themas
  • bijvoorbeeld: /_themas/databases.md
• een folder <<thema>> in /_themas
  • bijvoorbeeld: `/_themas/

De thema-pagina bevat de belangrijkste informatie voor bezoekers. In de folder kun je bijvoorbeeld plaatsen:

• download-bestanden voor je thema
• plaatjes
• subpagina's

Een verwijzing naar het bestand hoofdstuk1.pdf in de thema-folder computational-science ziet er in Jekyll/Markdown als volgt uit:

[tekst...]({{ site.baseurl }}/themas/computational-science/hoofdstuk1.pdf)

Merk op dat in dit geval de _ van de _themas-folder verdwenen is.