Autore: Patrice VANNEUFVILLE

 Data: 2 dicembre 2006

 Download: disponibile su Spip-Zone.

 Lingue: per il momento francese, italiano e un po’ d’inglese. Le traduzioni sono bene accette

Descrizione: Plugin che permette di generare diversi giochi all’interno di un articolo SPIP (questionario, parole crociate, sudoku, l’impiccato, ...). Analizza il codice dei giochi inseriti in SPIP, immagazzina i diversi elementi caratteristici e restituisce il codice HTML già formattato.

Installazione di un plugin: http://www.spip.net/it_article3422.html

Sintassi nell’articolo: Nel testo dell’articolo il codice dei giochi deve trovarsi tra i tag, "<jeux>" e "</jeux>". Anche questo codice è composto da separatori (per es.: [titre]) collocati tra i paragrafi del codice.
Evitare di mescolare i separatori specifici che appartengono a giochi differenti nel codice di un unico gioco.
I paragrafi del gioco possono a volte contenere delle scorciatoie tipografiche.

Un esempio semplice:

[(

<jeux>
        [titre]
        L'indovinello del giorno
        [devinette]
        Anche se ha la coda non gliela pesti mai, cos'è ?
        [reponse]
        Il pianoforte
</jeux>

)]

separatori speciali:
 [titre]: utile per la maggior parte dei giochi
 [texte]: permette di inserire un contenuto così com’è nel risultato del gioco, per esempio un’immagine o una separazione più marcata tra due risposte o due domande di un questionario ...
 [config]: alcuni giochi possono aver bisogno di parametri di configurazione (visualizzazione, difficoltà, suggerimenti, ecc...). Questo separatore è seguito da righe nella forma: parametro = valore

Attenzione: per evitare brutte sorprese nella presentazione (sommari, rubriche, backend, ...), ricordatevi:
 sia di inserire un’introduzione nel vostro articolo tra i tag <intro> e </intro>
 sia di inserire la descrizione dell’articolo.

Piccola nota per gli utenti di FCKEditor; non dimenticatevi di aggiungere la riga seguente in fckconfig.js:

[(FCKConfig.ProtectedSource.Add(/<jeux[\s\S]*?\/jeux>/gi);)]

Moduli esistenti:

 Inserisci un questionario (o un quiz...)
 Inserisci uno schema di parole crociate
 Inserisci uno schema di sudoku
 Inserisci un esercizio di completamento
 Inserisci una poesia
 Inserisci una citazione o una battuta
 Inserisci un indovinello o una sciarada
 Inserisci un diagramma di scacchi
 #
 #

Ringraziamenti:
 Mathieu GIANNECCHINI: creatore del questionario (domande a scelta multipla)
 Maïeul ROUQUETTE: creatore delle parole crociate
 François SCHREUER: creatore dei diagrammi di scacchi

 modulo: qcm.php
 separatori obbligatori: [qcm] o [quiz]
 separatori facoltativi: [titre], [texte]
 diversi [qcm] tra <jeux> e </jeux>: sì

Nel paragrafo preceduto da [qcm], la sintassi è la seguente:

[(

T Titolo del questionario
Q Testo della domanda
P1 Testo della risposta 1
P2 Testo della risposta 2
...
Pi Testo della risposta i
Rj (indica che la risposta esatta è la risposta j)

)]

Perciò, se la risposta esatta è la risposta 2 si indicherà "R2".

Attenzione, sono necessarie le maiuscole per: "T, Q, Pi e Ri".

E’ possibile specificare i punti attribuiti a ciascuna risposta:

[(

P1.-2 Testo della risposta 1  -2 punti
P2.4 Testo della risposta 2  4 punti
R2

)]

Fate in modo che la risposta esatta attribuisca sempre il numero massimo di punti.

Se al momento della correzione occorre spiegare la scelta (corretta o sbagliata) dell’utente, si possono aggiungere dei commenti:

[(

P1 Risposta 1|E un commento 1!
P2 Risposta 2|E un commento 2!

)]

In funzione delle domande presenti, occorre prevedere più paragrafi preceduti dal separatore "[qcm]".

I tag [qcm] e [quiz] sono equivalenti.

Un esempio:

[(

<jeux>
        [titre]
        Un titolo per il questionario!
        [qcm]
        Q Una domanda bla bla
        P1 Una risposta 1
        P2 Una risposta 2
        P3 Una risposta 3 (la risposta esatta)
        R3 (la risposta 3 è esatta!)
        [qcm]
        Q Una domanda ancora
        P1.2 Una risposta da 2 punti (la risposta  è esatta)
        P2 Una risposta 2
        R1
        [qcm]
        Q Una domanda per finire
        P1 Una risposta 1|Un commento 1
        P2 Una risposta 2|Un commento 2
        P3.4 Una  risposta da 4 punti!|Effettivamente!
        R3
</jeux>

)]

Caso particolare: se l’utente deve inserire da solo la risposta, bastano una domanda "Q" e una risposta "P". Esempio:

[(

<jeux>
        [qcm]
        Q Cita un pianeta del sistema solare:
        P mercurio venere terra marte giove saturno urano nettuno
</jeux>

)]

L’elenco delle parole valide da collocare dopo "P" può accettare i separatori soliti: a capo, tabulazioni, spazi, virgole, punti e virgola o punti.
Per una espressione che comprenda degli spazi, utilizzare le virgolette o il segno +
Per esempio : "al fine di" è equivalente a : al+fine+di
Le minuscole e le maiuscole possono essere usate indifferentemente nelle risposte.
La gestione dei punti e la loro specificazione è sempre possible:

[(P.4 mercurio venere terra marte giove saturno urano nettuno |Lo sapevi che plutone non è più un pianeta ?)]

Demo: http://www.ensemble-claudio-monteve...

 modulo: mots_croises.php
 separatori obbligatori: [horizontal], [vertical] & [solution]
 separatori facoltativi: [titre], [texte], [config]
 parametri di configurazione di default:

[(solution=oui        // Visualizzazione della soluzione ?)]

 diversi schemi tra <jeux> e </jeux>: no

Un esempio:

[(

<jeux>
        [horizontal]
        Definizione 1
        Definizione 2. Definizione 3
        Definizione 4. Definizione 5
        [vertical]
        Definizione 1
        Definizione 2
        Definizione 3
        [solution]
        aaa
        b*g
        a*d
</jeux>

)]

 modulo: sudoku.php
 separatori obbligatori: [sudoku] & [solution]
 separatori facoltativi: [titre], [texte], [config]
 parametri di configurazione di default:

[(solution=oui        // Visualizzare la soluzione?)]

 diversi schemi tra <jeux> e </jeux>: no

Gli schemi del sudoku possono avere le dimensioni: 4x4, 6x6 ou 9x9.
Le caselle bianche sono rappresentate dal trattino: ’-’

Un esempio:

[(

<jeux>
        [sudoku]
        -2
        --5--4
        3--5
        ----3
        --1--6
        6--1
        [solution]
        423615
        165324
        314562
        256431
        531246
        642153
</jeux>

)]

 module: trous.php
 separatori obbligatori: [texte] & [trou]
 separatori facoltativi: [titre], [config]
 parametri di configurazione: indices = 0, 1, oui, non, yes, no, ...
 diversi [trou] tra <jeux> e </jeux>: sì

Un esempio:

[(

<jeux>
        [texte]
        Questo è un esempio di cloze (esercizio di completamento).
        L’utente deve inserire le sue [trou]risposte[texte] negli spazi vuoti.
        Per ciascuna parola mancante possono essere accettate diverse risposte corrette.
Per esempio, questo
        [trou]
        lacuna, vuoto, bianco
        [texte]
        autorizza le risposte " lacuna ", " vuoto " o " bianco ".
        [config]
        indices = oui
</jeux>

)]

Nota: L’elenco delle parole valide da collocare dopo [trou] può accettare i soliti separatori: a capo, tabulazioni, spazi, virgole, punti e virgola o punti.
Per una espressione che comprenda degli spazi, utilizzare le virgolette o il segno +
Per esempio : "al fine di" è equivalente a : al+fine+di
Le minuscole e le maiuscole possono essere usate indifferentemente nelle risposte.

 modulo: textes.php
 separatori obbligatori: [poesie]
 separatori facoltativi: [titre], [auteur], [recueil]
 diversi [poesie] tra <jeux> e </jeux>: no

Un esempio:

[(

<jeux>
        [titre]
        L'ostrica asiatica
        [poesie]
        L'ostrica asiatica
       cura la sciatica
       portando un busto
       di fascia elastica
       con poco gusto
       di chi la mastica.
        [auteur]
        Toti SCIALOJA
        [recueil]
        Versi del senso perso, 1989
</jeux>

)]

 modulo: textes.php
 separatori obbligatori: [citation] o [blague]
 separatori facoltativi: [titre], [auteur] ou [recueil]
 diverse [citation] o [blague] tra <jeux> e </jeux>: sì

Un esempio:

[(

<jeux>
        [citation]
        L'amore è cieco, perciò bisogna toccare.
        [auteur]
        Proverbio brasiliano
</jeux>

)]

 modulo: devinettes.php
 separatori obbligatori: [devinette] ou [charade]
 separatori facoltativi: [reponse], [titre], [texte], [config]
 parametri di configurazione di default :

reponse = oui        // visualizzare la risposta ?
taille=10        // dimensioni del font utilizzato

 diversi [devinette] o [charade] tra <jeux> e </jeux>: sì

Due esempi:

[(

<jeux>
        [devinette]
        Anche se ha la coda non gliela pesti mai, cos'è ?
        [reponse]
        Il pianoforte
        [devinette]
        Cos’hanno in comune un controllore delle imposte e uno spermatozoo ?
        [reponse]
        Tutti e due hanno una possibilità su tre milioni di diventare un giorno un essere umano.
        [config]
        reponse = oui
</jeux>

<jeux>
        [titre]
        Per i bambini...
        [charade]
        {{Il mio primo}} rimane segando il fusto.
        {{Il mio secondo}} la lingua in cui parlava Augusto.
        {{Il mio intero}} Si scarta e ha un dolce gusto.
        [reponse]
        Il cioccolatino
</jeux>

)]

Note: la Libreria GD (graphique dynamique) è necessaria sul proprio server per avere delle risposte visualizzate a rovescio. Un’immagine rovesciata viene in effetti creata, a condizione che la riga ’reponse = oui’ sia stata collocata dopo il separatore [config].

 modulo: diag_echecs.php
 separatori obbligatori: [diag_echecs]
 separatori facoltativi: [titre], [texte], [config]
 parametri di configuratione di default:

taille=29        // Dimensioni delle immagini in pixel (29 o 35)
blancs=blanc        // Colore delle caselle 'bianche'
noirs=brun        // Colore delle caselle 'nere'
fond=blanc        // Colore di fondo della pagina web
bordure=2        // Spessore del bordo della scacchiera, in pixel
police=5        // Codice del font utilizzato per le coordinate ( da 1 a 5)
flip=non        // Occorre ruotare la scacchiera?
coords=oui        // Visualizzare le coordinate ?

 diversi [diag_echecs] tra <jeux> e </jeux>: sì

La posizione deve essere descritta sotto forma di notazione FEN, oppure utilizzando la forma "classica".
Esempi:
 classica: B:Rg1,Dd1,Ta1,e1,Pa2,f6/N:Rb8,Pa6,f5
 FEN : r1bqkbnr/pp2pppp/2n5/2p1P3/3p4/2P2N2/PP1P1PPP/RNBQKB1R

Notazione "classica" : la descrizione della posizione bianca comica con "B:", quella della posizione nera con "N:", e le due sono separate da un "/".
E’ anche possibile indicare un solo colore per la descrizione (B o N). L’ordine in questo caso è indifferente.
Le maiuscole non sono obbligatorie

Caselle evidenziate: si può utilizzare "/sv" per scegliere il verde, "/sb" per il blu, "/sj" per il giallo e "/sr" per il rosso.
Attenzione: per utilizzare questa funzione, è necessario usare la notazione "classica".

Rotazione della scacchiera: è automatica utilizzando la notazione FEN (e naturalmente se la mossa spetta al Nero), altrimenti basta aggiungere "/r" alla descrizione " classica ".

Due esempi:

[(

<jeux>
        [diag_echecs]
        B:Rg1,Dd1,Ta1,e1,Pa2,f6/N:Rb8,Pa6,f5
        [diag_echecs]
        r1bqkbnr/pp2pppp/2n5/2p1P3/3p4/2P2N2/PP1P1PPP/RNBQKB1R
        [config]
        taille=35
</jeux>
<jeux>
        [diag_echecs]
        B:Rb6,pa3,Fh2/N:Rc8/sr:a8/sb:g3,f4,e5,d6,c7,b8
        [config]
        taille=35
        noirs=bleu
</jeux>

)]

Nota: la Libreria GD (graphique dynamique) è necessaria sul proprio server per visualizzare i diagrammi. ...)