Markdown Instructeur¶
Markdown is een eenvoudige opmaaktaal waarmee je tekst opmaakt met een minimale, leesbare syntax. Exercises worden in Markdown opgeslagen.
Visuele editor
De Exercise Editor is een visuele editor: je hoeft geen Markdown te kennen.
Via het /-menu voeg je alle blokken op deze pagina in. Deze pagina is vooral handig als je liever direct in
Markdown werkt (zet daarvoor in je profiel → Instellingen de Markdown editor aan), of als je wilt weten hoe een
blok werkt.
Code blocks¶
Standaard ondersteunt Markdown code blocks. In NexEd is dit ook ondersteund met diverse programmeertalen, zoals hieronder een voorbeeld in JavaScript:
```javascript
var s = "JavaScript syntax highlighting";
alert(s);
```
Daarnaast hebben we een aantal NexEd-specifieke code blocks:
```info
Dit is een info block, hierin kan je extra informatie voor de student plaatsen.
```
```warn
Dit is een warn block, hierin kan je waarschuwingen voor de student plaatsen.
```
```error
Dit is een error block, is warning niet ernstig genoeg? Dan kan je een error block gebruiken.
Gebruik dit spaarzaam.
```
```success
Dit is een success block, bijvoorbeeld om te laten zien dat iets goed is gegaan.
```
```steps
1. Dit is een steps block.
2. Hier in plaats je genummerde stappen.
3. Voor de student om te doorlopen tijdens de exercise.
```
Afbeeldingen en video's¶
Op plekken waar je visuele media kan uploaden (zoals in de Exercise Editor), is er ook een knop beschikbaar om je in één keer een stukje HTML inclusief URL te geven zodat je je media kan tonen. (1) Plak dit stukje code vervolgens ergens in een tekstvak:
Klik hier om te bekijken hoe dit in de Exercise Editor werkt.
<img src="https://app.nexed.com/assets/images/growth.png" width="500"/>
Breedte aanpassen
Afbeeldingen of video's zonder gedefineerde width attribuut kunnen tot maximaal de grootte van hun container groeien. Je kan de breedte aanpassen door het width attribute te wijzigen.
Overig¶
Tevens kan je de uitlijning van de afbeelding aanpassen door een class in de img te zetten. Hierin heb je de keuze uit left en right.
<img src="https://app.nexed.com/assets/images/laptop.png" width="250" class="right"/>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et euismod nulla. Curabitur feugiat, tortor non consequat finibus, justo purus auctor massa, nec semper lorem quam in massa.
Wil je zorgen dat een volgend stuk tekst onder de afbeelding eindigt? Plaats dan eerst een HTML element met de clear class erop, zoals:
<div class="clear"> </div>
Let ook hier op!
- Manipuleer de URL's niet handmatig, omdat dit tot autorisatieproblemen kan leiden.
- Wees heel voorzichtig met URL's van andere exercises of Self diagnostics te gebruiken. Als een student geen toegang heeft tot die exercise kan de student die afbeelding niet laden.
Emoji's¶
In Markdown kun je emoji's invoegen met shortcodes (1) door een dubbele punt aan het begin en einde van de emoji-naam te zetten. Voorbeelden van emoji-shortcodes in Markdown:
- Je kunt een lijst met beschikbare emoji’s vinden op GitHub Emoji Cheatsheet.
:rocket:🚀:tada:🎉:warning:⚠️
Emoji's kan je ook direct inladen via Unicode. 🔥
Tabbladen¶
Tabbladen worden standaard niet ondersteund in Markdown, maar in NexEd is dit wel beschikbaar.
# Tab 1 {.tabset}
## Dit is tab 1
Hier staat alle content van tab 1.
# Tab 2
## Dit is tab 2
Hier staat alle content van tab 2.
# Tab 3
## Dit is tab 3
Hier staat alle content van tab 3.
{.endtabset}
Ook worden tabbladen voor specifieke operating systems ondersteund. Deze groep zal automatisch de tab die bij jouw operating systeem hoort openen.
# Tab voor Windows {.tabset}{.tab-windows}
Dit is een tab specifiek voor Windows.
# Tab voor Linux {.tab-linux}
Dit is een tab specifiek voor Linux.
# Tab voor Mac OS {.tab-mac}
Dit is een tab specifiek voor Mac.
{.endtabset}
Accordion¶
Ook dit wordt standaard niet ondersteund in Markdown, maar in NexEd is dit wel beschikbaar.
# Tab 1 {.accordion}
Hier staat alle content van tab 1 je kan hierbinnen naar hartelust andere markdown gebruiken.
# Tab 2
Hier staat alle content van tab 2.
# Tab 3
Hier staat alle content van tab 3.
{.endaccordion}
Meerkeuzevragen¶
Sommige theorie opdrachten bevatten veel uitleg, soms net iets te veel om in één keer goed te snappen. Het kan dan helpen om de grote hoeveelheid theorie op te splitsen in kleinere blokken en per blok te controleren of de student het nog allemaal snapt.
Met het meerkeuzecomponent kan je overal in een theorie exercise een meerkeuzevraag toevoegen. Totdat de student de vraag goed beantwoordt, blijft de tekst na de vraag onleesbaar.
Toelichting syntax
Met OK geef je aan welk antwoord het juiste antwoord is. Let op dat er maar één correct antwoord kan zijn.
{question:Welke getallen worden in een binair systeem gebruikt?}
- OK 0, 1
- 0, 1, 2, 3
- 1, 2
- 0, 1, 2, 3, 4, 5, 6, 7, 8, 9
Dit is een optionele toelichting die wordt getoond als het antwoord correct is aangekruist.
{/question}
Video's, bestanden en embeds¶
In de visuele editor voeg je deze in via het /-menu. In Markdown ziet dat er zo uit:
{youtube id="dQw4w9WgXcQ"}{.endyoutube}
{file-block src="https://..." name="startbestanden.zip"}{.endfileblock}
{iframe src="https://..." title="Oefening" height="600" fullscreen="false"}{.endiframe}
Embeds
Een iframe toont een externe webpagina in de exercise. Gebruik alleen bronnen die je vertrouwt en die voor studenten van alle scholen bereikbaar zijn.