# Пошаговая сборка клавиатуры в Keyman — от установки до теста

Для тебя (не программиста). Нужен только Windows. Время — ~20–30 минут до первого теста.
Файлы проекта уже готовы в `keyboard/keyman/`. Если где-то застрял — сделай скриншот окна и пришли,
подскажу точно (названия кнопок чуть отличаются от версии к версии).

---

## Этап 0. Установка Keyman Developer (~5 мин)
1. Открой **keyman.com/developer** → кнопка загрузки для **Windows** → скачай установщик.
2. Запусти, поставь с настройками по умолчанию.
3. Открой **Keyman Developer**. Увидишь стартовый экран со списком проектов и кнопкой создания нового.

✅ Готово, когда программа открылась.

---

## Этап 1. Лексическая модель (подсказки с восстановлением диакритики)
Это сердце: благодаря ей плоский ввод `melse` будет подсказывать `meľsë`.

1. **New Project** (Новый проект) → выбери тип **Lexical Model** (модель предиктивного ввода /
   «wordlist lexical model»).
2. Мастер спросит данные. Заполни:
   - Author / автор — любой id латиницей, напр. `valks`.
   - Language / язык — код **`myv`** (это эрзянский по стандарту BCP-47).
   - Name / имя модели — напр. `erzya`.
   - Версия — `1.0`.
   Получится идентификатор вида `valks.myv.erzya` — запомни его.
3. Keyman создаст папку проекта с файлами: модель `*.model.ts`, образец словаря и проектный файл.
4. **Подставь наш словарь:** скопируй наш `keyboard/keyman/wordlist/erzya-small.tsv` (3006 слов — для
   быстрой первой сборки) в папку проекта рядом с файлом модели. (Полный `erzya.tsv` на 138k подставишь
   потом — он компилируется дольше.)
5. **Подставь нашу модель:** открой в Keyman сгенерированный `*.model.ts` и замени его содержимое на
   наш `keyboard/keyman/model/erzya.model.ts`. ВАЖНО: строка `sources:` должна указывать на имя
   положенного словаря — поставь `sources: ['erzya-small.tsv'],` (имя того файла, что скопировал в п.4).
6. **Скомпилируй** модель: кнопка/меню **Build** (Compile). Внизу должно написать, что сборка успешна
   (без красных ошибок).

✅ Чекпойнт: модель собралась без ошибок. Если есть ошибки — пришли текст снизу окна.

### Первый тест (прямо в Keyman Developer, без телефона)
7. Открой тест модели: в проекте модели найди **Test** (тест предиктивного ввода) — поле, где можно
   печатать и видеть подсказки. (Если не находишь — это нормально, разные версии: пришли скриншот, или
   перейди к Этапу 2, там тест точно есть на экранной клавиатуре.)
8. Набери **`melse`** → в подсказках ожидаем **`meľsë`**. Проверь ещё: `sumbra`→`šumbra`, `vir`→`viŕ`,
   `kel`→`keľ`.

🎯 Если подсказки всплывают по плоскому вводу — **диакритик-восстановление работает.** Это и есть
главная проверка всей затеи.

---

## Этап 2. Клавиатура (ввод 16 букв)
1. **New Project → Keyboard** (Basic Keyboard). Author/Name — как удобно; язык тоже **`myv`**.
2. Добавь в проект наш файл `keyboard/keyman/keyboard/erzya.kmn` (Add existing / или замени
   содержимое стартового .kmn нашим). Он даёт постфикс-ввод: `s'`→ś, `s=`→š, `a"`→ä и т. д.
3. **Build** клавиатуру. Должно собраться без ошибок.
4. (Сенсорная раскладка — на потом) В редакторе **Touch Layout** можно расставить клавиши и добавить
   долгое нажатие для прямого ввода особых букв. Для первого теста не обязательно.

### Тест клавиатуры + модели вместе
5. Открой тест клавиатуры (**Keyboard → Test**, экранная клавиатура с полем ввода). Если привязать к
   языку `myv` ту же модель — увидишь и ввод букв, и подсказки. Набери `melse` → жди подсказку `meľsë`.

---

## Этап 3. Пакет .kmp (чтобы поставить на телефон)
1. **New Project → Package** (или в проекте клавиатуры — вкладка Package / Distribution).
2. Добавь в пакет: нашу **клавиатуру** (.kmn/собранный .js) и **лексическую модель** (.model.js).
   Укажи язык `myv` для обоих.
3. **Build package** → получишь файл **`*.kmp`**. Это и есть устанавливаемый пакет.

---

## Этап 4. Установка на телефон и тест там
1. На телефоне поставь приложение **Keyman** (Google Play или App Store).
2. Перекинь файл `*.kmp` на телефон (облако/почта/USB) и открой его — Keyman предложит установить
   клавиатуру и подсказки. Подтверди.
3. Включи клавиатуру Keyman в системных настройках (как любую стороннюю), переключись на неё.
4. В заметках набери плоско **`melse`** → в подсказке должно быть **`meľsë`**. 🎉

> Альтернатива установке файлом: отправить пакет в репозиторий **keyman.com** (бесплатный хостинг
> SIL) — тогда любой ставит его из приложения Keyman в пару тапов. Это шаг публикации, делается позже.

---

## Если что-то не так
- Ошибка компиляции модели → чаще всего путь в `sources:` не совпадает с именем файла словаря. Сверь.
- Тест не находится / окно другое → пришли скриншот, версии Keyman Developer отличаются меню.
- Подсказки не всплывают → проверь, что язык модели и клавиатуры одинаковый (`myv`) и модель собралась.
- Полный словарь (138k) компилируется заметно дольше — сначала доведи всё на `erzya-small.tsv`, потом
  поменяй `sources` на `erzya.tsv` и пересобери.
