Updated Leerkracht: Dwengo‐1 gebruiken (markdown)
Adriaan J.
parent
30fe49c3e4
commit
b2d5db2f3f
1 changed files with 40 additions and 2 deletions
|
|
@ -76,6 +76,44 @@ Door te drukken op op de knop 'leerpad' komen we terecht op de pagina van het le
|
|||
|
||||
Leerpaden zijn trajecten die bestaan uit leerobjecten. Een leerobject kan een stuk tekst zijn met al dan niet een vraag op het einde. De leerobjecten in een leerpad volgen vaak een logische volgorde of gedachtestroom. Van deze leerpaden kun je opdrachten maken.
|
||||
|
||||
## Leerpaden aanmaken
|
||||
## Zelf leerpaden aanmaken
|
||||
|
||||
De kracht van de website komt echt naar boven wanneer je zelf leerpaden leert aanmaken. Dit is echter enkel aangeraden is voor geavanceerde gebruikers. Daarmee wordt bedoeld: gebruikers die ietwat tech-savy zijn. Het is aangeraden om ervaring te hebben met bestanden zippen, JSON en markdown. Dit zijn allemaal zeer simpele dingen die je makkelijk zelf kunt leren online, de rest wordt hier uitgelegd.
|
||||
|
||||
### Leerpaden en leerobjecten
|
||||
|
||||
Een leerpad kun je vergelijken met een uitdeelbundel. Een leerobject kun je dan weer zien als een hoofdstuk/pagina/vraag uit die bundel. Met andere woorden: een leerpad bestaat uit een lijst van leerobjecten. Deze leerobjecten kunnen gewoon volgen op mekaar, of je kunt er een ingewikkeldere structuur in steken. Bijvoorbeeld: als een leerling op een reflectievraag het foute antwoord geeft, kun je die naar het ene leerobject sturen met wat extra herhalingsvragen of bij een juist antwoord gewoon naar het volgende hoofdstuk. Ben je nu al niet meer mee? Geen zorgen, hieronder wordt op al dit dieper ingegaan.
|
||||
|
||||
### Leerobjecten 101
|
||||
|
||||
Zoals hierboven gezegd is een leerobject een pagina uit een leerpad. Hieronder zie je een lijst van leerobjecten uit een leerpad.
|
||||
|
||||
|
||||
|
||||
Maar hoe ziet de structuur er nu uit voor een eigen leerpad? Wel, begin met een map aan te maken. Die mag eender welke naam hebben maar we raden aan om iets herkenbaar te kiezen.
|
||||
|
||||
|
||||
|
||||
Het simpelste leerobject bestaat uit twee bestanden: `content.md` en `metadata.json`. Laat deze name je niet afschrikken, het is niet zo moeilijk als het lijkt. Maak deze bestanden aan in de map die je net hebt aangemaakt.
|
||||
|
||||
|
||||
|
||||
#### content.md
|
||||
|
||||
Eerst gaan we het bestand content.md invullen. Open het bestand met een tekstbewerker (bijvoorbeeld notepad of vscode). Je kunt hierin schrijven wat je wilt in markdown formaat. Dat is een soort word-bestand waar je opmaak doet in de vorm van speciale karakters.
|
||||
Bijvoorbeeld:
|
||||
- een \# voor een lijn maakt er een titel van
|
||||
- woorden tussen \** worden **vet**
|
||||
- foto's kun je invoegen door een foto in de map te plaatsen en er een referentie naar te maken (internet!)
|
||||
Om meer hierover te weten te komen zoek bijvoorbeeld naar "markdown cheatsheet".
|
||||
|
||||
#### metadata.json
|
||||
|
||||
Het bestand metadata.json beschrijft hoe de website moet omgaan met het bestand content.md. Hieronder geven we een voorbeeld invulling. Er wordt verder ingegaan op elke 'property'.
|
||||
|
||||
```json
|
||||
{}
|
||||
```
|
||||
|
||||
|
||||
|
||||
TODO
|
||||
Reference in a new issue