Parrot Markup
Parrot Markup est la petite syntaxe qui enrichit les textes d'un dictionnaire : les trous d'un exercice, les réponses admises, la ponctuation qui n'est pas notée, les indices, les mots dans une autre langue, la prononciation. Un texte simple reste un texte simple : on n'ajoute du balisage que là où il sert.
Où l'utiliser
| Texte | Usage courant |
|---|---|
Exercices (value des questions, réponses, propositions) | trous, affixes, indices, alternatives |
| Consignes et titres | un mot cité dans une autre langue : {lang=pt-PT§ser} |
Mots du vocabulaire (text) | graphies admises : colour|color |
translation_context | un contexte par langue : {lang=fr§véhicule}{lang=pt§veículo} |
Patterns (prefix, suffix) | prononciation imposée : ipa=kɛlkə ʃoz§ qqch |
Cinq caractères spéciaux
| Caractère | Rôle |
|---|---|
{ } | délimitent un groupe |
| | sépare des alternatives |
§ | termine un attribut placé en tête d'un texte |
` | échappe le caractère suivant |
Tout le reste, espaces compris, est du texte ordinaire.
Alternatives
Le | sépare des formes toutes acceptées. Hors accolades, il porte sur tout le texte ; entre accolades, seulement sur la
partie qui varie.
| Écriture | Réponses acceptées |
|---|---|
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 : une branche vide rend un mot facultatif |
Dans un fichier d'exercices, préférez une ligne answer ou proposal par réponse : l'import
les réunit lui-même avec |, et le tableur reste lisible.
Attributs
Un attribut s'écrit clé=valeur§ en tête d'un texte, le plus souvent dans un groupe : {lang=pt-PT§ser}.
Plusieurs attributs se suivent, chacun terminé par son §, dans n'importe quel ordre :
{type=clue§lang=fr-FR§passé} vaut {lang=fr-FR§type=clue§passé}.
| Attribut | Effet |
|---|---|
?1§ (ou input=1§) | un trou, numéroté |
#1§ (ou section=1§) | une section de l'exercice, numérotée |
lang=…§ | la langue du texte : il est lu par la voix de cette langue |
type=affix§ | un affixe : affiché, jamais noté |
type=clue§ | un indice, affiché entre parenthèses |
type=context§ | un contexte qui lève une ambiguïté |
ipa=…§ | la prononciation imposée |
Un attribut ne vaut que pour la branche qu'il précède. {?1§was|were} veut dire « was dans le
trou 1, ou were hors trou » : were serait refusé. Pour que le trou admette les deux, encadrez les
alternatives : {?1§{was|were}}.
Trous
Dans la question, {?1§} marque l'emplacement à remplir. Dans la réponse,
{?1§bought} donne ce qu'on attend dans ce trou. Plusieurs trous se numérotent ?1, ?2…
| Écriture | |
|---|---|
| Question | Yesterday I {?1§} a new phone. |
| Réponse | {?1§bought} |
| Deux trous | {?1§buy}{?2§bought} |
Seul le contenu du trou est noté : ce qui l'entoure dans la question est affiché, pas tapé. Dans un fichier d'exercices, la colonne
index pose le numéro du trou, si bien qu'une réponse s'écrit souvent sans balisage du tout.
Affixes : affichés, jamais notés
{type=affix§…} encadre ce qui accompagne la réponse sans en faire partie : la ponctuation finale, la ponctuation
d'ouverture espagnole, des guillemets. L'élève ne la tape pas et n'est jamais pénalisé.
{?1§A coffee, please}{type=affix§.}
{type=affix§¿}Cómo te llamas{type=affix§?}
L'article et le to de l'infinitif anglais sont aussi des affixes, mais ils se déclarent une fois pour toutes dans un pattern (voir Créer un dictionnaire).
Indices et contexte
{type=clue§…} ajoute un indice affiché entre parenthèses : le verbe à conjuguer, un registre, la forme
attendue. Il ne se tape pas. Il est lu à voix haute si l'option Énoncer les indices est cochée
(voir Énonciation et voix).
Yesterday I {?1§}{type=clue§buy} a new phone.
{?1§Comment allez-vous} ?{type=clue§poli}
{type=context§…} lève une ambiguïté, comme le contexte d'un mot du vocabulaire : il est toujours lu. Un indice ne doit
jamais donner la réponse.
Langues
{lang=…§…} signale un fragment écrit dans une autre langue que le reste du texte : il est lu par la voix de sa langue,
avec son accent. Donnez le code complet, avec le pays.
Complétez avec « {lang=pt-PT§ser} ».
{type=clue§{lang=pt-PT§você}, affirmatif}
Sections
Un exercice peut avoir plusieurs sections numérotées, par exemple la phrase à compléter et, à côté, sa traduction pour
guider l'élève. {#2§…} place un texte dans la section 2. Dans un fichier d'exercices, la colonne section de la
ligne _ dit dans quelle section se trouvent la question et la réponse.
{#1§I gave up.}{#2§lang=fr-FR§J'ai abandonné.}
Prononciation
ipa=…§ impose la prononciation du texte qu'il précède, en alphabet phonétique international, quand la synthèse vocale se
trompe. Il ne transcrit que ce texte, jamais la phrase autour.
{?1§ipa=ˈrɛd§{read}}
ipa=kɛlkə ʃoz§ qqch
Écrire un caractère spécial
L'accent grave rend littéral le caractère qui le suit : `{, `}, `|, `§ et
`` pour l'accent grave lui-même. Il sert aussi dans les fichiers CSV, pour une cellule qui commence par ~,
+ ou - sans que ce soit une commande (`+18).
Pas de message d'erreur
Parrot Markup n'est jamais refusé : une accolade en trop ou en moins, un attribut inconnu, rien ne bloque l'import. C'est commode, mais une faute de frappe passe inaperçue.
- Seules les clés
lang,section,input,type,ipaetrefexistent ; une autre (lnag=,part=1) est ignorée et le texte perd sa structure. typen'accepte que des valeurs connues (affix,clue,context…) ; les autres sont ignorées.- Les majuscules comptent :
lang=fr-FR, pasLANG=FR-fr.
Après un import, faites quelques exercices dans l'application : c'est le meilleur contrôle.
Aide-mémoire
| Écriture | Sens |
|---|---|
a|b, {a|b} | alternatives |
{mot |} | mot facultatif |
{?1§} / {?1§réponse} | trou dans la question / réponse attendue |
{?1§{a|b}} | trou à plusieurs réponses |
{type=affix§.} | affiché, jamais noté |
{type=clue§…} | indice entre parenthèses |
{type=context§…} | contexte qui lève une ambiguïté |
{lang=pt-PT§…} | fragment dans une autre langue |
{#2§…} | section 2 |
ipa=…§texte | prononciation imposée |
`{, `|, `§, `` | caractère spécial littéral |