Questa è una pagina d'aiuto per l'estensione relativa ai quiz.
L'estensione quiz consiste in un semplice markup cui corrisponde una sintassi specifica. La lunghezza di questa pagina è dovuta alla moltitudine di possibilità che l'estensione quiz produce. Per una più semplice consultazione sull'utilizzo dell'estensione da parte di utenti inesperti o giovani, consulta la pagina Aiuto:Quiz-Simple.
- La versione 1.0 dell'estensione per i quiz è quella attualmente in uso sulle varie Wikiversità.
- Questa documentazione copre tutte le maggiori funzionalità e la maggior parte di quelle secondarie; alcune caratteristiche un po' esotiche non sono ancora spiegate, come il controllo shuffle usato con i tag {X} {!X} {/X}.
- Quali sono i pro e i contro dell'uso dei quiz di Wikiversità?
- Come si può usare l'estensione quiz al meglio come strumento didattico?
- Quiz/Wikiversità rispetto a Moodle - offre un' analisi dettagliata delle differenze di funzionalità quiz tra Wikiversityà e Moodle, compresi suggerimenti su come è meglio utilizzarli.
Codice
(cosa devi scrivere) |
Risultato
(il risultato finale) |
Commenti
|
<quiz>
"Inserire qui la domanda"
</quiz>
|
|
I tag quiz funzionano nel modo seguente:
- Inseriscono in cima alcune opzioni quiz standard e una chiave-colore come marcatura. La chiave-colore appare solo quando il quesito viene marcato.
- Aggiungono un pulsante "Correggi" in fondo per dare la possibilità allo studente di correggere le sue risposte.
- Tutto ciò che è compreso tra i tag quiz viene analizzato dall'estensione quiz e convertito in domande, se possibile.
In teoria è possibile mettere il tag quiz per ogni singola domanda, consentendo allo studente di correggerle una ad una
Mescola le domande: se questo pulsante è visibile, premendolo si possono mescolare le domande.
Funziona solo se lo studente non ha ancora iniziato a rispondere alla domande, poi l'ordine delle domande rimane bloccato.
|
<quiz display=simple>
Inserisci qui la domanda
</quiz>
|
|
- L'aggiunta di "display=simple" come attributo al tag quiz rimuove la tabella dei punti in cima e il pulsante per lo shuffling (mescolamento) in fondo
- Ciò è utile per quiz brevi, specialmente per casi in cui si inseriscono singole domande all'interno dei paragrafi
|
<quiz shuffle=none>
Inserisci qui la domanda
</quiz>
|
|
- Se vuoi mantenere la tabella dei punteggi ma vuoi eliminare la possibilità di mescolare le domande, usa l'attributo shuffle=none come mostrato.
|
Sotto sono riportati tutti gli esempi per ogni tipo di domanda.
Un punto importante è che ogni domanda deve essere separata da una linea vuota, altrimenti le domande si fonderanno insieme.
Come usare gli esempi sottostanti
modifica
Negli esempi di questa pagina sono presenti due colonne: il codice e il risultato. La sezione codice contiene per l'appunto, il codice che può essere copiato nelle pagine, studiato e analizzato.
La sezione risultato invece mostra il risultato dell'applicazione di tale codice, in modo da darti un'anteprima di quel che otterrai.
Il markup è stato facilitato un po' per aiutare l'understanding (la comprensione). Puoi pure copiare e incollare, basta che ti ricordi di inserire il tag <quiz> prima e </quiz> dopo la scrittura del codice. Se preferite potete usare l'opzione "display=simple" come spiegato sopra.
Nota che gli esempi scritti sotto anche usano le tabelle solo per rendere più chiaro l'esempio stesso. Se un quiz dovesse essere inserito in una tabella, questo verrà modificato - per esempio, i box compaiono intorno ad alcuni elementi nel quiz. Se non usate una tabella, questi box spariscono ed il vostro quiz sembrerà più normale.
Nell'incollare, accertarsi che tutti i simboli siano stati allineati dalla parte di sinistra della pagina. Se una qualsiasi linea dovesse cominciare con uno spazio, potrebbero verificarsi problemi di visualizzazione linea comincia con uno spazio, formating gli errori può accadere.
Tutti gli esempi qui sotto dovrebbero funzionare. Non aver paura, provali pure tutti. Fare clic con il tasto di correzione è corretto - non cambierà o non danneggerà questa pagina.
Scelta multipla / singola risposta
modifica
| Codice |
Risultato |
commenti
|
{Question
|type="()"}
+ Risposta corretta.
- Risposta errata.
- Risposta errata.
- Risposta errata.
|
|
- Questo tipo di domande permettono una risposta singola e un numero qualsiasi di distrattori (opzioni errate) - nell'esempio ne sono mostrati tre, ma potrebbero anche essere uno, nove, o qualunque altro numero.
- La risposta corretta può essere in qualsiasi posizione ed è contrassegnata dal segno più; i distrattori con il segno meno.
- Il codice deve essere inserito tra i tag <quiz>.
- Le risposte appaiono nello stesso ordine del codice, quindi è consigliabile mescolarle prima di salvare la pagina.
- Ogni simbolo, come |, +, - e qualsiasi altro simbolo elencato di seguito, deve essere su una nuova linea (andare a capo) e non deve essere preceduto da spazi
- I bordi sono quelli della tabella: sono opzionali
- Per "distrattore" s'intende una opzione errata
- Il simbolo () nell'attributo "type" serve per visualizzare un pulsante di scelta tipo radio[non chiaro]
- Per vedere il codice colore completo (con quattro colori), provare a fare il quiz facendo clic sul pulsante di correzione.
- Un secondo click sulla casella d'una risposta (un click su una casella già spuntata) la deseleziona.
|
| Testo |
Risultato |
Commento
|
{La Bulgaria e la Romania sono entrate a far parte dell' Unione Europea nel 2007.
|type="()"}
+ Vero.
- Falso.
{La Svizzera fa parte dell' Unione Europa.
|type="()"}
- Vero.
+ Falso.
|
|
- In molti metodi per la creazione di quiz, le domande vero/falso sono considerate come un tipo di domanda separata, nonostante esse non siano altro che domande a scelta multipla con una singola risposta. Per questo, nell'usare le domande vero/falso nell'estensioni quiz, sarà sufficiente trattarle come domande a scelta multipla, come negli esempi riportati.
- Nel primo esempio la risposta corretta è "vero", nel secondo è "falso"
- Se hai un gran numero di domande vero/falso, è più efficiente usare le tabelle, come spiegato di seguito.
|
Multipla domanda / multipla risposta
modifica
| Testo |
Risultato |
Commento
|
{Question
|type="[]"}
+ Risposta corretta.
- Risposta errata.
+ Risposta corretta.
- Risposta errata.
|
|
- Queste sono domande a scelta multipla dove una o più risposte possono essere corrette.
- Le risposte corrette sono indicate dal segno più, quelle errate dal meno.
- Il codice deve essere inserito nei tag quiz
- Il codice deve essere inserito tra i tag <quiz>.
- Le risposte appaiono nello stesso ordine del codice, quindi è consigliabile mescolarle prima di salvare la pagina.
- Ogni simbolo, come |, +, - e qualsiasi altro simbolo elencato di seguito, devono essere su una nuova linea e non deve essere preceduto da spazi
- I bordi sono il risultato del bordo attorno alla wiki-tabella, sono opzionali
- "Distrattore" è il termine standard per una opzione errata
- Il simbolo "[]" nell'attributo "type" serve per visualizzare un pulsante di scelta tipo checkbox
|
Risposta scritta (Risposte brevi)
modifica
| Codice |
Risultato |
commenti
|
{ Rispondi alle seguenti domande
|type="{}"}
L'anno della scoperta l'America. { 1492 }
{
|type="{}"}
Il tipo di imbarcazione con cui C. Colombo ha viaggiato verso l'America. { caravella }
{
|type="{}"}
{ Cristoforo } Colombo ha scoperto l'America per caso.
|
|
- In una risposta scritta, l'utente che intende rispondere al quiz digita da tastiera una risposta in una casella (campo).
- Questo tipo di domanda è contrassegnata dal valore "{}" per la proprietà type.
- La casella di testo è inserita tramite l'uso delle parentesi graffe nella posizione desiderata nel testo.
- Nota bene: il testo nelle parentesi graffe deve essere preceduto e seguito da uno spazio: { risposta } funziona, ma non funziona {risposta}.
- La risposta corretta per ciascun campo (casella di testo) deve essere inserita fra le parentesi graffe che lo contrassegnano.
- Queste caselle possono essere posizionate ovunque nel testo. Il testo prima e dopo le caselle sarà mostrato normalmente.
- Negli esempi si è inserito un non-breaking space (indicato in HTML dal codice ) tra { e |tipe= perché il testo della domanda è obbligatorio (altrimenti l'estensione non funziona)
|
{
|type="{}"}
Nome di un famoso filosofo dell'antica Grecia. { Aristotele|Platone }
|
|
- Le risposte scritte hanno spesso più di una risposta possibile. Potete elencare tutte le risposte possibili all'interno delle parentesi graffe separandole con un pipe (barretta verticale: " | " ).
- In questo esempio ci sono due risposte possibili. Si possono provare direttamente per vedere il funzionamento.
|
{
|type="{}"}
Il nome del famoso maestro di Aristotele. { Platone _8 }
|
|
- Per modificare la larghezza della casella di testo, aggiungi un underscore (o trattino basso: " _ " ) seguito da un numero intero dopo la risposta all'interno delle parentesi graffe. Questo serve per rappresentare il numero massimo di caratteri che la casella può ospitare.
- Questo numero è variabile a discrezione; è consigliabile mantenersi intorno a n+2 (dove n è il numero dei caratteri che deve avere la risposta)
|
{
|type="{}"}
Qual era il nome di Colombo, scopritore dell'America? { Cristoforo (i) }
|
|
- Case-sensitivity: nelle risposte varranno distinte le maiuscole dalle minuscole a meno che non venga inserito il comando (i). In questo caso, sia che si scriva «Cristoforo», sia «cristoforo», la risposta sarà valida.
|
Esercizio di completamento di spazi
modifica
| Codice
|
{Completa il testo aiutandoti colla voce
"[[w:Cristoforo Colombo|Cristoforo Colombo]]" su Wikipedia.
|type="{}"}
Cristoforo Colombo è nato in { Italia (i) _8}.
Colombo scoprì l' { America (i) _9 } nel { 1492|millenovecentonovantadue }, per puro caso.
L'intenzione di Colombo era infatti quella di scoprire una nuova via per le { indie _7}.
Dopo il primo viaggio, essendosi reso conto che le terre che aveva raggiunto
non erano le Indie, bensì un nuovo continente, compì altri { 4|quattro _8 } viaggi.
Nel suo { secondo _8 } viaggio Colombo approdò a { Cuba (i) _6 } .
Questo avvenne il 28 ottobre, appena 16 giorni dopo il primo sbarco nel nuovo continente.
|
| Risultato
|
|
| commenti
|
- I testi da completare (gapfill) sono creati come gli altri tipi di domande, con la differenza che si usano più caselle e più testo.
- Per disporre il gapfill qui sopra in un riquadro e per compattarlo (riducendo la giustezza) lo si è inserito in una tabella.
|
| codice |
risultato |
commenti
|
{In che anno nacque Platone?
|type="{}"}
Platone è nato nel { 427-428 _5 } AC.
|
|
- Nell'estensione quiz, le risposte numeriche sono un sottotipo di quelle scritte. La sintassi è identica, eccetto per alcune aggiunte che consentono range di numeri (per stabilire ad esempio una tolleranza).
- Nell'esempio qui a sinistra, l'incertezza sulla data di nascita di Platone viene riflessa nella risposta usando un range. Un trattino semplice ( " - " ) fra i numeri consente tutti i numeri compresi tra il numero antecedente e quello successivo al trattino.
|
{Quanti anni luce è il semiasse maggiore del sole?
|type="{}"}
{ 26-28 _3 } mila anni luce.
|
|
- Questo è un altro esempio di range.
- Il _3 limita i caratteri disponibili a tre.
|
{Quanto fa 10 x 10?
|type="{}"}
{ 100 5% _3 }
|
|
- Questo è un esempio per specificare la tolleranza. La parte "critica" è il comando "5%", il quale specifica la tolleranza prevista del 5%. In questo esempio, i valori fra 95 e 105 dovrebbero funzionare, ma prova tu stesso.
- Il metodo del range non funziona in combinazione con la tolleranza relativa.
|
|
|
- Dal momento che le risposte numeriche sono, tecnicamente, un sottotipo di quelle scritte, possono essere usate entrambe in un esercizio di completamento, come mostrato a sinistra
|
| Codice |
Risultato |
commenti
|
{Domanda
|type="()"}
| A | B | C
+-- A è corretta.
-+- B è corretta.
--+ C è corretta.
|
|
- Aggiungi bottoni radio addizionali ricopiano i segni +/- all'inizio di ogni riga.
- La risposta è singola, quindi ci deve essere solo un segno più per riga.
- Specifica le intestazioni di colonna usando i pipes (|) sulla prima riga.
|
| Codice |
Risultato |
commenti
|
{Question
|type="[]"}
| Opzione A | Opzione B | Opzione C
++- Domanda 1 (Indizio: A e B sono corrette).
-++ Domanda 2 (Indizio: B e C sono corrette).
--+ Domanda 3 (Indizio: C è corretta).
|
|
- Questo tipo di domanda ha multiplo risultato.
- Le risposte corrette sono contrassegnate dal simbolo " + " (più), quelle sbagliate dal simbolo " - " (meno). Con l'uso dei segni +/- all'inizio di ogni fila, possono essere aggiunte checkbox extra.
- Le intestazioni della colonna sono definite per mezzo dei pipes ( " | " ) nella parte superiore come indicato.
|
| Codice |
Risultato |
commenti
|
{domanda
|type="()"}
+ Risposta corretta
|| Avviso per la risposta corretta
- Distrattore
|| Avviso per la risposta errata
- Distrattore
|| Avviso per la risposta errata
- Distrattore
|| Avviso per la risposta errata
|
|
- Un avviso consiste in un testo inizialmente nascosto, che poi viene mostrato all'utente quando corregge il quiz. Normalmente gli avvisi (in gergo feedback) servono per proporre incoraggiamento, spiegazioni, congratulazioni o commiserazione ;).
- Il feedback si imposta con tutte le modalità di quiz usando due pipes immediatamente dopo la risposta.
- I pipes devono essere su una nuova linea.
- Al contrario di altri sistemi per i quiz, tutti gli avvisi sono mostrati alla correzione. Con altri sistemi, la norma è di mostrare solo l'avviso relativo alla risposta selezionata.
- Per provare l'effetto dei feedback, scegli un'opzione e clicca il bottone di correzione
|
Inserire i blocchi di testo in mezzo alle domande
modifica
| Codice |
Risultato |
commenti
|
{Questa è la prima domanda.
|type="()"}
+ Risposta corretta.
- Risposta errata.
- Risposta errata.
{Questo è un blocco di testo.}
{Questa è la seconda domanda.
|type="()"}
+ Risposta corretta.
- Risposta errata.
- Risposta errata.
|
|
- I blocchi di testo possono essere inseriti tra le domande, semplicemente mettendo il testo tra parentesi graffe
{....}.
- Essi possono contenere markup wiki, questo per permettere l'inserimenti di immagini, collegamenti e per formattare al meglio il testo, come mostrato in questo esempio.
|
| Codice |
rendered |
commenti
|
<quiz display=simple>
{ Quali di questi animali '''non''' sono carnivori? }
- [[Image:PolishScenthound-"NUTKA Klusujaca Sfora wl A.Balcerzak.jpg|100px]]
+ [[Image:Cow and calf.jpg|100px]]
+ [[Image:African Elephant.jpg|100px]]
- [[Image:Pumapard-face.jpg|100px]]
- [[Image:Seal-berlin-zoo.jpg|100px]]
+ [[Image:Hartmanns Mountain Zebra 010.jpg|100px]]
</quiz>
|
|
- Sfortunatamente non esiste un modo per mettere le immagini in una riga sola o di tabellarizzare il layout.
- Sebbene non sia stato fatto nell'esempio per ragioni di praticità, è buona norma indicare all'interno del codice l'immagine di riferimento con un termine che non renda palese la risposta (come "mucca.jpg").
|
Usare le immagini nelle domande
modifica
| Codice |
risultato |
commenti
|
<quiz display=simple>
{ Che animale è questo? [[Image:Butterfly tongue.jpg|100px| ]]
| typ="()" }
- Tigre
+ Farfalla
- Ape
- Mosca
</quiz>
|
|
In questo esempio l'immagine è parte integrante della domanda. Puoi usare il normarle markup di wikibooks per inserire le immagini.
|
In questa sezione, non ci sono novità tecniche, ma alcuni esempi suggestivi di uso dell'estensione quiz.
Markup funzionanti all'interno dei quiz
modifica
- Collegamenti: [[....]].
- Immagini: [[Image:....]].
- Altri file multimediali: [[....]].
- Grassetto e corsivo.
- {{big|testo= and <br />.
Markup parzialmente funzionanti all'interno dei quiz
modifica
- Template: {{....}}.
- il comando subst non funziona.
- Tabelle: {|....|}.
- Intestazioni: per esempio ===....===.
- Attenzione: Al momento è presente un errore con gli indici.
- Liste e rientri: usando #, * e :
Aggiungere musica ed effetti sonori
modifica
L'inserimento di file audio è simile a quello delle immagini. È possibile usare il markup standard.
Codice
(cosa devi scrivere) |
Risultato
(cosa vedi) |
commenti
|
<quiz points="3/1!">
{Adesso prova questa domanda.}
+ Aggiungi 3 punti per questa.
- Sottrai 1 punto per questa.
</quiz>
|
|
- Di default, viene aggiunto un punto per ogni risposta corretta e 0 per ogni errata.
- Puoi cambiare questa opzione per l'intero quiz, aggiungendo l'atttributo points dentro al tag quiz.
- Il formato da usare è "X/Y!", dove X aggiunge i punti per ogni risposta corretta e Y per ogni risposta errata. I punti Y devono essere espressi come numero intero positivo ma sono sottratti dal punteggio.
- A causa di un bug, i punti non hanno effetto se display=simple è in uso (version 0.9.2).
- Sono permessi anche i valori come 1.25 o 2.5.
|
<quiz display=simple>
{Adesso prova questa domanda.
|type="()" }
+ 1 punto per questa.
- 0 punti per questa.
{Adesso prova questa domanda.
|type="()" coef="2"}
+ 2 punti per questa.
- 0 punti per questa.
{Adesso prova questa domanda.
|type="()" coef="4"}
+ 4 punti per questa.
- 0 punti per questa.
{Adesso prova questa domanda.
|type="()" coef="0.5"}
+ 1/2 punto per questa.
- 0 punti per questa.
</quiz>
|
|
- Un coefficente è una modalità per dare un peso a ciascuna domanda specifica. Normalmente tutte le domande danno gli stessi punteggi (1 di default). specificando un coefficiente per ciascuna o una delle domande, puoi moltiplicare il numero dei punti per quella domanda per il coefficiente
- I coefficienti possono essere anche numeri sopra l'uno e numeri tra 0 e 1. Se il coefficiente è maggiore di 1, la domanda avrà un peso maggiore. Se il coefficiente è minore, avrà meno peso.
- Tu puoi invertire le virgole nell'argomento dell'attributo coef.
|
Configurare il rimescolamento delle domande
modifica
Codice
(cosa devi scrivere) |
Risultato
(cosa vedi) |
commenti
|
<quiz>
{X}
{ Domanda 1
|type="()"}
+ Risposta corretta.
- Distrattore.
- Distrattore.
- Distrattore.
{ Domanda 2
|type="()"}
+ Risposta corretta.
- Distrattore.
- Distrattore.
- Distrattore.
{\X}
{!X}
{ Domanda 3
|type="()"}
+ Risposta corretta.
- Distrattore.
- Distrattore.
- Distrattore.
{ Domanda 4
|type="()"}
+ Risposta corretta.
- Distrattore.
- Distrattore.
- Distrattore.
{\X}
</quiz>
|
|
Uso dei tag per il rimescolamento condizionato:il rimescolamento può essere ottenuto utilizzando i tag {X},{!X} e {/X} all'interno del quiz. Tutte le domande comprese tra {X} e {/X} vengono raggruppate in un blocco unico e rimescolate. Le domande comprese tra {!X} e {/X} non sono rimescolate internamente al blocco, pertanto l'ordine delle domande comprese tra {!X} e {/X} resta lo stesso.
Nell'esempio, Domanda 1 e Domanda 2 possono essere mescolate, ma Domanda 3 and Domanda 4 vengono mantenute nel medesimo ordine.
|
- Non puoi utilizzare il quiz mentre stai modificando una pagina, questo perché il tasto correggi non è cliccabile. Se desideri testare il nuovo quiz, puoi creare una sottopagina nella tua sandbox personale, o nella sandbox stessa, e successivamente inserirlo nella pagina del tuo libro.
- L'estensione quiz è stata sviluppata e testata con IE6, IE7, Firefox, e Opera, tuttavia per quanto riguarda il browser Opera ci potrebbero essere dei problemi nella visualizzazione, o comunque delle differenze rispetto agli altri browser.
- Nota: ogni domanda deve essere separata dall'altra andando a capo, altrimenti le domande vengono mischiate insieme, generando una sola domanda.
