Localization fixes (#7)

* Localization  and Readme.md updates

Localization and Readme.md files has been updated.

* Corrections in Russian documentation

Russian readme.md has been corrected.

* Russian Readme.md fixes

Russian readme.md has been fixed.
At the line 8  the description of the add-on's operation has been changed.

* Russian Readme.md fixes

Fixed some sentences in Russian Readme.md file.

* Fixes in localization

Ukrainian nvda.po file has been updated by adding 2 recently added strings. Also chinese nvda.po file has been fixed.

addon/doc/ru/readme.md

@@ -0,0 +1,14 @@
+# Дополнение для NVDA Webcam helper
+Это дополнение для [NVDA], бесплатной программы экранного доступа с открытым исходным кодом для Microsoft Windows, поможет вам лучше ориентироваться при видеозвонках, давая указания о том, как правильно расположиться перед камерой. Оно использует распознавание лиц и обработку изображений, чтобы определить, находитесь ли вы в стороне или смотрите прямо в камеру, а также достаточна ли освещённость.
+
+# Установка
+Данное дополнение содержит двоичные зависимости, которые требуют Visual C++ Redistributable для 32-битной платформы, [прямая загрузка с сайта Microsoft](https://aka.ms/vs/17/release/vc_redist.x86.exe)
+
+# Использование
+После установки дополнения нажмите NVDA+shift+w и следуйте инструкциям. После того как вы услышите сообщение "Вы в фокусе камеры", нажмите клавишу escape, чтобы остановить функцию анализа веб-камеры и отключить её.
+
+# Соглашения при разработке
+Поскольку это дополнение для NVDA, то код запускается внутри процесса чтения с экрана, поэтому он должен работать под определённой средой выполнения (Python 3.7 32bit) и нести с собой свои зависимости. Также установленный стиль кода в NVDA отличается от стиля pep8 по историческим причинам, но здесь он соблюдается для единообразия.
+
+[NVDA]: https://github.com/nvaccess/nvda
+

addon/locale/ru/LC_MESSAGES/nvda.po

@@ -1,89 +1,126 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
+# This file is distributed under the same license as the webcamHelper package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
 msgid ""
 msgstr ""
-"Project-Id-Version: WebcamHelper\n"
-"POT-Creation-Date: 2023-12-26 19:40+0300\n"
-"PO-Revision-Date: 2024-01-06 17:55+0300\n"
+"Project-Id-Version: webcamHelper 0.1.1\n"
+"Report-Msgid-Bugs-To: [email protected]\n"
+"POT-Creation-Date: 2023-12-17 03:49+0800\n"
+"PO-Revision-Date: 2024-03-06 10:59+0300\n"
 "Last-Translator: Danil Kostenkov <[email protected]>\n"
-"Language-Team: nvda.ru\n"
+"Language-Team: Danil Kostenkov <[email protected]>\n"
 "Language: ru_RU\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && "
-"n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n"
+"Plural-Forms: nplurals=1; plural=0;\n"
 "X-Generator: Poedit 3.4.2\n"
-"X-Poedit-Basepath: ../../../globalPlugins\n"
-"X-Poedit-SourceCharset: UTF-8\n"
-"X-Poedit-SearchPath-0: .\n"
 
-#: webcamHelper/__init__.py:42
+#. Threshold for low brightness
+#: addon\globalPlugins\webcamHelper\__init__.py:42
 msgid "The lighting is too dim, consider increasing it"
 msgstr "Освещение слишком тусклое, подумайте о том, чтобы увеличить его"
 
-#: webcamHelper/__init__.py:44
+#. Threshold for high brightness
+#: addon\globalPlugins\webcamHelper\__init__.py:44
 msgid "The lighting is too bright, consider reducing it"
 msgstr "Освещение слишком яркое, подумайте о том, чтобы уменьшить его"
 
-#: webcamHelper/__init__.py:50
+#: addon\globalPlugins\webcamHelper\__init__.py:50
 msgid "No face detected"
 msgstr "Лицо не обнаружено"
 
-#: webcamHelper/__init__.py:66
+#. Horizontal position
+#. More than 10% off center horizontally
+#: addon\globalPlugins\webcamHelper\__init__.py:66
 msgid "Move right"
 msgstr "Поверните голову направо"
 
-#: webcamHelper/__init__.py:66
+#: addon\globalPlugins\webcamHelper\__init__.py:66
 msgid "Move left"
 msgstr "Поверните голову налево"
 
-#: webcamHelper/__init__.py:70
+#. Vertical position
+#. More than 10% off center vertically
+#: addon\globalPlugins\webcamHelper\__init__.py:70
 msgid "Move up"
 msgstr "Поднимите голову"
 
-#: webcamHelper/__init__.py:70
+#: addon\globalPlugins\webcamHelper\__init__.py:70
 msgid "Move down"
 msgstr "Опустите голову"
 
-#: webcamHelper/__init__.py:75
+#: addon\globalPlugins\webcamHelper\__init__.py:75
 msgid "possible cropping on the left"
 msgstr "возможное обрезание слева"
 
-#: webcamHelper/__init__.py:77
+#: addon\globalPlugins\webcamHelper\__init__.py:77
 msgid "possible cropping on the right"
 msgstr "возможное обрезание справа"
 
-#: webcamHelper/__init__.py:79
+#: addon\globalPlugins\webcamHelper\__init__.py:79
 msgid "possible cropping on the top"
 msgstr "возможное обрезание сверху"
 
-#: webcamHelper/__init__.py:81
+#: addon\globalPlugins\webcamHelper\__init__.py:81
 msgid "possible cropping on the bottom"
 msgstr "возможное обрезание снизу"
 
-#: webcamHelper/__init__.py:88
+#. More than 20% difference in area
+#: addon\globalPlugins\webcamHelper\__init__.py:88
 msgid "Move closer"
 msgstr "Придвиньтесь ближе"
 
-#: webcamHelper/__init__.py:88
+#: addon\globalPlugins\webcamHelper\__init__.py:88
 msgid "Move back"
 msgstr "Отодвиньтесь назад"
 
-#: webcamHelper/__init__.py:100
+#: addon\globalPlugins\webcamHelper\__init__.py:100
 msgid "Face well positioned"
 msgstr "Вы в фокусе камеры"
 
-#: webcamHelper/__init__.py:110
+#: addon\globalPlugins\webcamHelper\__init__.py:110
 msgid "Starts continuous webcam analysis, press escape to cancel"
 msgstr "Запускает непрерывный анализ веб-камеры, для отмены нажмите Escape"
 
-#: webcamHelper/__init__.py:118
+#: addon\globalPlugins\webcamHelper\__init__.py:118
 msgid "Starting webcam analysis, press escape key to stop"
 msgstr "Запущен анализ веб-камеры, для остановки нажмите клавишу Escape"
 
-#: webcamHelper/__init__.py:138
+#: addon\globalPlugins\webcamHelper\__init__.py:138
 msgid "Failed to open webcam"
 msgstr "Не удалось открыть веб-камеру"
 
-#: webcamHelper/__init__.py:160
+#: addon\globalPlugins\webcamHelper\__init__.py:160
 msgid "Webcam analysis stopped"
 msgstr "Анализ веб-камеры остановлен"
+
+#. Add-on summary, usually the user visible name of the addon.
+#. Translators: Summary for this add-on
+#. to be shown on installation and add-on information found in Add-ons Manager.
+#: buildVars.py:23
+msgid "Webcam helper"
+msgstr "Помощник по работе с веб-камерой"
+
+#: buildVars.py:27
+msgid ""
+"This add-on helps you position yourself in front of the camera for video "
+"calls.\n"
+"It will tell you if you are too close or too far from the camera,\n"
+"if you are too much to the left or right, if you are too high or too low,\n"
+"and if the lighting is too dark or too bright. It will also tell you\n"
+"if you are too close to the edge of the frame, which may indicate that you "
+"are too close to the edge of the camera's field of view."
+msgstr ""
+"Это дополнение поможет вам правильно расположиться перед камерой при "
+"видеозвонках.\n"
+"Оно подскажет вам, находитесь ли вы слишком близко или слишком далеко от "
+"камеры,\n"
+"находитесь ли вы слишком сильно слева или справа, находитесь ли вы слишком "
+"высоко или слишком низко,\n"
+"если освещение слишком темное или слишком яркое, дополнение также "
+"подскажет вам,\n"
+"если вы находитесь слишком близко к краю кадра, что может означать, что вы "
+"находитесь слишком близко к краю поля зрения камеры."

addon/locale/uk/LC_MESSAGES/nvda.po

@@ -1,108 +1,128 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
+# This file is distributed under the same license as the webcamHelper package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
 msgid ""
 msgstr ""
-"Project-Id-Version: \n"
-"POT-Creation-Date: 2023-12-13 10:51+0200\n"
-"PO-Revision-Date: 2024-03-04 22:42+0200\n"
+"Project-Id-Version: webcamHelper 0.1.1\n"
+"Report-Msgid-Bugs-To: [email protected]\n"
+"POT-Creation-Date: 2023-12-17 03:49+0800\n"
+"PO-Revision-Date: 2024-03-08 14:38+0300\n"
 "Last-Translator: Volodymyr Pyrih <[email protected]>\n"
 "Language-Team: \n"
 "Language: uk\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=1; plural=0;\n"
 "X-Generator: Poedit 3.4.2\n"
-"X-Poedit-Basepath: ../../../../../../../..\n"
-"X-Poedit-SearchPath-0: Downloads/webcam-helper-nvda-addon-master/addon/"
-"globalPlugins\n"
-"X-Poedit-SearchPath-1: AppData/Roaming/nvda/addons/webcamHelper/"
-"globalPlugins\n"
-
-#: AppData/Roaming/nvda/addons/webcamHelper/globalPlugins/webcamHelper/__init__.py:42
-#: Downloads/webcam-helper-nvda-addon-master/addon/globalPlugins/webcamHelper/__init__.py:42
+
+#. Threshold for low brightness
+#: addon\globalPlugins\webcamHelper\__init__.py:42
 msgid "The lighting is too dim, consider increasing it"
 msgstr "Освітлення занадто слабке, розгляньте можливість його збільшення"
 
-#: AppData/Roaming/nvda/addons/webcamHelper/globalPlugins/webcamHelper/__init__.py:44
-#: Downloads/webcam-helper-nvda-addon-master/addon/globalPlugins/webcamHelper/__init__.py:44
+#. Threshold for high brightness
+#: addon\globalPlugins\webcamHelper\__init__.py:44
 msgid "The lighting is too bright, consider reducing it"
 msgstr "Освітлення занадто яскраве, розгляньте можливість його зменшення"
 
-#: AppData/Roaming/nvda/addons/webcamHelper/globalPlugins/webcamHelper/__init__.py:50
-#: Downloads/webcam-helper-nvda-addon-master/addon/globalPlugins/webcamHelper/__init__.py:50
+#: addon\globalPlugins\webcamHelper\__init__.py:50
 msgid "No face detected"
 msgstr "Обличчя не виявлено"
 
-#: AppData/Roaming/nvda/addons/webcamHelper/globalPlugins/webcamHelper/__init__.py:66
-#: Downloads/webcam-helper-nvda-addon-master/addon/globalPlugins/webcamHelper/__init__.py:66
+#. Horizontal position
+#. More than 10% off center horizontally
+#: addon\globalPlugins\webcamHelper\__init__.py:66
 msgid "Move right"
 msgstr "Перемістіться праворуч"
 
-#: AppData/Roaming/nvda/addons/webcamHelper/globalPlugins/webcamHelper/__init__.py:66
-#: Downloads/webcam-helper-nvda-addon-master/addon/globalPlugins/webcamHelper/__init__.py:66
+#: addon\globalPlugins\webcamHelper\__init__.py:66
 msgid "Move left"
 msgstr "Перемістіться ліворуч"
 
-#: AppData/Roaming/nvda/addons/webcamHelper/globalPlugins/webcamHelper/__init__.py:70
-#: Downloads/webcam-helper-nvda-addon-master/addon/globalPlugins/webcamHelper/__init__.py:70
+#. Vertical position
+#. More than 10% off center vertically
+#: addon\globalPlugins\webcamHelper\__init__.py:70
 msgid "Move up"
 msgstr "Перемістіться вище"
 
-#: AppData/Roaming/nvda/addons/webcamHelper/globalPlugins/webcamHelper/__init__.py:70
-#: Downloads/webcam-helper-nvda-addon-master/addon/globalPlugins/webcamHelper/__init__.py:70
+#: addon\globalPlugins\webcamHelper\__init__.py:70
 msgid "Move down"
-msgstr "перемістіться нижче"
+msgstr "Перемістіться нижче"
 
-#: AppData/Roaming/nvda/addons/webcamHelper/globalPlugins/webcamHelper/__init__.py:75
-#: Downloads/webcam-helper-nvda-addon-master/addon/globalPlugins/webcamHelper/__init__.py:75
+#: addon\globalPlugins\webcamHelper\__init__.py:75
 msgid "possible cropping on the left"
 msgstr "можливе обрізання зліва"
 
-#: AppData/Roaming/nvda/addons/webcamHelper/globalPlugins/webcamHelper/__init__.py:77
-#: Downloads/webcam-helper-nvda-addon-master/addon/globalPlugins/webcamHelper/__init__.py:77
+#: addon\globalPlugins\webcamHelper\__init__.py:77
 msgid "possible cropping on the right"
 msgstr "можливе обрізання справа"
 
-#: AppData/Roaming/nvda/addons/webcamHelper/globalPlugins/webcamHelper/__init__.py:79
-#: Downloads/webcam-helper-nvda-addon-master/addon/globalPlugins/webcamHelper/__init__.py:79
+#: addon\globalPlugins\webcamHelper\__init__.py:79
 msgid "possible cropping on the top"
 msgstr "можливе обрізання згори"
 
-#: AppData/Roaming/nvda/addons/webcamHelper/globalPlugins/webcamHelper/__init__.py:81
-#: Downloads/webcam-helper-nvda-addon-master/addon/globalPlugins/webcamHelper/__init__.py:81
+#: addon\globalPlugins\webcamHelper\__init__.py:81
 msgid "possible cropping on the bottom"
 msgstr "можливе обрізання знизу"
 
-#: AppData/Roaming/nvda/addons/webcamHelper/globalPlugins/webcamHelper/__init__.py:88
-#: Downloads/webcam-helper-nvda-addon-master/addon/globalPlugins/webcamHelper/__init__.py:88
+#. More than 20% difference in area
+#: addon\globalPlugins\webcamHelper\__init__.py:88
 msgid "Move closer"
 msgstr "Занадто далеко"
 
-#: AppData/Roaming/nvda/addons/webcamHelper/globalPlugins/webcamHelper/__init__.py:88
-#: Downloads/webcam-helper-nvda-addon-master/addon/globalPlugins/webcamHelper/__init__.py:88
+#: addon\globalPlugins\webcamHelper\__init__.py:88
 msgid "Move back"
 msgstr "Занадто близько"
 
-#: AppData/Roaming/nvda/addons/webcamHelper/globalPlugins/webcamHelper/__init__.py:100
+#: addon\globalPlugins\webcamHelper\__init__.py:100
 msgid "Face well positioned"
 msgstr "Обличчя розташоване добре"
 
-#: AppData/Roaming/nvda/addons/webcamHelper/globalPlugins/webcamHelper/__init__.py:110
-#: Downloads/webcam-helper-nvda-addon-master/addon/globalPlugins/webcamHelper/__init__.py:110
+#: addon\globalPlugins\webcamHelper\__init__.py:110
 msgid "Starts continuous webcam analysis, press escape to cancel"
 msgstr ""
 "Починає безперервний аналіз веб-камери, натисніть клавішу escape, щоб "
 "скасувати"
 
-#: AppData/Roaming/nvda/addons/webcamHelper/globalPlugins/webcamHelper/__init__.py:118
-#: Downloads/webcam-helper-nvda-addon-master/addon/globalPlugins/webcamHelper/__init__.py:118
+#: addon\globalPlugins\webcamHelper\__init__.py:118
 msgid "Starting webcam analysis, press escape key to stop"
 msgstr "Аналіз веб-камери почато, натисніть клавішу Escape, щоб зупинити"
 
-#: AppData/Roaming/nvda/addons/webcamHelper/globalPlugins/webcamHelper/__init__.py:138
-#: Downloads/webcam-helper-nvda-addon-master/addon/globalPlugins/webcamHelper/__init__.py:138
+#: addon\globalPlugins\webcamHelper\__init__.py:138
 msgid "Failed to open webcam"
 msgstr "Не вдалося відкрити веб-камеру"
 
-#: AppData/Roaming/nvda/addons/webcamHelper/globalPlugins/webcamHelper/__init__.py:160
-#: Downloads/webcam-helper-nvda-addon-master/addon/globalPlugins/webcamHelper/__init__.py:160
+#: addon\globalPlugins\webcamHelper\__init__.py:160
 msgid "Webcam analysis stopped"
 msgstr "Аналіз веб-камери зупинено"
+
+#. Add-on summary, usually the user visible name of the addon.
+#. Translators: Summary for this add-on
+#. to be shown on installation and add-on information found in Add-ons Manager.
+#: buildVars.py:23
+msgid "Webcam helper"
+msgstr "Помічник веб-камери"
+
+#: buildVars.py:27
+msgid ""
+"This add-on helps you position yourself in front of the camera for video "
+"calls.\n"
+"It will tell you if you are too close or too far from the camera,\n"
+"if you are too much to the left or right, if you are too high or too low,\n"
+"and if the lighting is too dark or too bright. It will also tell you\n"
+"if you are too close to the edge of the frame, which may indicate that you "
+"are too close to the edge of the camera's field of view."
+msgstr ""
+"Це доповнення допоможе вам правильно розташуватися перед камерою при "
+"відеодзвінках.\n"
+"Воно підкаже вам, чи перебуваєте ви занадто близько або занадто далеко від "
+"камери,\n"
+"незалежно від того, перебуваєте ви занадто сильно зліва чи справа, ви "
+"занадто високі чи занадто низькі,\n"
+"якщо освітлення занадто темне або занадто яскраве, додаток також підкаже "
+"вам,\n"
+"якщо ви занадто близько до краю кадру, що може означати, що ви занадто "
+"близько до краю поля зору камери."

addon/locale/zh_CN/LC_MESSAGES/nvda.po

@@ -8,15 +8,15 @@ msgstr ""
 "Project-Id-Version: webcamHelper 0.1.1\n"
 "Report-Msgid-Bugs-To: [email protected]\n"
 "POT-Creation-Date: 2023-12-17 03:49+0800\n"
-"PO-Revision-Date: 2023-12-17 03:51+0800\n"
+"PO-Revision-Date: 2024-03-07 17:50+0300\n"
 "Last-Translator: \n"
 "Language-Team: Cary-Rowen\n"
 "Language: zh_CN\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
-"X-Generator: Poedit 3.4.1\n"
+"X-Generator: Poedit 3.4.2\n"
 
 #. Threshold for low brightness
 #: addon\globalPlugins\webcamHelper\__init__.py:42
@@ -83,7 +83,7 @@ msgstr "面部位置合适"
 
 #: addon\globalPlugins\webcamHelper\__init__.py:110
 msgid "Starts continuous webcam analysis, press escape to cancel"
-msgstr "已开始摄像头检测，按 ESC 取消。"
+msgstr "已开始摄像头检测，按 ESC 取消"
 
 #: addon\globalPlugins\webcamHelper\__init__.py:118
 msgid "Starting webcam analysis, press escape key to stop"

readme.md

@@ -1,8 +1,8 @@
 # Webcam helper NVDA Addon
 This addon for [NVDA], a free and open source screen reader for Microsoft Windows helps you to get a better shot at video calls by giving instructions about how to position yourself in front of camera. It uses facial recognition and image processing to detect if you are off to either side or vertically, as well as if the ilumination is enough.
 
-# Instalation
-This addon contains binary dependencies which require Visual C++ Redistributable for 32-bit platform, [direct download from Icrosoft](https://aka.ms/vs/17/release/vc_redist.x86.exe)
+# Installation
+This addon contains binary dependencies which require Visual C++ Redistributable for 32-bit platform, [direct download from Microsoft](https://aka.ms/vs/17/release/vc_redist.x86.exe)
 
 # Usage
 After installing the addon, press NVDA+shift+w and follow the instructions. After you hear the message "The face is well positioned" - you can press the escape key to stop the function and release your camera.