Handboek MediaWiki/Extensies/Quiz

Quiz

De quiz-extensie maakt het mogelijk vragen te stellen, waarmee bijvoorbeeld het leren van de inhoud van een les kan worden gecontroleerd. Zie mw:Extension:Quiz voor de originele Engelstalige beschrijving van de extensie.

Installatie

maak een nieuwe directory met de naam "quiz" in de "extensions" directory van de betreffende wiki.
Kopieer de bestanden in de nieuwe directory. De bestanden zijn hier te vinden: Quiz.php en quiz.i18n.php en quiz.js
Voeg deze instructie toe aan het einde van de LocalSettings.php :

require_once 'extensions/Quiz/Quiz.php';

Gebruik van de extensie

Toevoegen van een quiz in een Wikipagina

Rendering

Wikitext

Commentaar

<quiz>
{→ Vraag hier invoegen ←}
</quiz>

De quiz-Tag doet het volgende:

Er worden eerst enige standaard-quiz-opties toegevoegd.
Alles tussen de quiz-tags worden door de quiz-extensie verwerkt en zo mogelijk in vragen omgezet
Onderaan bevindt zich de verbeteringsknop, waarmee de scholier/student, nadat de quiz is beëindigd, de controle en oplossing kan vragen.
Wordt er op de verbeteringsknop gedrukt, dan ziet men 3 verschillende kleuren, die gebruikt worden om aan te geven of de antwoorden juist, verkeerd of niet gegeven zijn
De "Vragen in willekeurige volgorde"-knop zorgt ervoor dat met javascript de vragen in een nieuwe willekeurige volgorde worden gezet.

Theoretisch is het mogelijk, elke vraag van een eigen Quiz-tag te voorzien. Dat neemt dan echter veel plaats in en de correctie/controle werkt dan niet meer zuiver.

Het actuele formaat van de extensie werkt het best met een quiz, waarbij alle vragen tussen een paar van Quiz-tags staan.

Types van vragen

Meerdere mogelijke antwoorden

Rendering Wikitext Commentaar

<quiz>
{ Welke teams stonden bij het
Wereldkampioenschap voetbal 2006
in de finale? }
+ Frankrijk
- Nederland
+ Italië
- Brazilië
- Argentinië>
</quiz>

Dit type van vragen is "Multiple Choice". Hierbij kan ook meer dan een antwoord goed zijn
Dit is de standaardvorm voor een quizvraag (antwoordmogelijkheden met een checkbox). Dezelfde werking kan bereikt worden met | typ="[]" binnen de quizvraag.
Juiste antwoorden krijgen een plusteken, verkeerde een minteken.
Elk symbool, bijvoorbeeld |, +, - en alle andere bijzondere tekens (zie verder) moeten aan het begin van een nieuwe regel staan.

Slechts één antwoord mogelijk

Rendering

Wikitext

Commentaar

<quiz>
{ Wie werd in 2006 in Duitsland 
  Wereldkampioen?
| typ="()" }
- Frankrijk
+ Italië
- Nederland
- België
</quiz>

Hier is slechts een antwoord mogelijk.
Het correcte antwoord kan op elke mogelijke positie staan en wordt met een plusteken gemarkeerd (verkeerde antwoorden wederom met een min-teken).
Symbolen moeten aan het begin van een nieuwe regel staan; tevens zijn er geen spaties toegestaan.

Tabel

Rendering

Wikitext

Commentaar

Punt toegevoegd voor een goed antwoord:
Punten afgetrokken voor een onjuist antwoord:
De coëfficienten van de vragen negeren:

<quiz>
{ Water is bij een standaarddruk
  bij ... °C
| typ="()" }
| vloeibaar | vast | gasvormig
-+- ... onder 0 ...
+-- ... tussen 0 en 100 ...
--+ ... boven 100 ...
</quiz>

Deze vorm van een meervoudige keuzemogelijkheid wordt bereikt door het herhaalde plaatsen van plus- und mintekens aan het begin van de regel.
Er kan slechts een plusteken per regel staan
De kolommenbeschrijving wordt op gebruikelijke wijze met het "|"-teken van elkaar gescheiden.

Tekst

Rendering

Wikitext

Commentaar

Punt toegevoegd voor een goed antwoord:
Punten afgetrokken voor een onjuist antwoord:
De coëfficienten van de vragen negeren:

Waar is Aristoteles geboren?

Wie was de beroemde mentor van Aristoteles?

was de bekendste leerling van Aristoteles.

Nul

Elektriciteit vliest van

naar

De elektronen bewegen zich van

naar

Gaten (elektronengaten) bewegen zich van

naar

<quiz>
{ Invultekst
| type="{}" }
Waar is Aristoteles geboren?
{ Stageira }
Wie was de beroemde mentor van Aristoteles? 
{ Plato }
{ Alexander } was de bekendste leerling van Aristoteles. 

{ Vertaal naar het Engels
| type="{}" }
Nul { zero|nil|null (i) }

{ Vul de open ruimtes met tekst!
| type="{}" }
Elektriciteit stroomt van { plus _6} naar { min _6}
De elektronen bewegen zich van { min _6} naar { plus _6}
Gaten (elektronengaten) bewegen zich van { plus _6} naar { min _6}

</quiz>

De spaties tussen accolade en antwoord zijn belangrijk.
Door middel van _getal kan het maximaal aantal letters vastgelegd worden. Bij een langer antwoord wordt een syntaxfehler getoond.
Grote en kleine letters: dit speelt geen rol, behalve wanneer het met (i) wordt geactiveerd. (i) staat voor "case-insensitive".

Belangrijk: Dit geldt *niet* voor alle antwoorden, maar alleen voor expliciet met (i) aangegeven antwoorden.

Getallen

Het ingeven van getallen is verwant met de ingave van tekst; men kan ze samen gebruiken.

Rendering

Wikitext

Commentaar

<quiz>
{{ Geef 1/3 in een decimaal antwoord?
| type="{}" }
Antwoord: { 0.33-0.34 }
|| Feedback

{ Hoeveel is 10 keer 10
| type="{}" }
{ 100 5% }

{ 2^.5=?
| type="{}" }
{ 1.4-1.42 | -1.42--1.4 }
</quiz>

Zowel punt als komma kan gebruikt worden voor het weergeven van een decimaal.
Zowel het opgeven van een bereik als ook het opgeven van een tolerantie in procenten is mogelijk
In de derde vraag zijn twee mogelijkheden juist. Deze meerkeuzemogelijkheid wordt van elkaar gescheiden door een pipe-teken.

Mediawikisyntax

Binnen de quiz-tags functioneert een groot gedeelte van de wikisyntax, en dus kunnen ook afbeeldingen, geluid en animaties in een vraag worden weergegeven.

De voorbeelden hier zijn slechts een paar van de mogelijkheden.

Afbeeldingen

Rendering

Wikitext

Commentaar

<quiz>
{ Wat is geen noot? }
- [[Image:Two English Walnuts edit.jpg|100px|Okkernoot]]
+ [[Image:ARS peanuts.jpg|100px|Pinda]]
+ [[Image:Red Delicious.jpg|100px|Appel]]
- [[Image:Ab food 12.jpg|100px|Pistache]]
- [[Image:Roastedchestnuts.JPG|100px|Kastanje]]
+ [[Image:Citrus sinensis.jpg|100px|Sinaasappel]]

{ Wat is dat [[Image:Butterfly tongue.jpg|100px| ]]?
| typ="()" }
- Tijger
+ Vlinder
- Bij
- Vlieg
</quiz>

Er bestaat geen mogelijkheid om de afbeeldingen in een rij te zetten, zoals met de gallery-tag.

Animaties

Dit gedeelte introduceert geen technische trucs, maar laat alleen het gebruik van geanimeerde GIF's zien.

Muziek

Rendering

Wikitext

<quiz>
{ Welk lied is [[Media:Mozart 
  Eine kleine Nachtmusik KV525 
  Satz 4 Rondo.ogg|dat]]?
| typ="()" }
||[[Media:Mozart Eine kleine Nachtmusik 
    KV525 Satz 4 Rondo.ogg]]
+ Eine kleine Nachtmusik
- Beethovens 5. symfonie
- Für Elise

{ Welk lied is [[Media:Jingle 
  Bells.ogg|dat]]?
| typ="()" }
||[[Media:Jingle Bells.ogg|Jingle Bells]]
- Stille nacht, heilige nacht
+ Jingle Bells
- O dennenboom
- O du fröhliche

{ Welk lied is [[Media:Oh Christmas 
  Tree.ogg|dat]]?
| typ="()" }
||[[Media:Oh Christmas Tree.ogg|
    Oh Christmas Tree]]
- Joy to the World
+ O dennenboom
- Jingle Bells
- Stille nacht, heilige nacht
</quiz>

Het gebruik van sjablonen

Het gebruik van sjablonen is met weinig beperkingen mogelijk.

Substitueren van sjablone met Subst: is voorlopig nog niet mogelijk; tevens zijn er beperkingen bij het gebruik van parameters.

Rendering

Wikitext

<quiz>
{  Van wie is {{Audio|BWV726.ogg|dit lied}}? }
- Beethoven
+ Bach
- Mozart
- ...
</quiz>

De oplossing en feedback

Rendering

Wikitext

Kommentar

<quiz>
{ Wat is geen noot? }
- Walnoot
+ Pinda
||Hülsenfrucht, siehe {{W|Pinda}}
+ Appel
- Pistache
- Kastanje
+ Sinaasappel

{ Wie heeft de gloeilamp uitgevonden? }
- Thomas Alva Edison
|| Edison heeft de gloeilamp in belangrijke mate verder ontwikkeld
- Frederick de Moleyns
|| Deze persoon is in bezit van het eerste patent
- Heinrich Göbel
|| Deze persoon heeft beweerd deel te hebben gehad aan de verdere ontwikkeling van de gloeilamp, hetgeen echter niet waar bleek te zien.
+ Niet bekend
|| zie {{W|Gloeilamp#Uitvinding}}
</quiz>

De Feedback-tekst achter het teken "||" is verstopt en verschijnt pas, wanneer de gebruiker op de verbeteringknop heeft gedrukt
Typisch gebruikt:
- Beloning/lof
- Uitleg
- Felicitatie
- Opbeurende woorden of medelijden
Feedback is met alle typen vragen mogelijk
De dubbele verticale lijn (||) moet direct na de verschillende antwoorden staan.
Ook dit bijzondere teken moet aan het begin van een nieuwe regel staan.
Anders als bij ander quizsystemen, worden alle feedbacks bij de verbetering getoond. Bij andere quizsystemen is het standaard alleen feedbacks te tonen bij antwoorden die de gebruiker heeft gekozen.
Om feedbacks uit te proberen, druk op "verbetering".

Coëfficient

Indien niet elke vraag dezelfde punten zou moeten geven, kan men elke vraag met | koef="X" } van een factor (coëfficient) voorzien.

Rendering

Wikitext

Commentaar

<quiz>
{ Deze vraag geeft 5 punten.
| koef="5" }
+ Juist antwoord
+ Ook juist
- Verkeerd antwoord

{ Deze vraag geeft 3 punten.
| typ="()" koef="3" }
+ Juist antwoord
- Verkeerd antwoord

{ Deze vraag geeft 1 punt.
| typ="()" }
+ Juist antwoord
- Verkeerd antwoord
</quiz>

Inclusie van een quiz

De inclusie van een of meerder quizen is mogelijk, wat bijvoorbeeld het maken van dynamische druckversie mogelijk maakt.

Render	Wikitext	Inhoud van het sjabloon
Wikibooks:Quizsjabloon	{{Wikibooks:Quizsjabloon}}	<quiz> { Deze quiz is een sjabloon } + Juist - Verkeerd </quiz>

Het overleveren van parameters (dus {{Wikibooks:Quisjabloon|Parameter}} en {{{1}}}) werkt niet.

Resultaatbepaling

Punten

Rendering

Wikitext

Commentaar

<quiz points="2/1!">
{ Vraag }
+ Juist antwoord
+ Ook juist
- Verkeerd antwoord
</quiz>

<quiz points="X/Y!">

X is het aantal punten voor een juist antwoord, Y is het aantal punten aftrek voor een verkeerd antwoord en het optionale "!" is voor het negeren van de coëfficienten. De Gebruiker kan de waarde veranderen.
Er kunnen alleen positieve getallen worden ingegeven.
Niet gehele getallen als 1.5 zijn ook mogelijk.

Quizopties

simple

Met behull van display="simple" kan je het kopje van de quiz verbergen.

Rendering

Wikitext

<quiz display="simple">
{ Test }
+ Juist
- Verkeerd
</quiz>

Gemengde opties

shuffle="none"

Met shuffle="none" kan je de "Vragen in willekeurige volgorde" onderdrukken:

Rendering

Wikitext

<quiz shuffle="none">
{ Test }
+ Juist
- Verkeerd

{ Hallo }
+ Juist
- Verkeerd

{ Pi is precies 3 }
+ Juist
- Verkeerd
</quiz>

Fijninstelling

Je kunt een blok definiëren, dat met {X} begint en dan door {/X} beëindigd wordt. Hiermee worden alleen de vragen binnen dit zo gedefinieerde blok in een willekeurige volgorde geplaatst, binnen het blok. Buiten het blok kan de volgorde wel wijzigen

Render

Wikitext

Inhalt der Vorlage

<quiz>
{ Kann overal geplaatst worden }
+ Juist antwoord
- Verkeerd antwoord

{X}

{ Slechts intern in willekeurige volgorde geplaatst }
+ Juist antwoord
- Verkeerd antwoord

{ Slechts intern in willekeurige volgorde geplaatst }
+ Juist antwoord
- Verkeerd antwoord

{/X}

{!X}

{ Wordt niet verplaatst }
+ Juist antwoord
- Verkeerd antwoord

{ Wordt niet verplaatst }
+ Juist antwoord
- Verkeerd antwoord

{/X}

</quiz>

De nummers van de vragen, blijft gehandhaafd.
Indien iets wordt aangekruist wordt de knop "Vragen in willekeurige volgorde" inactief (grijs) gemaakt.

Tekst tussen de vragen

Rendering

Wikitext

<quiz>
{{ Test }
+ Juist
- Verkeerd

{ Dit is een testtekst<br> }

{ Pi is precies 3 }
+ Verkeerd
- Juist
</quiz>