Aan de slag

13. Aan de slag#

We gaan er vanuit dat je een Github account hebt (aangemaakt). Die heb je nu nodig…

13.1. Maken van eigen template boek#

Volg de volgende stappen uit deze animatie, hieronder stapsgewijs uitgewerkt:

../_images/teachbooks-template.gif

  1. Ga naar deze repository

  2. Klik op de groene use this template en klik create a new repository.

  3. Kies de naam voor je repository, en kies voor de optie public.

  4. In je repository, klik links op pages en kies voor Github actions

../_images/set_up_pages.png

  1. Klik op code en klik op het tandwiel (bij About) aan de rechterkant van het scherm.

  2. Vink Use your GitHub Pages website aan.

  3. Ga naar actions in het bovenste menu, klik op de (rode) inital commit en klik op re-run all jobs

Het boek wordt nu nog een keer aangemaakt en ingeladen in de githubpages.

../_images/rerunjobs.PNG

Fig. 13.1 Als het boek bouw proces klaar is zijn alle bolletjes groen gekleurd.#

  1. Ga via de link (code, rechterkant onder About) naar de GitHub page waar het boek online gezet wordt.

  2. De output is gelijk aan Figuur 13.2 hieronder.

../_images/templateboekoutput.PNG

Fig. 13.2 De output van het boek zoals dat op GitHub pages staat.#

13.2. Github Actions to deploy the book#

De TeachBooks tool is zo gemaakt dat het omzet van de markdown (en eventueel notebook) files naar een HTML pagina automatisch gedaan wordt nadat er een verandering op GitHub gedaan wordt (een commit). Alhoewel de precieze werking voor nu niet van belang is, wordt er meer in deze documentatie verteld over de precieze workflow die gebruik wordt.

Contents