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 | Предложение на языке A | Das 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
- Вставьте ссылку на таблицу (режим просмотра).
- Проверьте доступ: Anyone with the link → Viewer.
- Загрузите и импортируйте после предпросмотра.
📊 Результаты импорта
| Показатель | Описание |
|---|---|
| Источник | CSV / JSON / Sheets / Вручную |
| Добавлено | Сколько новых карточек добавлено |
| Пропущено | Дубликаты или пустые строки |
| В колоде | Итоговый размер после импорта |
🧰 Управление колодой
- Экспорт CSV — выгрузка всей колоды в CSV.
- Экспорт JSON — резервная копия, пригодная для восстановления.
- Очистить колоду — вернёт демо-набор.
💾 Хранение и лимиты
| Ключ | Назначение |
|---|---|
deru_min_deck_v1 | все карточки пользователя |
deru_min_v132 | служебные настройки импорта |
Лимиты: максимум 1000 карточек (рекомендовано ≤ 800 для стабильной работы).
⚠️ Ошибки и решения
| Сообщение | Что делать |
|---|---|
| «Файл слишком большой» | Уменьшите размер CSV/JSON (лимит ~3 МБ). |
| «Не найдены front/back» | Проверьте заголовки колонок и кодировку UTF-8. |
| «Нечего импортировать» | Добавьте пары front/back хотя бы для одной строки. |
| «Достигнут лимит колоды» | Сделайте экспорт/очистку перед новым импортом. |
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
📘 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.
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
| Key | Inhalt |
|---|---|
vokbox_train_v13_state | Richtung, TTS-Einstellungen, „Heute gewusst“, „Heute abgedeckt“, Sitzungsgröße |
deru_min_deck_v1 | alle 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:
| Feld | Beschreibung | Beispiel |
|---|---|---|
| A (front) | Wort in der Fremdsprache | Haus |
| B (back) | Übersetzung | дом |
| Beispiel A | Satz auf Seite A | Das Haus ist groß. |
| Beispiel B | Übersetzung des Beispiels | Дом большой. |
| Grammatik | Wortart | Nomen / 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/ruodera/b, sowieexample,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
- Füge den Link zur Tabelle im Ansichtsmodus ein.
- Stelle den Zugriff auf Anyone with the link → Viewer.
- Lade die Tabelle und importiere nach der Vorschau.
📊 Import-Ergebnisse
| Wert | Beschreibung |
|---|---|
| Quelle | CSV / JSON / Sheets / Manuell |
| Hinzugefügt | Anzahl der neuen Karten |
| Übersprungen | Duplikate oder leere Zeilen |
| Im Deck | Deckgröß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
| Key | Funktion |
|---|---|
deru_min_deck_v1 | alle Benutzerkarten |
deru_min_v132 | interne Importeinstellungen |
Limits: maximal 1000 Karten (empfohlen ≤ 800 für stabile Performance).
⚠️ Fehler & Lösungen
| Meldung | Lö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. |
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
📘 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.
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
| Key | Content |
|---|---|
vokbox_train_v13_state | direction, TTS settings, “Known today”, “Covered today”, session size |
deru_min_deck_v1 | all 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:
| Field | Description | Example |
|---|---|---|
| A (front) | Word in the source language | Haus |
| B (back) | Translation | house |
| Example A | Sentence on side A | The house is big. |
| Example B | Translation of the example | Дом большой. |
| Grammar | Part of speech | Noun / 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/ruora/b, alsoexample,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
- Paste the link to the sheet (view mode).
- Make sure access is set to Anyone with the link → Viewer.
- Load the sheet and import after previewing.
📊 Import results
| Metric | Description |
|---|---|
| Source | CSV / JSON / Sheets / Manual |
| Added | Number of new cards added |
| Skipped | Duplicates or empty lines |
| In deck | Final 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
| Key | Purpose |
|---|---|
deru_min_deck_v1 | all user cards |
deru_min_v132 | internal import settings |
Limits: maximum 1000 cards (recommended ≤ 800 for stable performance).
⚠️ Errors & solutions
| Message | What 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. |
Produkte
Unternehmen
Copyright © 2026 VokBox | Testprojekt (MVP)