diff --git a/Clipboard.md b/Clipboard.md new file mode 100644 index 0000000..f2cdb42 --- /dev/null +++ b/Clipboard.md @@ -0,0 +1,49 @@ +# Історія буфера обміну + +KSwitcher зберігає скопійовані **тексти, зображення та списки файлів**. Історія допомагає повернутися до попереднього фрагмента, вставити його без форматування, закріпити корисний запис або розпізнати текст зі скріншота. + +## Увімкнення та відкриття + +У **Settings** увімкніть **Record clipboard history**. Відкривайте історію з меню трея або хоткеєм **Clipboard history**. Стандартна комбінація — **Ctrl+Shift+V**; можна призначити **Win+V**. Поки KSwitcher працює, призначений Win+V відкриває його історію замість системної. + +## Пошук і вставлення + +![Пошук демонстраційних записів в історії буфера](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/raw/images/clipboard-history.jpg) + +Введіть частину тексту в **Search clipboard history**. Результати показують попередній перегляд, порядковий номер і програму-джерело. Для зображень завантажуються мініатюри. Текст може показувати форматування HTML/RTF; відтворення залежить від вмісту вихідної програми. + +1. Перед відкриттям історії поставте курсор у потрібне поле цільової програми. +2. Відкрийте історію, знайдіть і виберіть запис. +3. Натисніть **Paste / Enter** для вставлення або **Plain text / Shift+Enter** для звичайного тексту. + +Від **v0.6.0** список і поле пошуку розтягуються разом із вікном, а кнопки залишаються внизу. Якщо вікно дуже мале, елементи доступні через прокручування. + +## Команди + +| Комбінація | Дія | +| --- | --- | +| Enter | Вставити вибраний запис у попереднє вікно | +| Shift+Enter | Вставити звичайний текст без форматування | +| Ctrl+1 … Ctrl+9 | Швидко вставити запис зі списку | +| Ctrl+P | Закріпити / відкріпити | +| Delete | Видалити вибраний запис | +| Ctrl+O | Відкрити повний перегляд | +| Esc | Закрити історію | + +Кнопки **Pin / unpin**, **Delete** та **Open item** дублюють основні команди. Для додаткових дій клацніть запис правою кнопкою миші. + +![Контекстне меню історії: вставлення, закріплення, повний перегляд і OCR](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/raw/images/clipboard-menu.jpg) + +## Зображення, OCR та скріншоттер + +Скріншоти KSwitcher одразу потрапляють до буфера й записуються в історію, якщо її запис увімкнений. Після редагування натисніть **Ctrl+C**, щоб скопіювати результат із позначками. Повторні однакові зображення дедуплікуються. + +Для розпізнавання виберіть зображення й команду **Copy text from image (Windows OCR)** у контекстному меню. Потрібні встановлені мовні компоненти OCR Windows. Докладніше про захоплення й позначки: [Скріншоти та редактор](Screenshots). + +## Ліміти та приватність + +У **Settings → History limits** задаються максимальна кількість записів, загальний обсяг у MiB та розмір одного запису. **Clear history…** очищає історію. Поле **Exclude applications** виключає програми за іменами процесів; у меню трея також є тимчасове призупинення запису. + +Історія й індекс зашифровані Windows DPAPI для поточного користувача. Повні зображення завантажуються за потреби, а кеш мініатюр обмежений. Для відкриття папки даних використовуйте **Open data folder**. Перенесення цієї зашифрованої історії в інший Windows-акаунт не підтримується. + +На скріншотах — демонстраційні записи, додані для документації. diff --git a/FAQ.md b/FAQ.md index 2a6651c..ee15499 100644 --- a/FAQ.md +++ b/FAQ.md @@ -2,6 +2,12 @@ ## Як оновити програму? +Використовуйте перевірку оновлень у меню трея KSwitcher. Для **v0.4.1 і старіших** шлях складається з двох оновлень: спочатку сумісна **v0.4.2**, потім повторна перевірка й перехід на поточний реліз. Із **v0.5.0** програма використовує маніфест файлів із SHA-256 і підтримує додаткові EXE в пакеті. Дані користувача та власні словники зберігаються. + +Перед заміною файлів закрийте редактори скріншотів. У пакеті є `KSwitcher.exe`, `KSwitcher.Config.exe` і `KSwitcher.Screenshot.exe`; залишайте їх разом. + +Ручне оновлення, якщо потрібне: + 1. Завантажте ZIP із [Releases](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/releases). 2. Закрийте KSwitcher через **Exit** у меню трея. 3. Зробіть резервну копію папки `data` та власних змін у `dictionaries`. diff --git a/Home.md b/Home.md index c6c3bf9..63ad148 100644 --- a/Home.md +++ b/Home.md @@ -1,6 +1,6 @@ # KSwitcher — розкладка клавіатури та буфер обміну -KSwitcher — невеликий нативний застосунок для **Windows 10/11 x64**, написаний на C++/Win32. Він виправляє текст, набраний у неправильній розкладці, зберігає історію буфера обміну та розгортає текстові шаблони. Працює з іконки в системному треї; встановлення .NET чи додаткового runtime не потрібне. +KSwitcher — невеликий нативний застосунок для **Windows 10/11 x64**, написаний на C++/Win32. Він виправляє текст, набраний у неправильній розкладці, зберігає історію буфера обміну розгортає текстові шаблони, захоплює скріншоти й дозволяє додавати позначки. Працює з іконки в системному треї; встановлення .NET чи додаткового runtime не потрібне. **[Завантажити останню версію (ZIP)](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/releases/download/latest/KSwitcher-win-x64.zip)** · **[Усі релізи](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/releases)** @@ -19,6 +19,7 @@ KSwitcher — нативне C++/Win32-переписування Windows-фун | OCR | Розпізнавання тексту із зображень через встановлені мовні компоненти Windows | | Snippets | Текстові шаблони, багаторядковий текст і позиція курсора | | Хоткеї | Запис комбінації натисканням клавіш, зокрема заміна звичайних системних комбінацій | +| Скріншоти | Win+Shift+S → буфер → сповіщення з мініатюрою → редактор із позначками | | Автозапуск | Звичайний або з правами адміністратора | ## Швидкий старт @@ -37,10 +38,17 @@ KSwitcher — нативне C++/Win32-переписування Windows-фун Скріншот показує справжній інтерфейс із демонстраційними налаштуваннями. Перелік розкладок залежить від Windows на вашому комп’ютері. +## Скріншоти та буфер обміну + +- **[Скріншоти та редактор позначок](Screenshots)** — стрілки, номери, підсвітка, текст, фігури та гарячі клавіші. +- **[Історія буфера обміну](Clipboard)** — пошук, мініатюри, вставлення, закріплення та OCR. + +![Редактор скріншотів](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/raw/images/screenshot-editor.jpg) + ## Докладні інструкції - [Автовиправлення та словники](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/Auto-correction) - [Гарячі клавіші, буфер обміну та шаблони](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/Usage) - [Оновлення, дані та поширені запитання](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/FAQ) -Документація для **v0.1.0**. Інтерфейс застосунку англійською; назви кнопок у посібнику наведені як у програмі. +Сторінки скріншоттера, історії буфера та оновлення актуалізовано для **v0.6.0**. Інтерфейс застосунку англійською; назви кнопок у посібнику наведені як у програмі. diff --git a/Screenshots.md b/Screenshots.md new file mode 100644 index 0000000..3bf2f8b --- /dev/null +++ b/Screenshots.md @@ -0,0 +1,59 @@ +# Скріншоти та редактор позначок + +Від **v0.6.0** KSwitcher працює за принципом «захопив — одразу вставляй»: знімок потрапляє до буфера обміну, Windows показує сповіщення з мініатюрою, а редактор відкривається лише за кліком по сповіщенню. + +## Швидкий старт + +1. Натисніть **Win+Shift+S** або виберіть **Capture screen region…** у меню трея. Хоткей можна змінити в Settings → Screen capture. +2. Протягніть прямокутник. Екран затемнений, вибрана ділянка залишається світлою. **Esc** скасовує захоплення. +3. Знімок уже в буфері: вставляйте його через **Ctrl+V** у потрібну програму. +4. Для позначок клацніть сповіщення **Screenshot copied → Click to edit and annotate**. +5. У редакторі натисніть **Ctrl+C** або кнопку копіювання. Вікно залишається відкритим, можна редагувати далі. + +Якщо сповіщення Windows вимкнені або не можуть бути надіслані, редактор відкриється відразу після копіювання. + +## Інструменти + +![Редактор KSwitcher: стрілка з підписом і прямокутна рамка на демонстраційних даних](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/raw/images/screenshot-editor.jpg) + +Це справжній редактор із нейтральним демонстраційним зображенням. Панель унизу показує підказки для поточної дії. + +| Інструмент | Клавіша | Можливості | +| --- | --- | --- | +| Нумерована мітка | N | Переміщення, зміна діаметра; нові номери спочатку заповнюють пропуски | +| Стрілка | A | Рухомі кінці, товщина, підпис, прив’язка кінців до номерків | +| Пряма лінія | L | Суцільна, пунктирна, штрихова або штрихпунктирна лінія | +| Прямокутник | R | Переміщення та зміна розміру | +| Коло / еліпс | O / E | Контурні фігури | +| Олівець | F | Довільна лінія; активний за замовчуванням | +| Підсвітка | H | Напівпрозорий штрих поверх зображення | +| Текст | T | Введення прямо на зображенні, шрифт, розмір і поворот | + +Палітра змінює колір вибраного об’єкта й наступних об’єктів. **Line style** задає тип лінії, а **Ends** — стрілку на початку, в кінці, з обох боків або без наконечників. + +## Редагування об’єктів + +- Перетягуйте об’єкт для переміщення, ручки — для зміни розміру. Курсор підказує доступну дію. +- Колесо миші змінює розмір об’єкта під курсором: товщину лінії, діаметр мітки чи розмір тексту. Товщину також можна змінювати окремою ручкою біля лінії. +- **Клавіші-стрілки** зміщують вибраний об’єкт на один піксель зображення. +- **Ctrl+D** клонує об’єкт, **Delete** видаляє його. +- **Ctrl+Z** — Undo; **Ctrl+Y** або **Ctrl+Shift+Z** — Redo. +- **Ctrl+перетягування** дозволяє малювати поверх наявних об’єктів. + +### Текст і підписи + +Подвійний клік або **F2** редагує текст чи підпис вибраної лінії. **Enter** додає рядок, **Ctrl+Enter** завершує введення, **Esc** скасовує поточне редагування тексту. Кнопка **Font and size** відкриває діалог шрифту. + +Текст повертається за круглу ручку; із **Shift** — кроком **15°**. Підпис стрілки автоматично слідує за її кутом, доки ви не повернете підпис вручну. Переміщення підпису не вимикає автоматичний кут. + +### Кілька знімків + +Можна робити нові скріншоти, поки редактор відкритий. Вікна мають окремі індекси **Screenshot #1, #2…** і доступні через **Alt+Tab**. **Esc не закриває редактор**. Якщо є зміни, які ще не скопійовані, закриття потребує підтвердження. + +## Процеси та тимчасові файли + +Захоплення й редактор працюють в окремому **KSwitcher.Screenshot.exe**, який запускається за потреби й завершується після закриття останнього свого вікна. Основний KSwitcher залишається в треї. + +Сповіщення має термін дії **24 години**. Оригінали в кеші зашифровані Windows DPAPI; невеликі PNG-прев’ю зберігаються в окремому приватному кеші ProgramData, доступному цьому користувачу та SYSTEM. Старі файли очищаються під час наступних операцій; кожен кеш обмежений 40 файлами та 256 MiB. Це тимчасовий кеш, а не архів скріншотів. + +Дивіться також: [Історія буфера обміну](Clipboard) · [Гарячі клавіші](Usage) · [Оновлення](FAQ). diff --git a/Usage.md b/Usage.md index 110b1f6..d5d192d 100644 --- a/Usage.md +++ b/Usage.md @@ -9,6 +9,7 @@ | Transliterate | Ctrl+Alt+Shift+T | | Undo | Ctrl+Alt+Shift+Z | | Clipboard history | Ctrl+Shift+V | +| Screen capture | Win+Shift+S | | Перші три розкладки | Ctrl+Alt+Shift+1 / 2 / 3 | Щоб змінити хоткей, клацніть його поле в **Settings**, натисніть потрібні клавіші та збережіть налаштування. **Backspace / Delete** без модифікаторів очищає поле. Для розкладки спочатку виберіть її в списку й змініть **Direct layout shortcut**. @@ -17,6 +18,8 @@ ## Історія буфера обміну +[Докладний посібник зі скріншотами](Clipboard). Захоплення та редагування зображень описані на сторінці [Скріншоти](Screenshots). + Увімкніть **Record clipboard history**. Відкривайте список через іконку в треї або налаштований хоткей. У списку показуються текстові фрагменти та мініатюри зображень; доступні пошук і закріплення. Повторні зображення від Snipping Tool дедуплікуються. | У вікні історії | Дія | diff --git a/_Sidebar.md b/_Sidebar.md index f41d3cd..ebf0f80 100644 --- a/_Sidebar.md +++ b/_Sidebar.md @@ -4,4 +4,6 @@ - [Автовиправлення та словники](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/wiki/Screenshots) +- [Історія буфера обміну](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/Clipboard) - [Релізи](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/releases) diff --git a/images/clipboard-history.jpg b/images/clipboard-history.jpg new file mode 100644 index 0000000..4a354a4 Binary files /dev/null and b/images/clipboard-history.jpg differ diff --git a/images/clipboard-menu.jpg b/images/clipboard-menu.jpg new file mode 100644 index 0000000..2bbc95e Binary files /dev/null and b/images/clipboard-menu.jpg differ diff --git a/images/screenshot-editor.jpg b/images/screenshot-editor.jpg new file mode 100644 index 0000000..cb11f76 Binary files /dev/null and b/images/screenshot-editor.jpg differ