Skip to content

MANUAL_UA.md

Latest commit

 

History

History
130 lines (78 loc) · 7.39 KB

MANUAL_UA.md

File metadata and controls

130 lines (78 loc) · 7.39 KB

JsonLines Editor - Посібник користувача

Версія 0.1.2

Швидкий посібник

Базовий робочий процес

  1. Відкрити файл: Файл > Відкрити (Ctrl+O) або спробуйте example.jsonl
  2. Вибрати рядок у таблиці для редагування
  3. Змінити поля у панелі редактора праворуч
  4. Натиснути "Зберегти елемент" для застосування змін до таблиці
  5. Зберегти файл: Файл > Зберегти (Ctrl+S)

Додавання нових записів

  1. Натисніть кнопку "Додати рядок" або залишіть рядок невибраним
  2. Заповніть усі п'ять полів на панелі редактора
  3. Натисніть "Зберегти елемент"
  4. Збережіть файл через Ctrl+S

Формат файлу

Кожен рядок - це JSON об'єкт з п'ятьма обов'язковими полями:

{"term":"Локальний термін","original_term":"Оригінальний термін","definition":"Локальне визначення","original_definition":"Оригінальне визначення","source":"Джерело"}

Вступ

JsonLines Editor - це інструмент для редагування JSONL файлів, що містять багатомовні визначення термінів, призначений для підготовки навчальних датасетів для мовних моделей. Формат JSON Lines зберігає по одному JSON об'єкту на рядок, що робить його ефективним для порядкової обробки в процесах машинного навчання.

Інтерфейс користувача

Основні компоненти

Табличне представлення (центр): Відображає всі записи в колонках: Термін, Оригінальний термін, Визначення, Оригінальне визначення та Джерело.

Панель редактора (праворуч): Поля введення для редагування окремих записів. Зміни активують кнопку "Зберегти елемент".

Панель інструментів:

  • Додати рядок - Вставити новий порожній рядок
  • Видалити рядок - Видалити вибраний рядок
  • Зберегти елемент - Застосувати зміни редактора до таблиці
  • Кнопки пошуку - Відкрити пошук Google для термінів

Меню: Файл (Створити/Відкрити/Зберегти/Закрити), Правка (Очистити кеш), Довідка (Про програму)

Вкладка журналу: Журнал операцій поточної сесії

Робота з файлами

Відкриття файлів

Файл > Відкрити (Ctrl+O) - Вибрати JSONL файл. Програма перевіряє структуру JSON і показує помилки з номерами рядків, якщо вони знайдені.

Збереження файлів

Файл > Зберегти (Ctrl+S) - Зберігає в поточний файл з автоматичним створенням резервної копії.

Файл > Зберегти як - Зберегти з новою назвою.

Створення нових файлів

Файл > Створити (Ctrl+N) - Створює порожній файл, позначений як "незбережений". Додайте записи, потім використайте "Зберегти як".

Помилки файлів

  • Недопустимий JSON: Перевірте номер рядка в повідомленні про помилку
  • Не об'єкт: Кожен рядок повинен бути JSON об'єктом, а не масивом/рядком
  • Неможливо зберегти: Перевірте права доступу до файлу та місце на диску

Редагування записів

Редагування існуючого запису

  1. Натисніть на рядок таблиці для завантаження даних у редактор
  2. Змініть поля (всі п'ять обов'язкові)
  3. Натисніть "Зберегти елемент" коли кнопка активується
  4. Файл > Зберегти для запису на диск

Видалення запису

Виберіть рядок, натисніть "Видалити рядок", потім збережіть файл.

Вимоги

Усі поля повинні містити текст перед збереженням. Порожні поля викликають діалог попередження.

Додаткові функції

Інтеграція пошуку

Натисніть значки пошуку поруч з полями Термін або Оригінальний термін для відкриття пошуку Google з мовними фільтрами (російська/англійська).

Автоматичні резервні копії

Перед кожним збереженням програма створює резервну копію з міткою часу в: ~/.config/CenSync/JsonLinesEditor/backups/

Щоденні журнали

Операції записуються в: ~/.config/CenSync/JsonLinesEditor/logs/YYYY-MM-DD.log

Перегляд журналу поточної сесії у вкладці "Журнал".

Вирішення проблем

Неможливо відкрити файл: Перевірте кодування UTF-8 та коректний формат JSONL (один JSON об'єкт на рядок).

Зміни не збережені: Натисніть "Зберегти елемент" після редагування, потім Файл > Зберегти.

Програма не запускається: Переконайтеся що встановлені бібліотеки Qt 6. Спробуйте очистити кеш: Правка > Очистити кеш.

Відновлення даних: Перевірте папку backups на наявність .bak файлів, перейменуйте в .jsonl для відновлення.

Гарячі клавіші

  • Ctrl+N - Створити новий файл
  • Ctrl+O - Відкрити файл
  • Ctrl+S - Зберегти файл
  • Ctrl+Q - Вихід

Кращі практики

  1. Зберігайте часто (Ctrl+S)
  2. Використовуйте описові назви файлів (наприклад, medical_terms_uk_en.jsonl)
  3. Періодично перевіряйте створення резервних копій
  4. Зберігайте файли в системі контролю версій (Git)
  5. Підтримуйте послідовний формат посилань на джерела