VokBox — Справка по обучению и импорту

На этой странице собраны инструкции по двум разделам: Обучение (тренировка карточек) и Импорт (создание и добавление карточек). Все данные карточек сохраняются локально в вашем браузере.

📘 Обучение: обзор

Раздел «Обучение» показывает карточки из вашей локальной колоды и позволяет тренировать слова в обеих направлениях (A→B и B→A). Интерфейс поддерживает переворот карточки, оценку знания («Знаю/Не знаю»), озвучку, лимит сессии и сохранение прогресса за сегодня.

Строка состояния и прогресс

  • В колоде — общее количество карточек, доступных для обучения.
  • Просмотрено — сколько карточек показано в текущей сессии (из общего числа в очереди).
  • Знаю сегодня — сколько раз вы нажали «Знаю» сегодня.
  • Покрыто сегодня — уникальные карточки, показанные сегодня.
  • Полоса прогресса — визуальный процент прохождения текущей очереди.

Размер сессии и добавление карточек

  • Выберите лимит: 5, 10, 20 или ВСЕ.
  • Кнопки +5 / +10 / +20 добавляют новые карточки в текущую очередь из «непоказанных сегодня».
  • Кнопка Сброс очищает прогресс текущей сессии (колода не удаляется).

Озвучка (мультиязычная)

Озвучивается язык активной стороны (A или B). Выберите голос для стороны A и стороны B (например, de-DE и ru-RU). Браузер использует Web Speech API.

💡 У некоторых устройств набор голосов загружается с задержкой; если озвучка не началась — повторите попытку через несколько секунд.

Работа с карточкой

  • Лицевая сторона показывает слово активной стороны (A или B).
  • Обратная сторона — перевод, грамматика (если указана), примеры A/B.
  • Нажмите на карточку (тап/клик), чтобы перевернуть.

Действия и горячие клавиши

  • Показать — переворот карточки (горячая клавиша R).
  • Озвучить — проговаривание активной стороны с примером (горячая клавиша S).
  • Не знаю — карточка вернётся через несколько шагов (горячая клавиша 1).
  • Знаю — увеличивает счётчик «Знаю сегодня» (горячая клавиша 3).
  • Назад / Далее — навигация по истории (горячие клавиши B / N).

Где хранится прогресс

КлючСодержимое
vokbox_train_v13_stateнастройки направления, TTS, «Знаю сегодня», «Покрыто сегодня», лимит сессии
deru_min_deck_v1все ваши карточки (общий ключ колоды для обучения и импорта)

FAQ и советы

  • Карточки закончились? Добавьте новые через раздел «Импорт» или кнопку «+5/10/20» (если есть непоказанные за сегодня).
  • Голоса не читают? Проверьте разрешение звука/мультимедиа в браузере; попробуйте другой язык голоса.

📥 Импорт: возможности

Раздел «Импорт» позволяет добавлять карточки вручную, массово (вставкой текста) или из файлов CSV/JSON/Google Sheets. Дубликаты по стороне A автоматически пропускаются. Лимит колоды — 1000 карточек (рекомендовано ≤ 800 для стабильности).

⚡ Быстрое добавление

Заполните поля и нажмите «Добавить». Доступные поля:

ПолеОписаниеПример
A (front)Слово на иностранном языкеHaus
B (back)Переводдом
Пример AПредложение на языке ADas Haus ist groß.
Пример BПеревод примераДом большой.
ГрамматикаТип словаNomen / Verb
  • Очистить поля — сброс формы.
  • Массовая вставка — переход к пакетному добавлению.

📥 Массовая вставка

Вставьте блок строк. Формат — одна карточка в строке:

front; back; example_front; example_back; grammar
Haus; дом; Das Haus ist groß.; Дом большой.; Nomen
gehen; идти; Ich gehe nach Hause.; Я иду домой.; Verb

Поддерживаются разделители: ;, , и TAB. Нажмите Импортировать.

📄 Шаблоны

  • Используйте заголовки колонок: front, back, example_front, example_back, grammar.
  • Допустимы аналоги: de/ru или a/b, а также example, example_de, example_ru.

📂 Импорт CSV / JSON / Google Sheets

CSV

  • Выберите файл CSV (UTF-8). Система попробует автоматически определить колонки.
  • При необходимости вручную сопоставьте колонки (front/back/…)

JSON

  • Поддержка структуры [{front:'',back:''}] или {deck:[...]}.

Google Sheets

  1. Вставьте ссылку на таблицу (режим просмотра).
  2. Проверьте доступ: Anyone with the link → Viewer.
  3. Загрузите и импортируйте после предпросмотра.

📊 Результаты импорта

ПоказательОписание
ИсточникCSV / JSON / Sheets / Вручную
ДобавленоСколько новых карточек добавлено
ПропущеноДубликаты или пустые строки
В колодеИтоговый размер после импорта

🧰 Управление колодой

  • Экспорт CSV — выгрузка всей колоды в CSV.
  • Экспорт JSON — резервная копия, пригодная для восстановления.
  • Очистить колоду — вернёт демо-набор.

💾 Хранение и лимиты

КлючНазначение
deru_min_deck_v1все карточки пользователя
deru_min_v132служебные настройки импорта

Лимиты: максимум 1000 карточек (рекомендовано ≤ 800 для стабильной работы).

⚠️ Ошибки и решения

СообщениеЧто делать
«Файл слишком большой»Уменьшите размер CSV/JSON (лимит ~3 МБ).
«Не найдены front/back»Проверьте заголовки колонок и кодировку UTF-8.
«Нечего импортировать»Добавьте пары front/back хотя бы для одной строки.
«Достигнут лимит колоды»Сделайте экспорт/очистку перед новым импортом.
⚠️ При очистке данных браузера (Cache/LocalStorage) все карточки будут удалены. Делайте экспорт регулярно (например, раз в неделю).
💡 Готово к практике? Перейдите к разделу Обучение или добавьте новые слова в разделе Импорт.

VokBox – Hilfe zu Lernen und Import

Auf dieser Seite findest du Anleitungen zu zwei Bereichen: Lernen (Training mit Karten) und Import (Erstellen und Hinzufügen von Karten). Alle Kartendaten werden lokal in deinem Browser gespeichert.

📘 Lernen: Überblick

Im Bereich „Lernen“ werden Karten aus deinem lokalen Deck angezeigt. Du trainierst Wörter in beide Richtungen (A→B und B→A). Die Oberfläche unterstützt Kartendrehung, Bewertung („Ich weiß / Ich weiß nicht“), Sprachausgabe, Sitzungs-Limit und Tagesfortschritt.

Statusleiste und Fortschritt

  • Im Deck – Gesamtzahl der Karten, die zum Lernen verfügbar sind.
  • Angesehen – wie viele Karten in der aktuellen Sitzung gezeigt wurden.
  • Heute gewusst – wie oft du heute „Ich weiß“ gedrückt hast.
  • Heute abgedeckt – einzigartige Karten, die heute angezeigt wurden.
  • Fortschrittsbalken – visueller Prozentsatz der aktuellen Warteschlange.

Sitzungsgröße & Kartenzugabe

  • Wähle ein Limit: 5, 10, 20 oder ALLE.
  • Die Buttons +5 / +10 / +20 fügen neue Karten aus den „heute noch nicht gezeigten“ hinzu.
  • Der Button Zurücksetzen löscht den Fortschritt der aktuellen Sitzung (das Deck bleibt erhalten).

Sprachausgabe (mehrsprachig)

Gelesen wird die aktive Seite (A oder B). Wähle eine Stimme für Seite A und Seite B (z.B. de-DE und ru-RU). Der Browser verwendet die Web Speech API.

💡 Auf manchen Geräten werden Stimmen verzögert geladen. Wenn nichts vorgelesen wird, versuche es nach einigen Sekunden erneut.

Arbeiten mit der Karte

  • Die Vorderseite zeigt das Wort der aktiven Seite (A oder B).
  • Die Rückseite enthält Übersetzung, Grammatik (falls vorhanden) und Beispiele A/B.
  • Klicke oder tippe auf die Karte, um sie zu drehen.

Aktionen & Tastenkürzel

  • Anzeigen – Karte drehen (Tastenkürzel R).
  • Vorlesen – aktive Seite plus Beispiel sprechen (Tastenkürzel S).
  • Ich weiß nicht – Karte erscheint nach einigen Schritten erneut (Taste 1).
  • Ich weiß – erhöht „Heute gewusst“ (Taste 3).
  • Zurück / Weiter – Navigation in der Historie (Tasten B / N).

Wo Fortschritt gespeichert wird

KeyInhalt
vokbox_train_v13_stateRichtung, TTS-Einstellungen, „Heute gewusst“, „Heute abgedeckt“, Sitzungsgröße
deru_min_deck_v1alle deine Karten (gemeinsamer Deck-Schlüssel für Lernen und Import)

FAQ & Tipps

  • Keine Karten mehr? Füge neue im Bereich „Import“ hinzu oder nutze „+5/10/20“, wenn es noch ungesehene Karten gibt.
  • Keine Stimme? Prüfe Audio-Rechte im Browser und probiere andere Sprachen aus.

📥 Import: Funktionen

Im Bereich „Import“ kannst du Karten manuell, per Masseneingabe oder aus CSV/JSON/Google Sheets hinzufügen. Doppelte Einträge (Seite A) werden automatisch übersprungen. Deck-Limit: 1000 Karten (empfohlen ≤ 800 für Stabilität).

⚡ Schnelles Hinzufügen

Fülle die Felder aus und klicke auf „Hinzufügen“. Verfügbare Felder:

FeldBeschreibungBeispiel
A (front)Wort in der FremdspracheHaus
B (back)Übersetzungдом
Beispiel ASatz auf Seite ADas Haus ist groß.
Beispiel BÜbersetzung des BeispielsДом большой.
GrammatikWortartNomen / Verb
  • Felder leeren – Formular zurücksetzen.
  • Masseneingabe – zur Stapelverarbeitung wechseln.

📥 Masseneingabe

Füge mehrere Zeilen ein. Format – eine Karte pro Zeile:

front; back; example_front; example_back; grammar
Haus; дом; Das Haus ist groß.; Дом большой.; Nomen
gehen; идти; Ich gehe nach Hause.; Я иду домой.; Verb

Unterstützte Trennzeichen: ;, , und TAB. Klicke anschließend auf Importieren.

📄 Vorlagen

  • Nutze die Spaltenüberschriften: front, back, example_front, example_back, grammar.
  • Erlaubte Alternativen: de/ru oder a/b, sowie example, example_de, example_ru.

📂 Import CSV / JSON / Google Sheets

CSV

  • Wähle eine CSV-Datei (UTF-8). Das System versucht, die Spalten automatisch zu erkennen.
  • Falls nötig, kannst du die Spalten manuell zuordnen.

JSON

  • Unterstützte Struktur: [{front:'',back:''}] oder {deck:[...]}.

Google Sheets

  1. Füge den Link zur Tabelle im Ansichtsmodus ein.
  2. Stelle den Zugriff auf Anyone with the link → Viewer.
  3. Lade die Tabelle und importiere nach der Vorschau.

📊 Import-Ergebnisse

WertBeschreibung
QuelleCSV / JSON / Sheets / Manuell
HinzugefügtAnzahl der neuen Karten
ÜbersprungenDuplikate oder leere Zeilen
Im DeckDeckgröße nach dem Import

🧰 Kartenstapel verwalten

  • CSV-Export – exportiert alle Karten als CSV.
  • JSON-Export – vollständige Sicherungskopie des Decks.
  • Deck zurücksetzen – stellt das Demo-Deck wieder her.

💾 Speicherung & Limits

KeyFunktion
deru_min_deck_v1alle Benutzerkarten
deru_min_v132interne Importeinstellungen

Limits: maximal 1000 Karten (empfohlen ≤ 800 für stabile Performance).

⚠️ Fehler & Lösungen

MeldungLösung
„Datei ist zu groß“CSV/JSON verkleinern (Limit ~3 MB).
„front/back nicht gefunden“Spaltenüberschriften und UTF-8-Kodierung prüfen.
„Nichts zu importieren“Mindestens ein Paar front/back ergänzen.
„Deck-Limit erreicht“Deck exportieren/aufräumen und erneut importieren.
⚠️ Beim Löschen von Browserdaten (Cache/LocalStorage) werden alle Karten entfernt. Erstelle regelmäßig Exporte (z.B. einmal pro Woche).
💡 Bereit zum Üben? Gehe zu Lernen oder füge neue Wörter unter Import hinzu.

VokBox — Help: Training & Import

This page explains how to use two main areas: Training (flashcard practice) and Import (creating and adding cards). All flashcard data is stored locally in your browser.

📘 Training: overview

The “Training” section shows cards from your local deck and lets you practice in both directions (A→B and B→A). The interface supports card flipping, “Know / Don’t know” grading, text-to-speech, session limits, and daily progress tracking.

Status bar & progress

  • In deck – total number of cards available for training.
  • Viewed – how many cards have been shown in the current session.
  • Known today – how many times you pressed “Know” today.
  • Covered today – unique cards shown today.
  • Progress bar – visual percentage of the current queue.

Session size & adding cards

  • Choose a limit: 5, 10, 20 or ALL.
  • The buttons +5 / +10 / +20 add new cards to the current queue from “not yet shown today”.
  • The Reset button clears progress for the current session (your deck is not deleted).

Text-to-speech (multilingual)

The active side (A or B) is spoken. Select a voice for side A and side B (for example, de-DE and en-US). The browser uses the Web Speech API.

💡 On some devices voices load with a delay. If nothing is spoken, try again after a few seconds.

How the card works

  • The front shows the word on the active side (A or B).
  • The back shows the translation, grammar (if set) and examples for A/B.
  • Click or tap the card to flip it.

Actions & keyboard shortcuts

  • Reveal – flip the card (shortcut R).
  • Speak – read the active side plus example (shortcut S).
  • Don’t know – the card will reappear after a few steps (shortcut 1).
  • Know – increases the “Known today” counter (shortcut 3).
  • Back / Next – navigate history (shortcuts B / N).

Where progress is stored

KeyContent
vokbox_train_v13_statedirection, TTS settings, “Known today”, “Covered today”, session size
deru_min_deck_v1all your cards (shared deck key for Training and Import)

FAQ & tips

  • Out of cards? Add new ones in the “Import” section or use “+5/10/20” if there are still cards not shown today.
  • No sound? Check audio permissions in the browser and try a different language voice.

📥 Import: what you can do

The “Import” section lets you add cards manually, via bulk paste, or from CSV/JSON/Google Sheets. Duplicate entries (same A value) are skipped automatically. Deck limit: 1000 cards (recommended ≤ 800 for stability).

⚡ Quick add

Fill in the fields and click “Add”. Available fields:

FieldDescriptionExample
A (front)Word in the source languageHaus
B (back)Translationhouse
Example ASentence on side AThe house is big.
Example BTranslation of the exampleДом большой.
GrammarPart of speechNoun / Verb
  • Clear fields – reset the form.
  • Bulk paste – switch to batch input.

📥 Bulk paste

Paste multiple lines. Format: one card per line:

front; back; example_front; example_back; grammar
Haus; house; The house is big.; Дом большой.; Noun
go; идти; I go home.; Я иду домой.; Verb

Supported separators: ;, , and TAB. Then click Import.

📄 Templates

  • Use these column headers: front, back, example_front, example_back, grammar.
  • Allowed aliases: de/ru or a/b, also example, example_de, example_ru.

📂 Import CSV / JSON / Google Sheets

CSV

  • Select a CSV file (UTF-8). The system will try to detect columns automatically.
  • If needed, map the columns manually (front/back/…)

JSON

  • Supported structure: [{front:'',back:''}] or {deck:[...]}.

Google Sheets

  1. Paste the link to the sheet (view mode).
  2. Make sure access is set to Anyone with the link → Viewer.
  3. Load the sheet and import after previewing.

📊 Import results

MetricDescription
SourceCSV / JSON / Sheets / Manual
AddedNumber of new cards added
SkippedDuplicates or empty lines
In deckFinal deck size after import

🧰 Manage your deck

  • Export CSV – download the entire deck as CSV.
  • Export JSON – full backup of all cards.
  • Reset deck – restore the demo deck.

💾 Storage & limits

KeyPurpose
deru_min_deck_v1all user cards
deru_min_v132internal import settings

Limits: maximum 1000 cards (recommended ≤ 800 for stable performance).

⚠️ Errors & solutions

MessageWhat to do
“File is too large”Reduce CSV/JSON size (limit ~3 MB).
“front/back not found”Check column headers and UTF-8 encoding.
“Nothing to import”Add at least one front/back pair.
“Deck limit reached”Export/clean your deck before importing more.
⚠️ If you clear browser data (Cache/LocalStorage), all cards will be removed. Export your deck regularly (for example, once a week).
💡 Ready to practice? Go to Training or add new words in the Import section.