Super Parrot Dokumentation

Referenz der CSV-Dateien

Die Referenz der Importdateien, Typ für Typ. Für einen ersten Einstieg beginne lieber mit Ein Wörterbuch erstellen und seinem Beispiel.

Gemeinsame Regeln

Sprachcodes

Dateitypen

TypOrdnerKopfzeile (Pflichtspalten fett)
WörterbuchStammordner, nur eineattribute;locale;value
Kategoriencategories/reference;parent;locale;category;selectable;optional;description
Tagstags/reference;parent;locale;tag;selectable;optional;description
Abkürzungenabbreviations/reference;locale;abbreviation;categories
Patternspatterns/reference;locale;name;prefix;suffix
Wortschatzvocabulary/type;reference;locale;text;context;translation_context;ipa;register;frequency;level;categories;tags;pattern;illustration
Verwandte Bedeutungenrelations/meaning;meaning_locale;type;target;target_locale;rank
Übungenexercises/topic;item;attribute;section;index;locale;value
Kurslessons/chapter;lesson;attribute;locale;value

Exporte fügen eine Spalte (oder ein Attribut) id hinzu: die interne Kennung, die das Objekt beim erneuten Import eindeutig wiederfindet. Kopiere sie nicht, wenn du eine Zeile duplizierst, um ein ähnliches Objekt zu erstellen.

Jede Datei ist für ihren Typ in sich abgeschlossen: ein vollständiger Zweig eines Baums, eine Bedeutung mit all ihren Wörtern, eine Serie mit all ihren Items, ein Kapitel mit all seinen Lektionen.

Wörterbuch

AttributWert
titleTitel, eine Zeile pro Sprache
referencelesbare, stabile Referenz
author, organizationAutoren (je eine Zeile), Organisation
typeDICTIONARY (Standard) oder WORKBOOK (mit Kurs)
versionVersion des Inhalts
modelearning (Standard) oder exam; mit exam_order (selection, random) und exam_correction (immediate, end)
speech_localeStimme, die eine Sprache ohne Systemstimme vorliest (co → it-IT)
spoken_abbreviation, spoken_abbreviation_textAussprache einer Abkürzung (sth: ˈsʌmθɪŋ, sth: something)

Wortschatz

SpalteZeile meaningZeile word
referenceReferenz der Bedeutung, freiwillig (sonst m1, m2 …)freiwillig
locale—Sprache des Wortes, mit dem Land
text—das nackte Wort oder der Satz
context—Hauptkontext, in der Sprache des Wortes
translation_context—Übersetzungskontext, in der Sprache der abgefragten Person: de§Fahrzeug
ipa—IPA-Umschrift
register, frequency, level—eine Kategorie der Familien registre, frequence, niveau
categories, tags, pattern—per Referenz (empfohlen) oder Bezeichnung
illustrationBild der Bedeutung (Pfad in resources/)—

Synonyme sind Wörter derselben Bedeutung. Verknüpfungen zwischen verschiedenen Bedeutungen (Plural, Gegenteil, abgeleitetes Wort) gehören in relations/, mit den Typen INFLECTION, OPPOSITE und DERIVED.

Übungen

AttributSerie (_)ItemRolle
title✓Titel, eine Zeile pro Sprache
wording✓✓Anweisung; bei einem Item ersetzt sie die der Serie
example✓angezeigtes Beispiel
question✓✓Serie: Abschnitt und Sprache der Frage; Item: die Aufgabe
answer✓✓Serie: Abschnitt und Sprache der Antwort; Item: eine zulässige Antwort pro Zeile
proposal✓✓Vorschläge zum Antippen, einer pro Zeile
language✓Sprache der Antwort, wenn sie von der der Serie abweicht
categories, tags✓✓für die Filter

Kurs

AttributKapitel (_)LektionWert
title✓✓Titel, eine Zeile pro Sprache (bei einer Lektion freiwillig: der Titel ihres Kursblatts)
order✓✓Rang; Pflicht für das erste Kapitel jeder Datei, wenn es mehrere gibt
note✓Pfad eines Kursblatts (.md oder .html); eine Zeile pro Sprache für die Fassungen desselben Blatts
exercise✓eine Serie, über ihre Referenz oder ihren Titel
vocabulary✓eine Bedeutung: ihre Referenz oder ein Wort mit seiner Sprache (bill [at a restaurant])

Texte: Parrot Markup

Textzellen akzeptieren ein leichtes Markup in geschweiften Klammern, Parrot Markup; einfacher Text bleibt der Normalfall. Das Wichtigste hier; alles Weitere unter Parrot Markup.

SchreibweiseWirkung
{the|}, {colour|color}Alternativen: Alle werden angenommen
{?1§}eine auszufüllende Lücke (Nr. 1) in der Frage
{?1§bought}die erwartete Antwort für Lücke Nr. 1
{type=affix§.}angezeigt, aber nie bewertet (Satzzeichen, Artikel)
{type=clue§past tense}ein Hinweis, in Klammern angezeigt
{#1§lang=fr-FR§Il a abandonné.}ein Abschnitt in einer anderen Sprache (eine leitende Übersetzung)
ipa=ˈsʌmθɪŋ§stherzwingt die Aussprache
`{`der Gravis maskiert ein Sonderzeichen

Kursblätter in Markdown

---
lang: fr-FR
---
# Titel des Kursblatts

**1** Ein Absatz, mit einem hörbaren *Begriff* und etwas **Fettdruck**.

> *Je voudrais un café, s'il vous plaît.*
> Ich hätte gern einen Kaffee, bitte.

## Eine Zwischenüberschrift

| Form | Bedeutung |
|---|---|
| *l'addition* | die Rechnung |

- eine Liste
- siehe Lektion (§2.1)

Aktualisierungen

ModusVerhalten
Erstellungaus der Liste der Wörterbücher; die Datei Wörterbuch ist Pflicht
Ergänzungdie Dateien fügen hinzu und ändern; eine leere Zelle ändert nichts; nichts wird archiviert
Vollständige Versiondie Dateien beschreiben alles: Eine leere Zelle löscht, was fehlt, wird archiviert (und lässt sich wiederherstellen)
Einfließen lassendie Dateien werden in ein anderes Wörterbuch übernommen; gemeinsame Wörter werden zusammengeführt; bei einem Konflikt hat das Zielwörterbuch Vorrang

Ein Objekt wird über seine Kennung gefunden, dann über seine geschriebene Referenz, dann über seinen Inhalt (eine Bedeutung über ihre unveränderten Wörter, ein korrigiertes Wort über seine Ähnlichkeit). Deshalb bleiben Referenzen freiwillig.