Add Ukrainian user guide and application screenshots

Auto-correction.md

@@ -0,0 +1,57 @@
+# Автовиправлення та словники
+
+Автовиправлення **експериментальне та вимкнене за замовчуванням**. Воно використовує локальні словники: англійська й українська обрані за замовчуванням, російську можна увімкнути окремо.
+
+## Увімкнення
+
+1. У **Settings** увімкніть **Automatically correct layout (experimental)**.
+2. Відкрийте **Auto-correction options…** і виберіть мови.
+3. Переконайтеся, що відповідні розкладки включені в **Layout cycle**.
+4. Натисніть **OK**, потім **Save** у головних налаштуваннях.
+
+![Параметри автовиправлення: мови, винятки, частотність і пунктуація](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/raw/images/auto-correction.png)
+
+## Приклади
+
+Наберіть слово фізично на клавіатурі, натисніть **Space** і зробіть коротку паузу:
+
+| Набрано | Результат |
+| --- | --- |
+| `ghbdsn` | `привіт` |
+| `lsv` | `дім` |
+| `ljvfiyz` | `домашня` |
+| `рщгіу` | `house` |
+| `(ljvf)` | `(дома)` |
+
+Перевірка запускається після пробілу й приблизно 250 мс спокою. Якщо продовжити друкувати, очікуване виправлення скасовується. Програма виправляє невідоме слово лише коли знаходить однозначний словниковий варіант в іншій розкладці. Це не перевірка граматики й не переклад між мовами.
+
+**Undo** повертає початковий текст і розкладку. Відхилене таким чином слово не виправляється до перезапуску KSwitcher.
+
+## Параметри
+
+| Поле | Значення |
+| --- | --- |
+| Frequency rank limit | `0` — весь словник; додатне число — лише кандидати з рангом не більшим за цей поріг |
+| Minimum word length | Від 1 до 32 літер, за замовчуванням `3`; навколишня пунктуація не рахується |
+| Characters before a word | Дозволені знаки перед словом: дужки, лапки та інша пунктуація |
+| Characters after a word | Дозволені знаки після слова, зокрема закривальні дужки, двокрапка і крапка з комою |
+| Excluded applications | Імена процесів через кому, де автовиправлення вимкнене |
+| Personal dictionary | Слова через кому, які ніколи не слід автоматично виправляти |
+
+Знаки вводяться без пробілів і роздільників; вони зберігаються в результаті. Відомі слова початкової мови захищені незалежно від порогу частотності. Для зменшення випадкових замін програма пропускає, зокрема, URL, адреси email, слова з цифрами, змішаним регістром або повністю великими літерами. Редактори коду, термінали та менеджери паролів входять до стандартних винятків.
+
+## Редагування словників
+
+Натисніть **Open dictionary folder**. Файли можна редагувати звичайним текстовим редактором зі збереженням у **UTF-8**.
+
+Формат рядка: слово малими літерами, символ табуляції, додатний числовий ранг:
+
+```text
+абонент	33717
+```
+
+Число — статичний частотний ранг зі словникового джерела: менше число означає частіше слово. Воно **не змінюється під час користування програмою**. Для власного слова можна поставити `1`, щоб воно проходило будь-який додатний поріг. При порозі `0` використовуються всі слова незалежно від рангу. Зберігайте унікальність слів і лексикографічний порядок рядків.
+
+Після редагування натисніть **OK** у параметрах автовиправлення, потім **Save** у Settings — словники перезавантажаться. Перед оновленням програми зробіть копію власних змін у словниках.
+
+Дані словників походять із FrequencyWords і поширюються за CC BY-SA 4.0; джерела та ліцензії включені до архіву програми.

FAQ.md

@@ -0,0 +1,44 @@
+# Оновлення, дані та поширені запитання
+
+## Як оновити програму?
+
+1. Завантажте ZIP із [Releases](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/releases).
+2. Закрийте KSwitcher через **Exit** у меню трея.
+3. Зробіть резервну копію папки `data` та власних змін у `dictionaries`.
+4. Замініть файли програми, зберігши свої дані, і запустіть `KSwitcher.exe`.
+
+## Де зберігаються дані?
+
+Програма намагається використовувати папку даних поруч з EXE; якщо вона недоступна для запису — каталог у LocalAppData. Пункт **Open data folder** відкриває фактичне місце зберігання.
+
+Історія буфера шифрується Windows DPAPI для поточного користувача. Налаштування та snippets зберігаються як текст. Копіювання зашифрованої історії до іншого облікового запису не є підтримуваним способом перенесення. Для налаштувань є **Import settings… / Export settings…**.
+
+## Чому хоткей не замінює Win+V у Task Manager?
+
+Якщо цільове вікно працює з правами адміністратора, звичайному процесу KSwitcher може бракувати прав для перехоплення клавіш та введення. Для такого сценарію увімкніть **Start with Windows** і **Start with Windows as administrator**. Підтвердіть запит UAC; програма створює завдання входу для поточного користувача через Task Scheduler. Збереження цієї опції не підвищує права вже запущеного звичайного процесу: перезапустіть його з правами адміністратора або увійдіть у Windows знову.
+
+## Що перевірити, якщо автовиправлення не спрацювало?
+
+- Функцію увімкнено та налаштування збережено.
+- Мова обрана у **Auto-correction options…**, а її розкладка включена в цикл.
+- Слово набране фізично, завершене пробілом і після нього була коротка пауза.
+- Програма не у винятках, слово відповідає мінімальній довжині та словниковому порогу.
+- Слово не входить до особистих винятків і не було відхилене через Undo в цій сесії.
+
+Функція навмисно пропускає неоднозначні випадки та відомі слова початкової мови. Для них використовуйте ручне виправлення.
+
+## Чи працює в Teams?
+
+У програмі є обробка полів Teams / WebView2 для виділеного та щойно набраного тексту. Якщо редактор не дає безпечно визначити діапазон, виділіть текст вручну та повторіть команду. Поведінка залежить від конкретного поля введення й прав процесів.
+
+## Чи потрібен інтернет для словників?
+
+Ні. Автовиправлення працює з локальними файлами. Завантаження нових версій виконується через Releases.
+
+## Чи можна одночасно запускати Typlo?
+
+Уникайте одночасної роботи з однаковими комбінаціями: обидві програми можуть конкурувати за клавіатурні події. Закрийте Typlo або розведіть хоткеї.
+
+## Ліцензія
+
+Код KSwitcher — MIT. Дані словників — CC BY-SA 4.0. Точні джерела та повідомлення про ліцензії містяться в дистрибутиві й репозиторії.

Home.md

@@ -2,7 +2,7 @@
 
 KSwitcher — невеликий нативний застосунок для **Windows 10/11 x64**, написаний на C++/Win32. Він виправляє текст, набраний у неправильній розкладці, зберігає історію буфера обміну та розгортає текстові шаблони. Працює з іконки в системному треї; встановлення .NET чи додаткового runtime не потрібне.
 
-**[Завантажити останню версію (ZIP)](../releases/download/latest/KSwitcher-win-x64.zip)** · **[Усі релізи](../releases)**
+**[Завантажити останню версію (ZIP)](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/releases/download/latest/KSwitcher-win-x64.zip)** · **[Усі релізи](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/releases)**
 
 ## Можливості
 
@@ -31,14 +31,14 @@ KSwitcher — невеликий нативний застосунок для **
 
 ## Налаштування
 
-![Settings: розкладки, хоткеї, автозапуск і ліміти історії](raw/images/settings.png)
+![Settings: розкладки, хоткеї, автозапуск і ліміти історії](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/raw/images/settings.png)
 
 Скріншот показує справжній інтерфейс із демонстраційними налаштуваннями. Перелік розкладок залежить від Windows на вашому комп’ютері.
 
 ## Докладні інструкції
 
-- [Автовиправлення та словники](Auto-correction)
+- [Автовиправлення та словники](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/Auto-correction)
-- [Гарячі клавіші, буфер обміну та шаблони](Usage)
+- [Гарячі клавіші, буфер обміну та шаблони](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/Usage)
-- [Оновлення, дані та поширені запитання](FAQ)
+- [Оновлення, дані та поширені запитання](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/FAQ)
 
 Документація для **v0.1.0**. Інтерфейс застосунку англійською; назви кнопок у посібнику наведені як у програмі.

Usage.md

@@ -0,0 +1,46 @@
+# Гарячі клавіші, буфер обміну та шаблони
+
+## Стандартні комбінації
+
+| Дія | Комбінація |
+| --- | --- |
+| Next layout | Ctrl+Alt+Shift+Space |
+| Change case | Ctrl+Alt+Shift+C |
+| Transliterate | Ctrl+Alt+Shift+T |
+| Undo | Ctrl+Alt+Shift+Z |
+| Clipboard history | Ctrl+Shift+V |
+| Перші три розкладки | Ctrl+Alt+Shift+1 / 2 / 3 |
+
+Щоб змінити хоткей, клацніть його поле в **Settings**, натисніть потрібні клавіші та збережіть налаштування. **Backspace / Delete** без модифікаторів очищає поле. Для розкладки спочатку виберіть її в списку й змініть **Direct layout shortcut**.
+
+Можна призначити **Win+V**, **Win+Shift+S** та інші звичайні комбінації Windows. Поки KSwitcher працює, точно призначена комбінація виконує його дію. Змініть хоткей або закрийте програму, щоб повернути системну поведінку. Захищені **Ctrl+Alt+Delete** та **Win+L** призначити не можна.
+
+## Історія буфера обміну
+
+Увімкніть **Record clipboard history**. Відкривайте список через іконку в треї або налаштований хоткей. У списку показуються текстові фрагменти та мініатюри зображень; доступні пошук і закріплення. Повторні зображення від Snipping Tool дедуплікуються.
+
+| У вікні історії | Дія |
+| --- | --- |
+| Enter | Вставити вибраний елемент |
+| Shift+Enter | Вставити як звичайний текст |
+| Ctrl+1 … Ctrl+9 | Швидко вставити елемент |
+| Ctrl+P | Закріпити / відкріпити |
+| Delete | Видалити елемент |
+| Ctrl+O | Відкрити повний перегляд |
+| Escape | Закрити вікно |
+
+Історія підтримує текст, зображення та списки файлів. HTML/RTF-дані дозволяють зберігати форматування; попередній перегляд не гарантує точного відтворення всіх стилів документа. У контекстному меню зображення **Copy text from image** запускає OCR Windows; потрібен відповідний встановлений мовний компонент.
+
+У **Settings** можна обмежити кількість елементів, загальний обсяг і розмір одного елемента, очистити історію та виключити програми за іменами процесів. У меню трея є тимчасове призупинення запису.
+
+## Snippets
+
+Відкрийте **Snippets…**, задайте тригер і текст заміни. Шаблон може містити кілька рядків. Маркер `{cursor}` задає позицію курсора після розгортання; `{{cursor}}` вставляє буквальний текст `{cursor}`.
+
+Наприклад, для тригера `;hello` можна задати:
+
+```text
+Hello, {cursor}!
+```
+
+Це зручно для привітань, підписів і повторюваних відповідей. Розпізнавання тригерів підтримується між розкладками.

_Sidebar.md

@@ -0,0 +1,7 @@
+## KSwitcher
+
+- [Огляд і завантаження](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/Home)
+- [Автовиправлення та словники](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/Auto-correction)
+- [Хоткеї, буфер, snippets](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/Usage)
+- [Оновлення та FAQ](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/FAQ)
+- [Релізи](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/releases)