Ukrainian translation (#15)

* Ukrainian translation

Hi, this is a full Ukrainian translation, translated by Heorhii (member of Ukrainian NVDA Community)

* minor changes in po-file

this commit fixed small language errors

* changed pull request

Done!

* English readme is generated from the root directory on the addon

Co-authored-by: Marlon Sousa <[email protected]>

README.md

@@ -1,9 +1,9 @@
-# Timer for NVDA 1.5.1
+# Timer for NVDA 1.5.2
 Brings timer and stopwatch functionalities right to NVDA
 
 ## download
 
-Download the [ Simple Timer and stopwatch for NVDA 1.5.1 addon](https://github.com/marlon-sousa/TimerForNVDA/releases/download/1.5.1/TimerForNVDA-1.5.1.nvda-addon)
+Download the [ Simple Timer and stopwatch for NVDA 1.5.2 addon](https://github.com/marlon-sousa/TimerForNVDA/releases/download/1.5.2/TimerForNVDA-1.5.2.nvda-addon)
 
 ## timers and stopwatches
 
@@ -130,4 +130,5 @@ Special thanks to
 * Ângelo Miguel Abrantes - Portuguese translation
 * Rémy Ruiz - Spanish translation
 * Umut KORKMAZ - Turkish translation
+* Heorhii - Ukrainian translation
 * Brian Missao da Vera - NVDA 2022.1 compatibility

README.tpl.md

@@ -130,4 +130,5 @@ Special thanks to
 * Ângelo Miguel Abrantes - Portuguese translation
 * Rémy Ruiz - Spanish translation
 * Umut KORKMAZ - Turkish translation
+* Heorhii - Ukrainian translation
 * Brian Missao da Vera - NVDA 2022.1 compatibility

addon/doc/es/README.tpl.md

@@ -133,4 +133,5 @@ Agradecimientos especiales a
 * Rémy Ruiz - Traducción Francés
 * Rémy Ruiz - Traducción Español
 * Umut KORKMAZ - Traducción turco
+* Heorhii - Traducción ucraniano
 * Brian Missao da Vera - Compatibilidad con NVDA 2022.1

addon/doc/fr/README.tpl.md

@@ -133,4 +133,5 @@ Remerciement spécial à
 * Rémy Ruiz - Traduction Français
 * Rémy Ruiz - Traduction Espagnol
 * Umut KORKMAZ - Traduction turc
+* Heorhii - Traduction ukrainienne
 * Brian Missao da Vera - Compatibilité NVDA 2022.1

addon/doc/hr/readme.tpl.md

@@ -130,4 +130,5 @@ Posebno zahvaljujemo
 * Rémy Ruiz - francuski prijevod
 * Rémy Ruiz - španjolski prijevod
 * Umut KORKMAZ - turski prijevod
+* Heorhii - ukrajinski prijevod
 * Brian Missao da Vera - NVDA 2022.1 kompatibilnost

addon/doc/pt_BR/README.tpl.md

@@ -133,4 +133,5 @@ Agradecimentos a:
 * Rémy Ruiz - Tradução para Francês
 * Rémy Ruiz - Tradução para Espanhol
 * Umut KORKMAZ - tradução para Turco
+* Heorhii - tradução para Ucraniano
 * Brian Missao da Vera - Compatibilidade com NVDA 2022.1

addon/doc/pt_PT/README.tpl.md

@@ -133,4 +133,5 @@ Agradecimentos a:
 * Rémy Ruiz - Tradução para Francês
 * Rémy Ruiz - Tradução para Espanhol
 * Umut KORKMAZ - tradução para Turco
+* Heorhii - tradução para Ucraniano
 * Brian Missao da Vera - Compatibilidade com NVDA 2022.1

addon/doc/tr/README.tpl.md

@@ -133,4 +133,5 @@ Eklentiyi çevirmeye veya geliştirmeye yardımcı olmak istiyorsanız, lütfen
 * Rémy Ruiz - Fransızca Çeviri
 * Remy Ruiz - İspanyolca Çeviri
 * Umut KORKMAZ - Türkçe çeviri
+* Heorhii - Ukraynaca çeviri
 * Brian Missao da Vera - NVDA 2022.1 uyumluluğu

addon/doc/uk/README.tpl.md

@@ -0,0 +1,134 @@
+# Таймер для NVDA ${addon_version}
+Додає функції таймера та секундоміра безпосередньо в NVDA
+
+## завантажити
+
+Завантажити [ ${addon_summary} ${addon_version} addon](${addon_url}/releases/download/${addon_version}/${addon_name}-${addon_version}.nvda-addon)
+
+## таймер та секундомір
+
+Таймер відраховує певний час до 0. Коли він досягає 0, він завершує роботу та подає сигнал.
+
+Секундомір починає відлік від 0 і продовжує працювати, поки не отримає вказівку зупинитися. Коли це відбувається, відображається час, що минув.
+
+## Можливості
+
+### простий діалог налаштувань
+
+Таймер або секундомір можна настроїти за допомогою простого діалогу налаштувань.
+
+У цьому ж діалозі можна налаштувати різні оголошення перебігу.
+
+#### як це працює
+
+Скористайтеся підменю «Налаштування таймера для NVDA» або натисніть NVDA + Shift + t, щоб відкрити діалог налаштувань додатка.
+Підменю розташоване в меню «інструменти» NVDA.
+
+* якщо працює таймер або секундомір, ви можете:
+    * Відстежувати перебіг, читаючи рядок стану діалогу налаштувань.
+    * Призупиняти, відновлювати або зупиняти таймер або секундомір.
+* якщо таймер або секундомір зупинено, ви можете:
+    * Налаштувати режим роботи (таймер або секундомір)
+    * Налаштувати одиницю часу, яка використовується для початкового часу для таймера, а також для оголошення (секунди, хвилини або години)
+    * запустити таймер або секундомір.
+* у будь-який час ви можете:
+    * вибрати, як оголошуватиметься перебіг: мовленням, звуковим сигналом, і тим, і іншим або ніяк.
+
+### запуск за допомогою команд NVDA
+
+У будь-який момент можна запустити, зупинити, призупинити, відновити та отримати оголошення про перебіг роботи таймера або секундоміра без необхідності використання діалогу налаштувань.
+
+#### Як це працює
+
+* натисніть ctrl + shift + NVDA + s, щоб запустити або зупинити таймер або секундомір.
+    * Якщо ні таймер, ні секундомір не запущено, запуститься один із них відповідно до поточного режиму роботи.
+    * якщо один із них працює, він зупиниться. Час, що минув, оголошується, якщо працював секундомір
+    *     Якщо таймер запускати, а попередньо початковий час не встановлено, видається попередження.
+* натисніть ctrl + shift + NVDA + p, щоб призупинити або відновити таймер або секундомір.
+* натисніть ctrl + shift + NVDA + r, щоб перевірити перебіг таймера або секундоміра. Це особливо корисно, якщо всі оголошення про прогрес вимкнено, і ви хочете перевірити перебіг за запитом.
+
+### введення часу
+
+У діалозі налаштувань початковий час для таймера вводиться у форматі ГГ:ХХ:СС, де ГГ означає години, ХХ – хвилини, а СС – секунди.
+
+Повний формат вводити не потрібно, система сама його виведе:
+
+* якщо введено просте число, використовуватиметься обрана одиниця часу.
+* якщо вказано підодиниці вони будуть враховані. Наприклад, 01:05 стає однією хвилиною і п’ятьма секундами, якщо вибрано одиницю часу «хвилини».
+Якщо вибрано одиницею часу «години», 01:05 стає однією годиною, п’ятьма хвилинами та нулем секунд.
+* Підодиниці, що перевищують "секунди", недійсні. Якщо одиницею часу є "хвилини", значення 01:05:02 не буде прийнято.
+
+### запущений таймер чи секундомір
+
+Одночасно можна запустити лише один таймер або секундомір.
+Перебіг можна відстежувати за допомогою жодного, одного чи кількох оголошень, читаючи рядок стану діалогу таймера або виконуючи команду оголошення про статус, ctrl+shift+NVDA+r.
+Таким чином, можна запустити систему з відключеними оголошеннями і відстежувати прогрес, читаючи рядок стану при відкритті діалогу.
+
+Команди для зупинки, запуску, паузи, відновлення або отримання оголошення про перебіг роботи за запитом можна використовувати, навіть якщо діалог налаштувань активний.
+
+Може бути запущено лише один екземпляр діалогу налаштувань. Якщо діалог налаштувань закрито, поточне виконання таймера або секундоміра продовжуватиме працювати.
+
+Якщо діалог налаштувань відкрито під час роботи таймера або секундоміра, в ньому буде відображатися оновлена інформація.
+
+### точність часу
+
+Цей додаток не може рахувати час надзвичайно точно.
+
+Це відбувається тому, що мова python, якою написано NVDA, не може виконувати більше однієї інструкції одночасно, навіть якщо для використання доступно більше одного процесу або процесорного ядра.
+
+Таким чином, щоразу, коли NVDA говорить, обчислює або обробляє щось, підрахунок часу матиме невелику затримку.
+
+Точність, однак, повинна бути хорошою для переважної більшості випадків, якщо тільки не потрібна точність мілісекунд, інакше будь-який процес сильно постраждає від затримки.
+
+Для отримання точніших результатів оголошення варто вимкнути, а натомість дізнаватися про перебіг або за запитом, шляхом натискання клавіш ctrl+shift+NVDA+r, або читанням рядка стану в діалозі таймера.
+
+### оголошення
+
+#### Звукове оголошення
+
+Якщо цю функцію активовано, додаток відтворює звуковий сигнал кожного разу, коли відлік таймера або секундоміра досягає круглого значення відповідно до одиниці часу, налаштованої в діалозі налаштувань.
+
+Якщо ви, наприклад, налаштували таймер на 02:30 хвилин, то при відліку о 02:00 хвилин пролунає звуковий сигнал, а при відліку о 01:00 хвилині - ще один.
+
+Точний підрахунок можна отримати, прочитавши рядок стану діалогу налаштувань або виконавши команду оголошення статусу, ctrl+shift+NVDA+r.
+
+#### Оголошення мовленням
+
+При активації цієї функції поточний час відраховується щоразу, коли він досягає круглого значення, відповідно до одиниці часу, налаштованої в діалозі налаштувань.
+
+Якщо ви, наприклад, налаштували таймер на 02:30 хвилин, «2» буде вимовлено, коли підрахунок відбудеться на 02:00 хвилині, а «1» буде вимовлено, коли він настане на 01:00 хвилині.
+
+Точний підрахунок можна отримати, прочитавши рядок стану діалогу налаштувань або виконавши команду оголошення статусу, ctrl+shift+NVDA+r.
+
+### оголошення про завершення таймера
+
+Коли час, що відраховується таймером, досягає 0, він завершується. Про це, незалежно від того, чи активний діалог налаштувань, сигналізує тихий звук будильника. Цей звук не залежить від того, чи активні оголошення про прогрес.
+
+### оголошення про закінчення секундоміра
+
+Коли секундомір зупиняється, його час вимовляється, незалежно від того, чи діалог налаштувань активний.
+
+Час останнього виконання секундоміра можна перевірити, переглянувши рядок стану діалогу налаштувань або натиснувши NVDA+ctrl+shift+r. Ця інформація скидається під час запуску нового секундоміра або таймера.
+
+### Змінити жести вводу
+
+Ви можете змінити стандартні жести для цього додатка, зайшовши в розділ "Таймер для NVDA" в меню NVDA / Параметри / Жести вводу.
+
+Пам'ятайте, що при зміні жестів вводу необхідно вибирати команди, які не використовуються іншими додатками NVDA, щоб уникнути конфліктів.
+
+# Сприяння та переклад
+
+Якщо ви хочете долучитись до роботи над додатком або перекласти його, будь ласка, приєднайтеся до [репозиторію проєкту](${addon_url}) і знайдіть інструкції у файлі contributing.md будь-якою з ваших мов або в папці з англомовною документацією.
+
+## Перекладачі
+
+Особлива подяка
+
+* Marlon Brandão за Sousa - бразильський (португальський) переклад
+* Tarik Hadžirović - хорватський переклад
+* Rémy Ruiz - французький переклад
+* Ângelo Miguel Abrantes - португальський переклад
+* Rémy Ruiz - іспанський переклад
+* Umut KORKMAZ - турецький переклад
+* Heorhii - український переклад
+* Brian Missao da Vera - NVDA 2022.1 compatibility

addon/doc/uk/contributing.md

@@ -0,0 +1,34 @@
+# Участь
+
+## збирання додатка
+
+Вам знадобляться:
+
+* python 3.6 або вище.
+* налаштований pip
+* scons (pip install scons)
+* markdown (pip install markdown)
+* msgfmt utility. Найпростіше отримати це, встановивши git bash і ввімкнувши інструменти bash у командному рядку
+
+Після того, як ви все встановите, команда scons у корені проєкту повинна створити додаток і створити документацію.
+
+## переклади
+
+### переклад додатка
+
+Якщо припустити, що у вас усе налаштовано для збирання додатка (див. попередню тему), команда scons pot має створити файл pot у кореневому каталозі проєкту. Він бере участь у створенні файлів .po для вашої мови.
+Наявні мови можна знайти у папці /addon/locale
+
+### переклад документації
+
+Переклади документації генеруються з файлів .tpl.md (а не з .md). Ось чому, крім цього файлу (read.md) у корені проекту, ви не знайдете інших файлів .md.
+
+Файли .tpl.md — це звичайні файли markdown з одним доповненням: якщо ви використаєте ${[var]} у його тексті, [var] буде замінено змінною з такою самою назвою, визначеною у buildvars.py, коли генеруються відповідні файли md і.html.
+
+Якщо не існує змінної з такою назвою, заміна не відбувається.
+
+Це корисно, наприклад, для створення посилань і заголовків із включеною версією додатка без необхідності переписувати документацію.
+
+Щоб перекласти документацію, візьміть файл readme.tpl.md у корені проєкту та перекладіть його. Перекладений файл повинен мати назву readme.tpl.md і розміщуватися в каталозі addon/doc/[lang].
+
+Змінних ${[xxx]} не чіпайте. Для генерації документації, виконайте команду scons і файли у форматах markdown та HTML згенеруються.