Super Parrot Dokumentation

Parrot Markup

Parrot Markup ist die kleine Syntax, die die Texte eines Wörterbuchs anreichert: die Lücken einer Übung, die zulässigen Antworten, nicht bewertete Satzzeichen, Hinweise, Wörter in einer anderen Sprache, die Aussprache. Einfacher Text bleibt einfacher Text: Markup fügst du nur dort hinzu, wo es nützt.

Wo es verwendet wird

TextÜbliche Verwendung
Übungen (value von Fragen, Antworten, Vorschlägen)Lücken, Affixe, Hinweise, Alternativen
Anweisungen und Titelein in einer anderen Sprache zitiertes Wort: {lang=pt-PT§ser}
Wörter des Wortschatzes (text)zulässige Schreibweisen: colour|color
translation_contextein Kontext pro Sprache: {lang=de§Fahrzeug}{lang=pt§veículo}
Patterns (prefix, suffix)erzwungene Aussprache: ipa=ˈsʌmθɪŋ§ sth

Fünf Sonderzeichen

ZeichenRolle
{ }umschließen eine Gruppe
|trennt Alternativen
§beendet ein Attribut am Anfang eines Textes
`maskiert das folgende Zeichen

Alles andere, Leerzeichen eingeschlossen, ist gewöhnlicher Text.

Alternativen

| trennt Formen, die alle angenommen werden. Außerhalb von Klammern gilt es für den ganzen Text, innerhalb nur für den Teil, der variiert.

SchreibweiseAngenommene Antworten
colour|colorcolour, color
I'd like {a flat|an apartment}I'd like a flat, I'd like an apartment
{the |}cinemathe cinema, cinema: Ein leerer Zweig macht ein Wort freiwillig

In einer Übungsdatei schreibst du besser eine Zeile answer oder proposal pro Antwort: Der Import fügt sie selbst mit | zusammen, und die Tabelle bleibt lesbar.

Attribute

Ein Attribut wird Schlüssel=Wert§ am Anfang eines Textes geschrieben, meist in einer Gruppe: {lang=pt-PT§ser}. Mehrere Attribute folgen aufeinander, jedes mit seinem eigenen §, in beliebiger Reihenfolge: {type=clue§lang=fr-FR§passé} entspricht {lang=fr-FR§type=clue§passé}.

AttributWirkung
?1§ (oder input=1§)eine nummerierte Lücke
#1§ (oder section=1§)ein nummerierter Abschnitt der Übung
lang=…§die Sprache des Textes: Er wird von der Stimme dieser Sprache gelesen
type=affix§ein Affix: angezeigt, nie bewertet
type=clue§ein Hinweis, in Klammern angezeigt
type=context§ein Kontext, der eine Mehrdeutigkeit beseitigt
ipa=…§die erzwungene Aussprache

Ein Attribut gilt nur für den Zweig, vor dem es steht. {?1§was|were} bedeutet „was in Lücke 1 oder were außerhalb der Lücke“: were würde abgelehnt. Damit die Lücke beides annimmt, umschließe die Alternativen: {?1§{was|were}}.

Lücken

In der Frage markiert {?1§} die auszufüllende Stelle. In der Antwort gibt {?1§bought} an, was in dieser Lücke erwartet wird. Mehrere Lücken werden ?1, ?2 … nummeriert.

Schreibweise
FrageYesterday I {?1§} a new phone.
Antwort{?1§bought}
Zwei Lücken{?1§buy}{?2§bought}

Nur der Inhalt der Lücke wird bewertet: Was ihn in der Frage umgibt, wird angezeigt, nicht getippt. In einer Übungsdatei setzt die Spalte index die Nummer der Lücke, sodass eine Antwort oft ganz ohne Markup auskommt.

Affixe: angezeigt, nie bewertet

{type=affix§…} umschließt, was zur Antwort gehört, ohne Teil davon zu sein: das Satzzeichen am Ende, die spanischen Eröffnungszeichen, Anführungszeichen. Lernende tippen es nicht und werden nie dafür bestraft.

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

Der Artikel und das to des englischen Infinitivs sind ebenfalls Affixe, werden aber ein für alle Mal in einem Pattern angegeben (siehe Ein Wörterbuch erstellen).

Hinweise und Kontext

{type=clue§…} fügt einen Hinweis in Klammern hinzu: das zu konjugierende Verb, ein Register, die erwartete Form. Er wird nicht getippt. Er wird vorgelesen, wenn die Option Hinweise vorlesen angehakt ist (siehe Vorlesen und Stimme).

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

{type=context§…} beseitigt eine Mehrdeutigkeit, wie der Kontext eines Wortes im Wortschatz: Er wird immer vorgelesen. Ein Hinweis darf die Antwort nie verraten.

Sprachen

{lang=…§…} kennzeichnet ein Fragment in einer anderen Sprache als der übrige Text: Es wird von der Stimme seiner Sprache gelesen, mit deren Akzent. Gib den vollständigen Code mit dem Land an.

Ergänze mit „{lang=pt-PT§ser}“.
{type=clue§{lang=pt-PT§você}, bejahend}

Abschnitte

Eine Übung kann mehrere nummerierte Abschnitte haben, zum Beispiel den zu ergänzenden Satz und daneben seine Übersetzung als Hilfe. {#2§…} setzt einen Text in Abschnitt 2. In einer Übungsdatei gibt die Spalte section der Zeile _ an, in welchem Abschnitt Frage und Antwort stehen.

{#1§I gave up.}{#2§lang=de-DE§Ich habe aufgegeben.}

Aussprache

ipa=…§ erzwingt die Aussprache des folgenden Textes im Internationalen Phonetischen Alphabet, wenn sich die Sprachausgabe irrt. Es umschreibt nur diesen Text, nie den Satz drumherum.

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

Ein Sonderzeichen schreiben

Der Gravis macht das folgende Zeichen wörtlich: `{, `}, `|, `§ und `` für den Gravis selbst. Er dient auch in CSV-Dateien für eine Zelle, die mit ~, + oder - beginnt, ohne ein Befehl zu sein (`+18).

Keine Fehlermeldungen

Parrot Markup wird nie abgelehnt: eine Klammer zu viel oder zu wenig, ein unbekanntes Attribut – nichts blockiert den Import. Das ist bequem, aber ein Tippfehler bleibt unbemerkt.

Mach nach einem Import ein paar Übungen in der App: Das ist die beste Kontrolle.

Spickzettel

SchreibweiseBedeutung
a|b, {a|b}Alternativen
{Wort |}freiwilliges Wort
{?1§} / {?1§Antwort}Lücke in der Frage / erwartete Antwort
{?1§{a|b}}Lücke mit mehreren Antworten
{type=affix§.}angezeigt, nie bewertet
{type=clue§…}Hinweis in Klammern
{type=context§…}Kontext, der eine Mehrdeutigkeit beseitigt
{lang=pt-PT§…}Fragment in einer anderen Sprache
{#2§…}Abschnitt 2
ipa=…§Texterzwungene Aussprache
`{, `|, `§, ``Sonderzeichen wörtlich