Anleitung für den CSV-Import in Vocabolab ========================================== Diese Anleitung ist für die KI gedacht, die den Content erzeugt (z. B. für eine neue Sprache). Bitte beim Ausfüllen der drei Vorlagen genau beachten: Allgemein --------- - Datei-Kodierung: UTF-8 (gerne mit BOM - erleichtert die korrekte Umlaut-Anzeige beim Öffnen in Excel, wird beim Import ohnehin akzeptiert). Der Thema-Abgleich bei saetze_vorlage.csv (siehe unten) toleriert dabei automatisch beide gängigen Unicode-Schreibweisen von Umlauten (vorkomponiert vs. Basiszeichen+Kombinationszeichen, z. B. je nachdem ob die Datei unter Windows oder macOS erzeugt wurde) - optisch identischer Text wird auch bei unterschiedlicher interner Kodierung korrekt erkannt. - Trennzeichen: Semikolon (;). Dadurch kann z. B. die Übersetzung-Spalte mehrere Bedeutungen einfach kommagetrennt tragen, ohne dass etwas in Anführungszeichen gesetzt werden muss (z. B. "der Tisch, das Pult"). Enthält ein Feld selbst ein Semikolon oder einen Zeilenumbruch, muss es in doppelte Anführungszeichen gesetzt werden (Standard-CSV-Regel, jede Tabellenkalkulation macht das automatisch). - Die Kopfzeile (erste Zeile) muss exakt wie in der Vorlage lauten - Groß-/Kleinschreibung ist egal, die Spaltennamen selbst aber nicht. - Sprache wird NICHT in der CSV-Datei angegeben, sondern beim Hochladen im Formular ausgewählt (gilt für die ganze Datei). - Themen-Kategorie: bei vokabeln_vorlage.csv/grammatikregeln_vorlage.csv ebenfalls NICHT in der Datei, sondern beim Hochladen im Formular ausgewählt (eine CSV-Datei = ein Kapitel/eine Kategorie). Bei saetze_vorlage.csv (Phrasen) ist es umgekehrt: dort trägt JEDE Zeile ihr eigenes Thema in einer eigenen Spalte - siehe unten. vokabeln_vorlage.csv --------------------- Zwei Spalten: - Wort: das Wort/die Wendung in der Zielsprache (z. B. Spanisch). - Übersetzung: die deutsche Übersetzung. Mehrere Bedeutungen einfach kommagetrennt in dasselbe Feld schreiben (z. B. "die Bank, die Sitzbank") - siehe Beispiel in der Vorlage. Ein Wort pro Zeile. Kein Artikel-Zwang, aber gerne wie im Wörterbuch üblich (z. B. "el hermano" statt nur "hermano", wenn das Genus wichtig ist). grammatikregeln_vorlage.csv ----------------------------- Fünf Spalten. WICHTIG: eine Regel kann über MEHRERE Zeilen gehen (eine Zeile pro Übungssatz) - Titel/Erklärung/Aufgabentyp müssen dann in JEDER Zeile dieser Regel gleich sein (oder nur in der ersten Zeile ausgefüllt, die folgenden Zeilen lassen sie leer - siehe Beispiel in der Vorlage). - Regeltitel: Name der Regel in der ZIELSPRACHE (z. B. Spanisch), nicht auf Deutsch - dadurch prägt sich der Fachbegriff beim Lernen gleich mit ein. Identisch für alle Zeilen dieser Regel. - Erklärung: verständliche Erklärung der Regel auf Deutsch. - Aufgabentyp: einer oder mehrere (kommagetrennt) der folgenden drei Werte: * form - die Regel bestimmt die korrekte FORM eines frei wählbaren Inhaltsworts (z. B. Plural, Verbkonjugation, Steigerung). * auswahl - die Regel verlangt die Wahl aus einer kleinen, FEST vorgegebenen Wortmenge ohne eigenes Inhaltswort (z. B. "a/an", "is/are" im Englischen - im Spanischen z. B. "por/para"). * reihenfolge - der Regelkern ist die POSITION eines Wortes im Satz (Wortstellung), nicht seine Form. Nutze das nur, wenn Wortstellung wirklich der Kern der Regel ist. - Lückensatz: ein Übungssatz mit "___" als Lücke. WICHTIG: der Satz muss am Ende in Klammern einen Hinweis tragen, der die Lücke eindeutig macht - bei Aufgabentyp "form" die Grundform des gesuchten Worts (z. B. "(hermano)"), bei "auswahl" alle Alternativen mit Schrägstrich getrennt (z. B. "(por/para)"). Ohne diesen Hinweis kann die Aufgabe beim Üben mehrdeutig sein. - Lösung: die im Satz richtige Form/Wahl (nur die Lösung selbst, nicht die ganze Klammer). Bei Aufgabentyp "reihenfolge" werden keine Lückensätze gebraucht (diese Übung wird beim Üben automatisch aus der Erklärung generiert) - dafür reicht eine einzelne Zeile mit Regeltitel/Erklärung/Aufgabentyp und leerem Lückensatz/Lösung. saetze_vorlage.csv -------------------- Drei Spalten, für den Kommunikations-Bereich (Phrasen = ganze Sätze, keine Einzelwörter): - Thema: eines der 20 festen Standard-Themen, siehe Liste unten - sollte buchstabengetreu (exakte Schreibweise, inkl. "&" und Leerzeichen) einem dieser 20 Werte entsprechen. Passt der Text zu keinem der 20 (z. B. Tippfehler oder eigene Umbenennung) oder ist die Spalte leer, bricht der Import NICHT ab: die Phrase wird trotzdem angelegt, nur ohne automatische Themen-Zuordnung - in der Bestätigungsliste erscheint dann ein Hinweis mit dem ursprünglichen Thema-Text, und das passende Thema kann dort manuell nachgetragen werden, bevor "Übernehmen" möglich ist. Phrasen haben (anders als Vokabeln/ Grammatikregeln) keine Kurs-/Buchzuordnung, nur diese 20 Themen. - Zielsatz: ein vollständiger Satz in der Zielsprache (z. B. eine Redewendung, ein Beispielsatz für eine Gesprächssituation) - kein einzelnes Wort oder Satzfragment. - Übersetzung: die deutsche Übersetzung des ganzen Satzes. Ein Satz pro Zeile. Die mitgelieferte Vorlage enthält bereits alle 20 Themen (in der richtigen Schreibweise) als Ausgangspunkt - für jedes Thema mit derselben Zeile (gleiches Thema, neue Zielsatz-/Übersetzung-Spalte) mehrfach fortsetzen, um mehrere Sätze zu demselben Thema anzulegen. WICHTIG für die KI, die diese Datei befüllt: erzeuge zu JEDEM der 20 unten gelisteten Themen genau [X] Phrasen auf [Y] (Zielsprache, vom Nutzer vorgegeben) - also insgesamt 20 × [X] Zeilen in EINER einzigen Datei, nicht 20 einzelne Dateien. [X] und [Y] durch die tatsächlich gewünschte Anzahl bzw. Sprache ersetzen, bevor diese Anleitung an die KI weitergegeben wird. Die 20 festen Standard-Themen (exakte Schreibweise): Sich vorstellen, Small Talk, Alltagsroutinen, Familie & Freundeskreis, Meinungen & Wünsche, Verabredungen, Essen & Trinken, Einkaufen, Orientierung, Wohnen, Freizeit & Hobby, Schule & Ausbildung, Verkehrsmittel, Nachrichten austauschen, Reisen & Unterkunft, Gesundheit & Arzt, Arbeit & Beruf, Probleme lösen, Erzählungen, Pläne & Ziele Ergebnis: EINE CSV-Datei mit Phrasen zu allen 20 Themen auf einmal - beim Hochladen muss dafür keine Kategorie im Formular ausgewählt werden (das Themen-Auswahlfeld bleibt einfach leer), die Kategorie jeder Phrase ergibt sich automatisch aus ihrer Thema-Spalte. In der Bestätigungsliste ist das passende Thema dadurch bei jeder Phrase schon richtig vorausgewählt - "Alle übernehmen" bestätigt dann alle auf einmal. Nicht alle 20 Themen müssen genutzt werden: soll gezielt nur in bestimmte Themen importiert werden (z. B. nach manueller Nachbearbeitung der Datei), einfach die Zeilen der nicht gewünschten Themen leer lassen (Zielsatz UND Übersetzung leer, Thema-Spalte darf dabei ruhig stehen bleiben) oder ganz löschen - beides wird beim Import automatisch und ohne Fehlermeldung übersprungen. Ein Fehler entsteht nur, wenn Zielsatz ODER Übersetzung alleine fehlt (die jeweils andere Spalte aber ausgefüllt ist) - eine fehlende oder unbekannte Thema-Spalte allein ist dagegen kein Fehler (siehe oben, landet nur ohne automatische Themen-Zuordnung in der Bestätigungsliste). Bestehende Regeln/Vokabeln erweitern -------------------------------------- Wird beim Import derselbe Regeltitel (exakt, plus dieselbe Zielsprache und Kategorie) verwendet, die es in Vocabolab schon gibt - egal ob noch in der Prüfung oder schon bestätigt/live -, werden KEINE Duplikate angelegt. Stattdessen landen die neuen Übungssätze als "Erweiterung" im Bestätigungs-Bereich und werden nach Bestätigung an die bestehende Regel angehängt - Titel/Erklärung/Aufgabentyp der bestehenden Regel bleiben dabei unverändert. Das Gleiche gilt für Vokabeln: existiert ein Wort schon (gleiche Kategorie, gleiche Zielsprache), werden zusätzliche, noch nicht vorhandene Bedeutungen als Erweiterung der bestehenden Übersetzung vorgeschlagen, statt eine zweite Vokabel anzulegen. Bei Phrasen (ganze Sätze) gibt es diesen Erweiterungs-Mechanismus nicht - ein Satz, der (im selben Thema, gleiche Zielsprache) bereits wortgleich existiert, wird schlicht übersprungen (kein Duplikat, aber auch keine Erweiterung). Nach dem Hochladen ------------------- Importierte Einträge landen wie beim Foto-Import zunächst im Bestätigungs-Bereich ("Import" in Verwalten) und müssen dort noch einmal geprüft und bestätigt werden, bevor sie im Training erscheinen.