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
- Kodierung UTF-8 (ein BOM am Anfang, wie Excel es schreibt, wird toleriert).
- Trennzeichen
; oder Tabulator, erkannt an der Kopfzeile. Das Komma trennt mehrere Werte innerhalb
einer Zelle (noun, fem).
- Anführungszeichen: Eine Zelle, die das Trennzeichen, ein Anführungszeichen oder einen Zeilenumbruch enthält, wird
in
" eingeschlossen, und ein inneres Anführungszeichen wird verdoppelt. Tabellenkalkulationen tun das selbst.
- Kopfzeile Pflicht, genaue Spaltennamen, beliebige Reihenfolge. Eine fehlende Pflichtspalte oder eine unbekannte
Spalte macht die Datei ungültig: Ein Tippfehler geht nie stillschweigend verloren.
- Ignorierte Zeilen: leere, oder solche, deren erste Zelle mit
# beginnt.
- Wahrheitswerte:
x = ja, leer = nein.
- Löschen eines Wertes bei einer Aktualisierung als Ergänzung: eine Zelle, die nur
~ enthält.
- Ändern einer Liste als Ergänzung:
+Reisen fügt hinzu, -Handel entfernt.
Sprachcodes
- Bezeichnungen (Titel, Kategorien, Tags, Abkürzungen): nackter Code
de, en, pt; ein regionaler
Code nur, wenn er etwas aussagt.
- Wörter und Übungen: die Sprache mit dem Land, wenn das Wörterbuch sie unterscheidet (
de-DE, de-AT,
en-GB, pt-BR).
Dateitypen
| Typ | Ordner | Kopfzeile (Pflichtspalten fett) |
| Wörterbuch | Stammordner, nur eine | attribute;locale;value |
| Kategorien | categories/ | reference;parent;locale;category;selectable;optional;description |
| Tags | tags/ | reference;parent;locale;tag;selectable;optional;description |
| Abkürzungen | abbreviations/ | reference;locale;abbreviation;categories |
| Patterns | patterns/ | reference;locale;name;prefix;suffix |
| Wortschatz | vocabulary/ | type;reference;locale;text;context;translation_context;ipa;register;frequency;level;categories;tags;pattern;illustration |
| Verwandte Bedeutungen | relations/ | meaning;meaning_locale;type;target;target_locale;rank |
| Übungen | exercises/ | topic;item;attribute;section;index;locale;value |
| Kurs | lessons/ | 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
| Attribut | Wert |
title | Titel, eine Zeile pro Sprache |
reference | lesbare, stabile Referenz |
author, organization | Autoren (je eine Zeile), Organisation |
type | DICTIONARY (Standard) oder WORKBOOK (mit Kurs) |
version | Version des Inhalts |
mode | learning (Standard) oder exam; mit exam_order
(selection, random) und exam_correction (immediate, end) |
speech_locale | Stimme, die eine Sprache ohne Systemstimme vorliest (co → it-IT) |
spoken_abbreviation, spoken_abbreviation_text | Aussprache einer Abkürzung
(sth: ˈsʌmθɪŋ, sth: something) |
Wortschatz
| Spalte | Zeile meaning | Zeile word |
| reference | Referenz 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 |
| illustration | Bild 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
| Attribut | Serie (_) | Item | Rolle |
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
| Attribut | Kapitel (_) | Lektion | Wert |
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.
| Schreibweise | Wirkung |
{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θɪŋ§sth | erzwingt 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)
- Der Kopf
lang gibt die Sprache des Stoffs an: Begriffe in *Kursivschrift* werden hörbar.
*[en-US] sidewalk* markiert eine regionale Variante; *schedule /ˈʃɛdjuːl/* fügt eine Aussprache hinzu.
- Ein Zitat
> = ein Beispiel und seine Übersetzung; ein Satz pro Zitat.
(§8.3) verweist auf Lektion 3 von Kapitel 8 und wird in der App zu einem Link.
- Ebenfalls angenommen: Überschriften
# und ##, Tabellen, Listen -,
~~durchgestrichen~~, `Code`.
Aktualisierungen
| Modus | Verhalten |
| Erstellung | aus der Liste der Wörterbücher; die Datei Wörterbuch ist Pflicht |
| Ergänzung | die Dateien fügen hinzu und ändern; eine leere Zelle ändert nichts; nichts wird archiviert |
| Vollständige Version | die Dateien beschreiben alles: Eine leere Zelle löscht, was fehlt, wird archiviert (und lässt sich
wiederherstellen) |
| Einfließen lassen | die 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.