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
| Testo | Uso comune |
|---|---|
Esercizi (value di domande, risposte, proposte) | spazi vuoti, affissi, indizi, alternative |
| Consegne e titoli | una parola citata in un'altra lingua: {lang=pt-PT§ser} |
Parole del vocabolario (text) | grafie ammesse: colour|color |
translation_context | un contesto per lingua: {lang=it§veicolo}{lang=pt§veículo} |
Pattern (prefix, suffix) | pronuncia imposta: ipa=ˈsʌmθɪŋ§ sth |
Cinque caratteri speciali
| Carattere | Ruolo |
|---|---|
{ } | 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.
| Scrittura | Risposte accettate |
|---|---|
colour|color | colour, color |
I'd like {a flat|an apartment} | I'd like a flat, I'd like an apartment |
{the |}cinema | the 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é}.
| Attributo | Effetto |
|---|---|
?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 | |
|---|---|
| Domanda | Yesterday 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.
- Esistono solo le chiavi
lang,section,input,type,ipaeref; qualsiasi altra (lnag=,part=1) viene ignorata e il testo perde la sua struttura. typeaccetta solo valori noti (affix,clue,context…); gli altri vengono ignorati.- Le maiuscole contano:
lang=fr-FR, nonLANG=FR-fr.
Dopo un'importazione, fai qualche esercizio nell'app: è il controllo migliore.
Promemoria
| Scrittura | Significato |
|---|---|
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=…§testo | pronuncia imposta |
`{, `|, `§, `` | carattere speciale letterale |