This is a Python script which can be run to scaffold a Canvas course. Instructions on how to use can be found below.
ℹ️ For more information, contact me at [email protected].
Het script maakt het mogelijk om volgende zaken in een Canvas cursus te configureren aan de hand van een Excel-bestand:
- Startpagina van de cursus
- Modules
- Opdrachten
- Toetsen
- Bestanden
Na gebruik zal bijvoorbeeld je startpagina er als volgt uit zien (uiteraard zijn teksten aanpasbaar):
- Enige kennis van Python
- Enige kennis van HTML en CSS
- Een Canvas API token (zie verder)
- Installeer Python 3.8 of hoger
- Open een terminal (in de map van de repository)
- Voer het volgende commando uit:
pip install -r requirements.txt
- Ga naar Canvas en log in
- Klik op Account > Instellingen
- Scroll naar beneden tot je bij Goedgekeurde integraties komt
- Klik op Nieuw toegangstoken
- Geef het token een naam (doel) en klik op Toegangstoken genereren
- Kopieer het token en bewaar het op een veilige plaats
- [Optioneel: Bewaar de API token in een environment variable met de naam CANVAS_API_KEY]
Een voorbeeld van een token ziet er als volgt uit: 13183~cnTzlTlJlQfd3CQOYkfKPKu933hu2p9LQmFqKjdbYTvOEaiY9Rt6WjyQMEOS0gTG
.
Het script verwacht een Excel bestand met de naam config.xlsx
in een map naar keuze. De mappenstructuur ziet er daarna als volgt uit:
data
├── config.xlsx
├── afbeeldingen
│ ├── image1.png
│ ├── ...
├── bestanden
│ ├── voorbeeld.txt
│ ├── ...
├── opdrachten
│ ├── opdrachtbeschrijving.html
│ ├── ...
├── paginas
│ ├── leerdoelen.html
│ ├── ...
afbeeldingen/banner_TM.png
is de banner die onderaan de cursuspagina komt te staan.paginas/leerdoelen.html
is de pagina met de leerdoelen. Deze wordt toegevoegd aan de studiewijzer.paginas/planning.html
is de pagina met de planning. Deze wordt toegevoegd aan de studiewijzer.paginas/feedback_en_begeleiding.html
is de pagina met de feedback en begeleiding. Deze wordt toegevoegd aan de studiewijzer.paginas/toetsing.html
is de pagina met de toetsing. Deze wordt toegevoegd aan de studiewijzer.paginas/studiemateriaal.html
is de pagina met het studiemateriaal. Deze wordt toegevoegd aan de studiewijzer.paginas/cursusinleiding.html
bevat de tekst die wordt weergegeven op de startpagina onder "Over deze cursus".
- Download de repository
- Voorzie de mappenstructuur van de nodige bestanden
- Open een terminal in de map van de repository
- Voer het volgende commando uit:
python index.py
- Volg de instructies in de terminal