Document v0.6.21 conversion cycling in English and Ukrainian

2026-10-31 11:39:33 +02:00
parent 3d1dfba6b9
commit 9055244300
6 changed files with 42 additions and 10 deletions
+7
@@ -79,3 +79,10 @@
## Що робити, якщо команда копіювання не спрацювала? ## Що робити, якщо команда копіювання не спрацювала?
Інший процес може ненадовго утримувати буфер Windows відкритим, і деякі редактори тоді мовчки ігнорують Ctrl+C. Від v0.6.19 KSwitcher виконує не більше трьох спроб копіювання, поки його буфер і контекст введення не змінилися. Етап повтору може потрапити до обмеженого діагностичного контексту; успішні операції й надалі не створюють окремих рядків у файлі. Якщо копіювання не вдалося, текст неможливо перевірити й заміна скасовується. Надсилання Ctrl+V не доводить, що редактор прийняв вставлення; попередня діагностика фактичного тексту та її обмеження залишаються чинними. Інший процес може ненадовго утримувати буфер Windows відкритим, і деякі редактори тоді мовчки ігнорують Ctrl+C. Від v0.6.19 KSwitcher виконує не більше трьох спроб копіювання, поки його буфер і контекст введення не змінилися. Етап повтору може потрапити до обмеженого діагностичного контексту; успішні операції й надалі не створюють окремих рядків у файлі. Якщо копіювання не вдалося, текст неможливо перевірити й заміна скасовується. Надсилання Ctrl+V не доводить, що редактор прийняв вставлення; попередня діагностика фактичного тексту та її обмеження залишаються чинними.
## Циклічна конвертація (v0.6.21)
Від **v0.6.21** команда **Next layout** пропускає ввімкнені розкладки, для яких конвертація не змінює текст, і шукає змінений результат у заданому порядку циклу. Російське `рф` пропускає українську й стає англійським `ha`; українське `шььш` пропускає російську й стає англійським `immi`, якщо англійська йде наступною в налаштованому циклі. Кожен варіант обчислюється з початкового тексту. Враховуються лише ввімкнені розкладки з підтримкою конвертації.
Якщо жодна з них не змінює текст (наприклад, `123 ` або спільні літери, коли ввімкнено лише російську й українську), текст залишається незмінним, а операція переходить на одну розкладку вперед. Мова введення Windows перемикається лише за ввімкненої опції **Switch Windows input layout after conversion**. Прямі комбінації розкладок і далі використовують обрану мову. Типові комбінації клавіш та автовиправлення не змінюються.
+7
@@ -79,3 +79,10 @@ From v0.6.16, update checks do not offer to reinstall the same or an older versi
## What if a copy operation is silently dropped? ## What if a copy operation is silently dropped?
Another process can briefly hold the Windows clipboard open, and some editors silently ignore Ctrl+C in that situation. From v0.6.19, KSwitcher makes at most three copy attempts while its clipboard and input context remain unchanged. A retry stage can appear in the bounded diagnostic context; successful operations still do not create separate file rows. If copying still fails, the text cannot be verified and replacement is cancelled. Do not treat a sent Ctrl+V as confirmation that an editor accepted the paste; the existing readback diagnostics and limitations still apply. Another process can briefly hold the Windows clipboard open, and some editors silently ignore Ctrl+C in that situation. From v0.6.19, KSwitcher makes at most three copy attempts while its clipboard and input context remain unchanged. A retry stage can appear in the bounded diagnostic context; successful operations still do not create separate file rows. If copying still fails, the text cannot be verified and replacement is cancelled. Do not treat a sent Ctrl+V as confirmation that an editor accepted the paste; the existing readback diagnostics and limitations still apply.
## Conversion cycle (v0.6.21)
From **v0.6.21**, **Next layout** skips enabled layouts whose conversion leaves the text unchanged, following the configured cycle until a changed result is found. Russian `рф` skips Ukrainian and becomes English `ha`; Ukrainian `шььш` skips Russian and becomes English `immi` when English follows in the configured cycle. Each candidate is calculated from the original text. Only enabled convertible layouts are considered.
If none changes the text (for example, `123 ` or shared letters with only Russian and Ukrainian enabled), the text stays unchanged and the operation advances one layout. The Windows input layout switches only when **Switch Windows input layout after conversion** is enabled. Direct layout shortcuts still target the chosen language. Default shortcuts and automatic correction are unchanged.
+7 -5
@@ -155,16 +155,18 @@ KSwitcher — нативне C++/Win32-переписування Windows-фун
- [Гарячі клавіші, буфер обміну та шаблони](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/Usage-uk) - [Гарячі клавіші, буфер обміну та шаблони](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/Usage-uk)
- [Оновлення, дані та поширені запитання](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/FAQ-uk) - [Оновлення, дані та поширені запитання](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/FAQ-uk)
Документацію та огляд усіх 11 можливостей актуалізовано для **v0.6.20**. Інтерфейс застосунку англійською; назви кнопок у посібнику наведені як у програмі. Документацію та огляд усіх 11 можливостей актуалізовано для **v0.6.21**. Інтерфейс застосунку англійською; назви кнопок у посібнику наведені як у програмі.
[![Підтримати KSwitcher: пригостіть розробника кавою](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/raw/images/donate-uk.png)](https://send.monobank.ua/jar/88h2TddKfS) [![Підтримати KSwitcher: пригостіть розробника кавою](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/raw/images/donate-uk.png)](https://send.monobank.ua/jar/88h2TddKfS)
[Відкрити банку Monobank](https://send.monobank.ua/jar/88h2TddKfS) · Дякую, що підтримуєте KSwitcher! [Відкрити банку Monobank](https://send.monobank.ua/jar/88h2TddKfS) · Дякую, що підтримуєте KSwitcher!
## Останні зміни — v0.6.20 (2026-10-31) ## Останні зміни — v0.6.21 (2026-10-31)
Зображення з історії буфера тепер відкриваються у вбудованому редакторі через **Edit image**, **Ctrl+O** або **Edit image in screenshot editor**. Від **v0.6.21** команда **Next layout** пропускає ввімкнені розкладки, для яких конвертація не змінює текст, і шукає змінений результат у заданому порядку циклу. Російське `рф` пропускає українську й стає англійським `ha`; українське `шььш` пропускає російську й стає англійським `immi`, якщо англійська йде наступною в налаштованому циклі. Кожен варіант обчислюється з початкового тексту. Враховуються лише ввімкнені розкладки з підтримкою конвертації.
Див. [Буфер обміну](Clipboard-uk) та [Скріншоти](Screenshots-uk). Якщо жодна з них не змінює текст (наприклад, `123 ` або спільні літери, коли ввімкнено лише російську й українську), текст залишається незмінним, а операція переходить на одну розкладку вперед. Мова введення Windows перемикається лише за ввімкненої опції **Switch Windows input layout after conversion**. Прямі комбінації розкладок і далі використовують обрану мову. Типові комбінації клавіш та автовиправлення не змінюються.
[Завантажити v0.6.20](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/releases/download/release-v0.6.20/KSwitcher-win-x64.zip) · [Контрольні суми](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/releases/download/release-v0.6.20/SHA256SUMS.txt) [Usage](Usage-uk) · [FAQ](FAQ-uk)
[Завантажити v0.6.21](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/releases/download/release-v0.6.21/KSwitcher-win-x64.zip) · [SHA256SUMS.txt](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/releases/download/release-v0.6.21/SHA256SUMS.txt)
+7 -5
@@ -154,16 +154,18 @@ Enable **Start with Windows**. For elevated target applications, optionally enab
- [Keyboard shortcuts, clipboard and snippets](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/Usage) - [Keyboard shortcuts, clipboard and snippets](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/Usage)
- [Updates, data and frequently asked questions](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/FAQ) - [Updates, data and frequently asked questions](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/FAQ)
Documentation is current through **v0.6.20**. The application interface is in English. This wiki is available in English and Ukrainian; use the language links at the top of each page to open its translation. Documentation is current through **v0.6.21**. The application interface is in English. This wiki is available in English and Ukrainian; use the language links at the top of each page to open its translation.
[![Support KSwitcher development — buy the developer a coffee](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/raw/images/donate-en.png)](https://send.monobank.ua/jar/88h2TddKfS) [![Support KSwitcher development — buy the developer a coffee](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/wiki/raw/images/donate-en.png)](https://send.monobank.ua/jar/88h2TddKfS)
[Donate via Monobank](https://send.monobank.ua/jar/88h2TddKfS) · Thank you for supporting KSwitcher! [Donate via Monobank](https://send.monobank.ua/jar/88h2TddKfS) · Thank you for supporting KSwitcher!
## Recent changes — v0.6.20 (2026-10-31) ## Recent changes — v0.6.21 (2026-10-31)
Images in clipboard history now open in the built-in editor through **Edit image**, **Ctrl+O**, or **Edit image in screenshot editor**. From **v0.6.21**, **Next layout** skips enabled layouts whose conversion leaves the text unchanged, following the configured cycle until a changed result is found. Russian `рф` skips Ukrainian and becomes English `ha`; Ukrainian `шььш` skips Russian and becomes English `immi` when English follows in the configured cycle. Each candidate is calculated from the original text. Only enabled convertible layouts are considered.
See [Clipboard](Clipboard) and [Screenshots](Screenshots). If none changes the text (for example, `123 ` or shared letters with only Russian and Ukrainian enabled), the text stays unchanged and the operation advances one layout. The Windows input layout switches only when **Switch Windows input layout after conversion** is enabled. Direct layout shortcuts still target the chosen language. Default shortcuts and automatic correction are unchanged.
[Download v0.6.20](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/releases/download/release-v0.6.20/KSwitcher-win-x64.zip) · [Checksums](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/releases/download/release-v0.6.20/SHA256SUMS.txt) [Usage](Usage) · [FAQ](FAQ)
[Download v0.6.21](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/releases/download/release-v0.6.21/KSwitcher-win-x64.zip) · [SHA256SUMS.txt](https://gitea.hrynco.com/hrynco/hrynco-kswitcher/releases/download/release-v0.6.21/SHA256SUMS.txt)
+7
@@ -62,3 +62,10 @@ Hello, {cursor}!
Маркер `{enter}` натискає Enter після вставлення сніпета й розміщення курсора, перед відтворенням черги клавіш; `{{enter}}` вставляє його буквально. Поведінку дій і станів редактора описано в [посібнику сніпетів](Snippets-uk). Для збоїв конвертації використовуйте [журнал діагностики](FAQ-uk). Маркер `{enter}` натискає Enter після вставлення сніпета й розміщення курсора, перед відтворенням черги клавіш; `{{enter}}` вставляє його буквально. Поведінку дій і станів редактора описано в [посібнику сніпетів](Snippets-uk). Для збоїв конвертації використовуйте [журнал діагностики](FAQ-uk).
Від v0.6.19 пропущене копіювання може повторюватися до трьох спроб загалом — лише за незмінного буфера й контексту введення. Якщо перевірка все одно не вдалася, заміна скасовується. Див. [діагностику копіювання](FAQ-uk) та [поведінку сніпетів при збої](Snippets-uk). Від v0.6.19 пропущене копіювання може повторюватися до трьох спроб загалом — лише за незмінного буфера й контексту введення. Якщо перевірка все одно не вдалася, заміна скасовується. Див. [діагностику копіювання](FAQ-uk) та [поведінку сніпетів при збої](Snippets-uk).
## Циклічна конвертація (v0.6.21)
Від **v0.6.21** команда **Next layout** пропускає ввімкнені розкладки, для яких конвертація не змінює текст, і шукає змінений результат у заданому порядку циклу. Російське `рф` пропускає українську й стає англійським `ha`; українське `шььш` пропускає російську й стає англійським `immi`, якщо англійська йде наступною в налаштованому циклі. Кожен варіант обчислюється з початкового тексту. Враховуються лише ввімкнені розкладки з підтримкою конвертації.
Якщо жодна з них не змінює текст (наприклад, `123 ` або спільні літери, коли ввімкнено лише російську й українську), текст залишається незмінним, а операція переходить на одну розкладку вперед. Мова введення Windows перемикається лише за ввімкненої опції **Switch Windows input layout after conversion**. Прямі комбінації розкладок і далі використовують обрану мову. Типові комбінації клавіш та автовиправлення не змінюються.
+7
@@ -62,3 +62,10 @@ Example: `;run` → `rider .{enter}` (insert text and press Enter).
The `{enter}` marker presses Enter after snippet insertion and cursor placement, before queued typing resumes; `{{enter}}` escapes it. See the [snippet guide](Snippets) for action semantics and editor states. For conversion failures, use the [diagnostic viewer](FAQ#diagnostics). The `{enter}` marker presses Enter after snippet insertion and cursor placement, before queued typing resumes; `{{enter}}` escapes it. See the [snippet guide](Snippets) for action semantics and editor states. For conversion failures, use the [diagnostic viewer](FAQ#diagnostics).
From v0.6.19, a silently dropped copy can be retried up to three times in total, only while the clipboard and input context remain unchanged. If verification still fails, replacement is cancelled. See [copy troubleshooting](FAQ) and [snippet failure behavior](Snippets). From v0.6.19, a silently dropped copy can be retried up to three times in total, only while the clipboard and input context remain unchanged. If verification still fails, replacement is cancelled. See [copy troubleshooting](FAQ) and [snippet failure behavior](Snippets).
## Conversion cycle (v0.6.21)
From **v0.6.21**, **Next layout** skips enabled layouts whose conversion leaves the text unchanged, following the configured cycle until a changed result is found. Russian `рф` skips Ukrainian and becomes English `ha`; Ukrainian `шььш` skips Russian and becomes English `immi` when English follows in the configured cycle. Each candidate is calculated from the original text. Only enabled convertible layouts are considered.
If none changes the text (for example, `123 ` or shared letters with only Russian and Ukrainian enabled), the text stays unchanged and the operation advances one layout. The Windows input layout switches only when **Switch Windows input layout after conversion** is enabled. Direct layout shortcuts still target the chosen language. Default shortcuts and automatic correction are unchanged.