Super Parrot Documentazione

Parrot Markup

Parrot Markup è la piccola sintassi che arricchisce i testi di un dizionario: gli spazi vuoti di un esercizio, le risposte ammesse, la punteggiatura non valutata, gli indizi, le parole in un'altra lingua, la pronuncia. Un testo semplice resta un testo semplice: si aggiunge il markup solo dove serve.

Dove usarlo

TestoUso comune
Esercizi (value di domande, risposte, proposte)spazi vuoti, affissi, indizi, alternative
Consegne e titoliuna parola citata in un'altra lingua: {lang=pt-PT§ser}
Parole del vocabolario (text)grafie ammesse: colour|color
translation_contextun contesto per lingua: {lang=it§veicolo}{lang=pt§veículo}
Pattern (prefix, suffix)pronuncia imposta: ipa=ˈsʌmθɪŋ§ sth

Cinque caratteri speciali

CarattereRuolo
{ }delimitano un gruppo
|separa delle alternative
§chiude un attributo posto all'inizio di un testo
`protegge il carattere seguente

Tutto il resto, spazi compresi, è testo normale.

Alternative

| separa forme tutte accettate. Fuori dalle parentesi graffe vale per tutto il testo; dentro, solo per la parte che cambia.

ScritturaRisposte accettate
colour|colorcolour, color
I'd like {a flat|an apartment}I'd like a flat, I'd like an apartment
{the |}cinemathe cinema, cinema: un ramo vuoto rende facoltativa una parola

In un file di esercizi, meglio una riga answer o proposal per risposta: l'importazione le unisce da sola con |, e il foglio di calcolo resta leggibile.

Attributi

Un attributo si scrive chiave=valore§ all'inizio di un testo, di solito in un gruppo: {lang=pt-PT§ser}. Più attributi si susseguono, ciascuno chiuso dal proprio §, in qualsiasi ordine: {type=clue§lang=fr-FR§passé} equivale a {lang=fr-FR§type=clue§passé}.

AttributoEffetto
?1§ (o input=1§)uno spazio vuoto numerato
#1§ (o section=1§)una sezione numerata dell'esercizio
lang=…§la lingua del testo: viene letto dalla voce di quella lingua
type=affix§un affisso: mostrato, mai valutato
type=clue§un indizio, mostrato tra parentesi
type=context§un contesto che toglie un'ambiguità
ipa=…§la pronuncia imposta

Un attributo vale solo per il ramo che precede. {?1§was|were} significa «was nello spazio 1, oppure were fuori dallo spazio»: were verrebbe rifiutato. Perché lo spazio accetti entrambe, racchiudi le alternative: {?1§{was|were}}.

Spazi vuoti

Nella domanda, {?1§} segna il punto da riempire. Nella risposta, {?1§bought} indica ciò che ci si aspetta in quello spazio. Più spazi si numerano ?1, ?2…

Scrittura
DomandaYesterday I {?1§} a new phone.
Risposta{?1§bought}
Due spazi{?1§buy}{?2§bought}

Viene valutato solo il contenuto dello spazio: ciò che lo circonda nella domanda è mostrato, non digitato. In un file di esercizi, la colonna index fissa il numero dello spazio, così una risposta spesso si scrive senza alcun markup.

Affissi: mostrati, mai valutati

{type=affix§…} racchiude ciò che accompagna la risposta senza farne parte: la punteggiatura finale, i segni di apertura dello spagnolo, le virgolette. Lo studente non lo digita e non viene mai penalizzato.

{?1§A coffee, please}{type=affix§.}
{type=affix§¿}Cómo te llamas{type=affix§?}

Anche l'articolo e il to dell'infinito inglese sono affissi, ma si dichiarano una volta per tutte in un pattern (vedi Creare un dizionario).

Indizi e contesto

{type=clue§…} aggiunge un indizio mostrato tra parentesi: il verbo da coniugare, un registro, la forma attesa. Non si digita. Viene letto ad alta voce se l'opzione Leggi gli indizi è spuntata (vedi Lettura e voce).

Yesterday I {?1§}{type=clue§buy} a new phone.
{?1§How do you do}?{type=clue§formal}

{type=context§…} toglie un'ambiguità, come il contesto di una parola del vocabolario: viene sempre letto. Un indizio non deve mai svelare la risposta.

Lingue

{lang=…§…} segnala un frammento scritto in una lingua diversa dal resto del testo: viene letto dalla voce della sua lingua, con il suo accento. Indica il codice completo, con il paese.

Completa con «{lang=pt-PT§ser}».
{type=clue§{lang=pt-PT§você}, affermativo}

Sezioni

Un esercizio può avere più sezioni numerate, per esempio la frase da completare e, accanto, la sua traduzione per guidare lo studente. {#2§…} mette un testo nella sezione 2. In un file di esercizi, la colonna section della riga _ indica in quale sezione si trovano la domanda e la risposta.

{#1§I gave up.}{#2§lang=it-IT§Ho rinunciato.}

Pronuncia

ipa=…§ impone la pronuncia del testo che precede, in alfabeto fonetico internazionale, quando la sintesi vocale sbaglia. Trascrive solo quel testo, mai la frase intorno.

{?1§ipa=ˈrɛd§{read}}
ipa=ˈsʌmθɪŋ§ sth

Scrivere un carattere speciale

L'accento grave rende letterale il carattere che lo segue: `{, `}, `|, `§, e `` per l'accento grave stesso. Serve anche nei file CSV, per una cella che comincia con ~, + o - senza essere un comando (`+18).

Nessun messaggio di errore

Parrot Markup non viene mai rifiutato: una parentesi in più o in meno, un attributo sconosciuto, nulla blocca l'importazione. È comodo, ma un errore di battitura passa inosservato.

Dopo un'importazione, fai qualche esercizio nell'app: è il controllo migliore.

Promemoria

ScritturaSignificato
a|b, {a|b}alternative
{parola |}parola facoltativa
{?1§} / {?1§risposta}spazio nella domanda / risposta attesa
{?1§{a|b}}spazio con più risposte
{type=affix§.}mostrato, mai valutato
{type=clue§…}indizio tra parentesi
{type=context§…}contesto che toglie un'ambiguità
{lang=pt-PT§…}frammento in un'altra lingua
{#2§…}sezione 2
ipa=…§testopronuncia imposta
`{, `|, `§, ``carattere speciale letterale