📖 Посібник — Додаток «Транскриптор метричних книг»

Цей додаток допомагає транскрибувати зображення метричних книг (акти народження, шлюбу, смерті) за допомогою Google™ AI (Gemini™). Ви можете імпортувати знімки з Google Drive™ (файли, які явно обираєте), додати блок Context, потім транскрибувати вибрані зображення; текст вставляється безпосередньо під відповідним зображенням.

📊 Схема роботи

Створення документа та імпорт

flowchart LR
  A[📄 Новий Doc] --> B[📁 Імпорт з Drive]
  B --> C[✅ Перевірка Context і зображень]

Транскрипція (бічна панель — рекомендовано)

flowchart LR
  D[📁 Імпорт з Drive] --> E[🔑 Налаштування ШІ]
  E --> F[🧾 Витягнути контекст]
  F --> G[☑️ Вибрати зображення]
  G --> H[✍️ Транскрибувати вибране]
  H --> I[✅ Перевірка результату]

🔄 Короткий сценарій

1. Зберіть документ — Import Book from Drive Files (рекомендовано) або вручну додайте Context і зображення.
2. Шаблон — якщо джерело не греко-католицькі метричні книги Галичини, відкрийте Select Template і оберіть профіль (наприклад, російська православна метрична книга).
3. Транскрипція — бічна панель для пакету або одне зображення через меню Transcribe Image.
4. Налаштування — Extensions → GeneaScript → Setup AI або кнопка в бічній панелі.
5. Контекст з обкладинки — Extract Context from Cover Image (меню) або Обкладинка → Контекст (бічна панель, одне вбудоване зображення).

Мова інтерфейсу

Доступні англійська, українська, російська. За замовчуванням — мова облікового запису Google. Перевизначення: Setup AI або Settings → Interface language (Auto, English, Українська, Русский). Заголовок Context у документі не перекладається — так працює авто-виявлення контексту.

Меню Extensions → GeneaScript: Open Sidebar, Transcribe Image, Import Book from Drive Files, Extract Context from Cover Image, Select Template, Setup AI, Help / User Guide, Report an issue.

📁 Імпорт з Google Drive (рекомендовано)

1. Відкрийте Google Doc.
2. Extensions → GeneaScript → Import Book from Drive Files.
3. У Google Picker стартує папка батьківського документа (якщо документ у Drive).
4. Вкладки Images / Folders, пошук, до 50 зображень (JPEG, PNG, WebP; або до 500 у режимі «Лише посилання»), Select.
5. Додається розділ Context (зразок з жирними мітками — відредагуйте), для кожного файлу: Heading 2, Source Image Link, зображення, розрив сторінки.
   • Якщо зображення не вдається вбудувати (формат відхилено Google Docs), воно автоматично додається як запис-посилання — заголовок і посилання на Drive зберігаються, але вбудованого зображення немає. Такі записи можна транскрибувати як звичайні.
6. 🔗 Режим «Лише посилання» (необов’язково): поставте галочку 🔗 поруч з кнопкою «Імпорт», щоб імпортувати всі файли як записи-посилання (без вбудованих зображень). Швидший імпорт, менший документ, підтримка до 500 файлів за раз — ідеально для великих книг (300+ сканів). Налаштування зберігається для кожного документа.

Після імпорту з’явиться підсумок (скільки додано вбудованих / посилань / пропущено). Доступ лише до обраних файлів (drive.file).

📄 Структура документа (вручну)

1. Context — під заголовком опишіть архів, опис документа, діапазон дат, села, прізвища. Увесь текст під «Context» йде в модель.
2. Зображення — вставте скани під Context (Insert → Image).

📂 Бічна панель (пакетна транскрипція)

1. Open Sidebar або іконка доповнення.
2. Порядок дій: Імпорт з Drive Files (з необов’язковим перемикачем 🔗), Setup AI, Обкладинка → Контекст, список зображень, Transcribe Selected. Наведіть курсор на будь-яку кнопку, щоб побачити підказку.
3. Позначки: зелена галочка — вже є транскрипція; виберіть один або кілька пунктів. Записи-посилання відображаються напівпрозорими з іконкою 🔗.
4. Stop зупиняє пакет після поточного зображення.
5. Помилки — червоний хрестик (наведіть для тексту); попередження — можлива обрізка MAX_TOKENS.

🧾 Витяг контексту з титульної сторінки

Після імпорту: меню Extract Context from Cover Image або кнопка Обкладинка → Контекст в бічній панелі з одним вибраним вбудованим зображенням → Extract → перевірка полів → Apply Context. Записи-посилання не підтримуються для витягу контексту.

📋 Галерея шаблонів

Select Template (меню або кнопка шаблону в бічній панелі). Доступні профілі, зокрема Galician Greek Catholic та Russian Imperial Orthodox. Review Template показує вкладки Context (живий текст з документа), Role, Columns, Output, Instructions. Шаблон зберігається на документ. Нові транскрипції використовують обраний шаблон.

Власні шаблони (v1.4+)

Ви можете створювати персональні шаблони транскрибування на основі офіційних або з нуля. Кожен шаблон має секції: Роль, Вхідна структура, Формат виводу, Інструкції та Контекст за замовчуванням.

Створення:

1. Відкрийте Галерею шаблонів → прокрутіть до Мої шаблони.
2. Створити з шаблону — клонує офіційний шаблон. Створити порожній — порожній шаблон зі стартовими заготовками.
3. У редакторі заповніть Назву, Опис і налаштуйте секції через вкладки.
4. Для шаблонів на основі батьківського є кнопка Скинути для повернення до оригіналу.
5. Зберегти → шаблон з’явиться в галереї.

Керування: кнопки Редагувати, Дублювати, Експортувати в документ, Видалити на картці шаблону. Експорт робить шаблон доступним для колег у цьому документі (позначка «Shared»). До 5 шаблонів на акаунт.

✍️ Одне зображення (меню)

1. Клацніть по зображенню (рамка виділення).
2. Transcribe Image.
3. Перший запуск — діалог ключа API та моделі (Google AI Studio), Save & Continue.
4. Дочекайтесь завершення; текст з’явиться під зображенням.
5. Перевірте Quality Metrics (сині) та Assessment (червоні).

Setup AI — зміна ключа, моделі, суворості, довжини виводу, режиму міркування. Унизу діалогу є чекбокс Показувати статистику у бічній панелі для ввімкнення панелі статистики (див. нижче).

📊 Статистика використання (v1.6.1+)

Бічна панель може показувати згортну секцію Статистика, яка відображає споживання токенів та орієнтовну вартість ваших транскрипцій. Це корисно для контролю витрат на API та розуміння впливу шаблону й розміру зображення на вартість.

Увімкнення

Статистика вимкнена за замовчуванням. Щоб увімкнути:

1. Відкрийте Setup AI (кнопка на панелі або меню).
2. Поставте галочку Показувати статистику у бічній панелі.
3. Натисніть Зберегти. Панель з’явиться через кілька секунд.

Що показує панель

Панель має дві секції: Всього по документу (накопичення за всі пакети) та Останній запуск (тільки останній пакет).

Посилання в підвалі

• Тарифи — відкриває сторінку цін Gemini API
• Мої витрати — відкриває дашборд витрат AI Studio
• Скинути — обнуляє всю статистику документа (з підтвердженням)

Як працює статистика

• Статистика накопичується між пакетами в одному документі.
• Дані зберігаються для кожного документа (прив’язані до вашого акаунту та ID документа). Перезавантаження панелі або повторне відкриття документа відновлює статистику.
• Секція Останній запуск з’являється після першого пакету.
• Скинути очищує всі дані (загальні та останній запуск).
• Невдалі зображення не враховуються — тільки успішні транскрипції.

📝 Формат результату

Заголовок сторінки, записи абзацами (адреса, імена, нотатки), метрики якості, оцінка, потім підсумки мовами (російська, українська, латиниця, англійська) списком.

💡 Поради

• Чим точніший Context, тим краще нормалізація імен.
• Якісні скани та обрізка зайвого поля покращують результат.
• Для кількох сторінок зручніша бічна панель.

🔧 Усунення несправностей

Повна інструкція з установки: INSTALLATION.html.