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 vedere degli esempi di utilizzo dei quiz, vedi Aiuto:Esempi di varie tipologie di esercizi.
- La versione 1.0 dell'estensione per i quiz è quella attualmente in uso sulle diverse 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 usanto i tag {X} {!X} {/X}
Codice
(cosa devi scrivere) |
Risultato
(il risultato finale) |
commenti
|
<quiz>
Inserisci qui la domanda
</quiz>
|
|
I tag quiz operano nel modo seguente:
- Inseriscono alcune opzioni standard per i quiz in testa e una chiave colorata per evidenziare. La chiave appare solo quando la domanda è selezionata.
- Aggiungono un pulsante "Correggi" in fondo per dare la possibilità allo studente di corregge le sue risposte
- Tutto ciò che è compreso tra i tag quiz è analizzato dall'estensione quiz e convertito in domanda se possibile.
Teoricamente è possibile mettere il tag quiz per ogni singola domanda, consentendo allo studente di correggerle una ad una
Mescola le domande: se questo bottone è visibile, le domande possono essere mescolate cliccandovi sopra. Ciò funziona solo se lo studente non ha ancora iniziato a rispondere alla domande, poi l'ordine delle domande è bloccato.
|
<quiz display=simple>
Inserisci qui la domanda
</quiz>
|
|
- L'aggiunta di "display=simple" come attributo al tag quiz rimove la tabella dei punti in testa e il pulsante per lo shuffling (mescolamento) in fondo
- Ciò è utile per quiz brevi, e 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 ma vuoi eliminare la possibilità di mescolare le domande, usa l'attributo shuffle=none come mostrato.
|
Qui sotto sono disponibili 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 essere impaurito, provali pure tutti. Cliccare 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, 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 radio
- Vedere i colori pieni di codici (con 4 colori),bisogna provare a fare il quiz e clicking the correction button.
- Un secondo click su un pulsante di opzione (un click su un pulsante già cliccato) lo deselezionerà.
|
| Testo |
Risultato |
Commento
|
{La Bulgaria ae la Romania sono entrate a far parte
della Unione Europea nel 2007.
|type="()"}
+ Vero.
- Falso.
{La Svizzera fa parte della Unione Europea.
|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 scrive una risposta in un textfield per mezzo della tastiera.
- 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 spazioo: { risposta } funziona, ma non funziona {risposta}.
- La risposta corretta per ciascuna textfield (casella di testo) deve essere inserita fra le parentesi graffe che la marcano.
- Le textfield possono essere posizionate ovunque nel testo. Il testo prima e dopo le caselle sarà mostrato normalmente.
- Negli esempi è usato un non-breaking space (indicato in HTML dall'entità ) tra { e |tipe= poiché il testo della domanda è obbligatorio (altrimenti causerebbe un bug)
|
{
|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 per mezzo di un pipe ( " | " ) per separarle.
- In questo esempio ci sono due possibile risposte. Provale, la dimostrazione è immediata.
|
{
|type="{}"}
Il nome del famoso maestro di Aristotele.
{ Platone _8 }
|
|
- Per modificare la grandezza 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 di testo può ospitare.
- Questo numero è variabile, tuttavia dovrebbe essere 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 minuscolo a meno che non venga inserito il comando (i). In questo caso scrivere Cristoforo o cristoforo, non invaliderà la risposta.
|
| Codice
|
{Completa il testo aiutandoti con l'articolo
"[[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.
- Il gapfill qui sopra è stato disposto in un box ed è stato concentrato usando una tabella di wiki.
|
| 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.
- Nonostante qui non sia stato fatto per ragioni di spazio, normalmente è di buona norma specificare delle sorte di testi alternativi o tooltip per le immagini, per ma che non forniscano indicazioni sulla risposta.
|
Usare le immagini nelle domande
modifica
| Codice |
risultato |
commenti
|
<quiz display=simple>
{ Che animale è questo? [[Image:Butterfly tongue.jpg|100px| ]]
| type="()" }
- 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: [[Immagine:....]].
- Altri file multimediali: [[....]].
- Grassetto e corsivo.
- <big> and <br />.
- <math> e </math>.
Markup parzialmente funzionanti all'interno dei quiz
modifica
- Templates: {{....}}.
- il comando subst non funziona.
- Tabelle: {|....|}.
- Intestazioni: e.g. ===....===.
- Attenzione: Al momento è presente un errore con gli indici.
- Liste e rientranze: 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
(what you see) |
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.
- Per colpa di un bug, i puntinon 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 put inverted commas around the argument of the coef attribute.
|
- 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 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.
- Quando una pagina viene esportata in PDF, i quiz che essa contiene non sono esportati correttamente. Ciò vuol dire che, al momento, non è possibile esportare (ed eventualmente stampare) un quiz in versione PDF. Per ora, l'unica soluzione percorribile è escludere i quiz dalla stampa, ad esempio usando il template Escludi dalla stampa.[1]
- Nota: ogni domanda deve essere separata dall'altra andando a capo, altrimenti le domande vengono mischiate insieme, generando una sola domanda.
- ↑ È stata aperta una segnalazione sulla pagina di discussione dell'estensione che implementa i quiz, tuttavia lo sviluppatore dell'estensione ha dichiarato di aver sospeso il lavoro.
