12. Introductie

Een Jupyter Book bestaat uit een collectie pagina’s die opgemaakt zijn met simpele elementen (kopjes, hyperlinks, plaatjes) uit de opmaaktaal MarkDown, aangevuld met interactieve elementen. Met een eenvoudig commando worden die pagina’s omgezet tot een boek (HTML), dat op elke server gehost kan worden. Dit ‘boek’ is een voorbeeld van een Jupyter Book. Hier vind je nog een goed voorbeeld van een online open access Jupyter Book.

Fig. 12.1 Een voorbeeld van een Jupyter Book: het dictaat dat gebruikt wordt in het eerstejaarspracticum aan de opleiding Technische Natuurkunde (Delft).

In deze workshop leer je de basis om je eigen boek te maken. Daarbij maken we gebruik van Teachbooks, een template met veel standaard mogelijkheden voor programmeren in Python en andere interactieve elementen reeds ingebouwd.

De presentatie van de workshop is hier te downloaden.

12.1. Randvoorwaarden

Er zijn een paar dingen die je moet weten / hebben wil je aan de slag gaan met het maken van een online boek:

Programmeer ervaring is niet nodig, maar maakt het een en ander wel makkelijker.

Een account bij Github

Software om je code in te schrijven, zoals VSC

Een beetje geduld, het is een steile leercurve.

Klaar? Laten we beginnen..