Super Parrot Documentation

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

TexteUsage courant
Exercices (value des questions, réponses, propositions)trous, affixes, indices, alternatives
Consignes et titresun mot cité dans une autre langue : {lang=pt-PT§ser}
Mots du vocabulaire (text)graphies admises : colour|color
translation_contextun 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èreRô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.

ÉcritureRéponses acceptées
colour|colorcolour, color
I'd like {a flat|an apartment}I'd like a flat, I'd like an apartment
{the |}cinemathe 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é}.

AttributEffet
?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
QuestionYesterday 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.

Après un import, faites quelques exercices dans l'application : c'est le meilleur contrôle.

Aide-mémoire

ÉcritureSens
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=…§texteprononciation imposée
`{, `|, `§, ``caractère spécial littéral