From d59c608c3658c08296ce27490f510b34026dcb28 Mon Sep 17 00:00:00 2001 From: cary-rowen Date: Mon, 18 Apr 2022 07:52:59 +0800 Subject: [PATCH] Preparations before the release of version 1.0 --- addon/globalPlugins/Pinyin2Hanzi/__init__.py | 3 +- addon/globalPlugins/Reader.py | 2 +- addon/globalPlugins/brailleKeyboard.py | 6 +-- addon/globalPlugins/brailleTranslator.py | 8 ++-- buildVars.py | 2 +- readme.md | 49 +++++++++++++++++++- 6 files changed, 59 insertions(+), 11 deletions(-) diff --git a/addon/globalPlugins/Pinyin2Hanzi/__init__.py b/addon/globalPlugins/Pinyin2Hanzi/__init__.py index 61e7384..cc77395 100644 --- a/addon/globalPlugins/Pinyin2Hanzi/__init__.py +++ b/addon/globalPlugins/Pinyin2Hanzi/__init__.py @@ -7,4 +7,5 @@ from .dag import dag -from .viterbi import viterbi \ No newline at end of file +from .viterbi import viterbi + diff --git a/addon/globalPlugins/Reader.py b/addon/globalPlugins/Reader.py index 5a87f42..8d6a5f4 100644 --- a/addon/globalPlugins/Reader.py +++ b/addon/globalPlugins/Reader.py @@ -29,7 +29,7 @@ def terminate(self): @scriptHandler.script( - description=_("盲文转义开关"), + description=_("开关盲文到语音转译"), gesture=_("kb:NVDA+O")) def script_toggle(self, gesture): if not globalVars.speechDictionaryProcessing: diff --git a/addon/globalPlugins/brailleKeyboard.py b/addon/globalPlugins/brailleKeyboard.py index d850d88..85d699b 100644 --- a/addon/globalPlugins/brailleKeyboard.py +++ b/addon/globalPlugins/brailleKeyboard.py @@ -196,8 +196,8 @@ def _keyUp(self, vkCode, scanCode, extended, injected): @script( # Translators: Describes a command. - description=_("Toggles braille input from the PC keyboard."), - gesture="kb:NVDA+z" + description=_("开关盲文输入"), + gesture="kb:NVDA+0" ) def script_toggleInput(self, gesture): if self.isEnabled: @@ -224,7 +224,7 @@ def script_settings(self, gesture): class AddonSettingsPanel(SettingsPanel): - #title = ADDON_SUMMARY + title = "盲文输入" def makeSettings(self, settingsSizer): sHelper = guiHelper.BoxSizerHelper(self, sizer=settingsSizer) diff --git a/addon/globalPlugins/brailleTranslator.py b/addon/globalPlugins/brailleTranslator.py index 1aa03da..3b5951b 100644 --- a/addon/globalPlugins/brailleTranslator.py +++ b/addon/globalPlugins/brailleTranslator.py @@ -1,4 +1,5 @@ import globalPluginHandler +import globalCommands from scriptHandler import script import ui import api @@ -89,16 +90,17 @@ def brailleToText(braille): if temp is not None: resultText=resultText+str(temp) print("result:",resultText) api.copyToClip(resultText) + ui.message(resultText) class GlobalPlugin(globalPluginHandler.GlobalPlugin): + scriptCategory = globalCommands.SCRCAT_BRAILLE @script( - description=_("Announces the window class name of the current focus object"), + description=_("盲文转汉字"), gesture="kb:NVDA+x" ) - def script_announceWindowClassName(self, gesture): + def script_TransBraille(self, gesture): focusObj = api.getFocusObject() value = focusObj.value - ui.message("hello") brailleToText(value) \ No newline at end of file diff --git a/buildVars.py b/buildVars.py index d352121..e0bcb97 100644 --- a/buildVars.py +++ b/buildVars.py @@ -35,7 +35,7 @@ def _(arg): # Minimum NVDA version supported (e.g. "2018.3.0", minor version is optional) "addon_minimumNVDAVersion": 2021.1, # Last NVDA version supported/tested (e.g. "2018.4.0", ideally more recent than minimum version) - "addon_lastTestedNVDAVersion": 2021.3, + "addon_lastTestedNVDAVersion": 2022.1, # Add-on update channel (default is None, denoting stable releases, # and for development releases, use "dev".) # Do not change unless you know what you are doing! diff --git a/readme.md b/readme.md index d89a589..4d4a82e 100644 --- a/readme.md +++ b/readme.md @@ -1,4 +1,49 @@ -# NV-Braille2Speech -**Braille conversion add-on for NVDA** +## 软件介绍 + +本软件结合电子化盲文与人工智能技术，实现了电子盲文系统，系统中包括盲文输入法、文本转义、语音转义以及汉字转译成盲文等模块，目的是为解放视障者的双耳，提供一个在无干扰状态下输入盲文，并可在盲文、语音、汉字之间自由转换的，保证可写可读的应用软件。 + +## 软件安装 + +视障者主要使用键盘，借助屏幕阅读器——Screen Reader（可以将屏幕上的文字信息转化为语音的软件）来操作计算机。所以本系统作为 NVDA 屏幕阅读器扩展插件的形式在 GPL2.0 开原协议下分发，保证了与屏幕阅读器的良好兼容。 +NVDA(NonVisual Desktop Access) 由澳大利亚的非盈利性组织 NV Access 发起，是一款完全开源且免费的屏幕阅读器，已被翻译成包括中文在内的 55 种语言，成为了多达 175 个国家视障用户使用个人电脑不可或缺的基础设施。 + +如需安装并使用本软件，可遵循以下步骤进行安装部署： +1. 从官方网站下载并安装 NVDA 屏幕阅读器： https://www.nvaccess.org/ +2. 从 Github Release 页面下载本软件： https://github.com/cary-rowen/NV-Braille2Speech/releases +3. 下载后您将得到一个 .nvda-addon 的文件，此为本软件的安装包，点击后 NVDA 会询问您是否确认安装本软件，只需点击“是”按钮，即可完成本软件的安装部署。 + +## 输入盲文 + +1. 按 NVDA键 + 数字 0 这组快捷键开启盲文输入。此快捷键可以从 NVDA 设置中的“按键与手势”对话框的盲文类别下更改。 +2. 通过在 PC 键盘上同时按下一组按键来输入盲文，就如同在实体盲文键盘上输入一样。 + * 如用双手输入文本，请使用 QWERTY 键盘布局的以下按键，或其他键盘布局相应位置的按键： + * f、d 和 s分别代表 1、2 和 3 点。 + * j、k 和 l分别代表 4、5 和 6 点。 + * 使用 a 和分号（;）分别代表 7 和 8 点。 + * 您也可用上一行中的相应按键，即 q、w、e、r、u、i、o 和 p。 + * 如用单手输入，则可以同时或依次按下相应的键来输入盲文，输入完一个盲文单元后，请按 g 或 h 键以确认输入。如果在输入过程中出错，可以在确认输入之前，按t或y清除点位。 + QWERTY 键盘布局中使用的按键如下： + * 左手： f、 d、 s、 r、 e、 w、 a、 q 分别代表 1、 2、 3、 4、 5、 6、 7 、 8 点。 + * 右手： j、 k、 l、 u、 i、 o、 分号（;）、 p 分别代表 1、 2、 3、 4、 5、 6、 7、 8 点。 +3. 您可以照常使用大多数其他按键，包括空格键、退格键、回车键和其他功能键。请注意不要按下 alt + shift，因为更改键盘布局可能会影响输入的点位。 +4. 按下空格键加盲文点的组合即可移动系统光标（或读出当前行），就像您使用点显器一样。例如，空格 + 1 点模拟上光标，空格 + 4、 5、 6 点模拟Ctrl + end，空格 + 1、 4 点读出当前行，等等。 +5. 按 NVDA + 0 关闭盲文输入。 + + +## 读出盲文 + +如需将输入的盲文转换为语音，用户只需按下 NVDA + O 这组按键即可开启或关闭语音转译模式。 +在语音转译模式下，本系统能够对用户输入的 Unicode 盲文进行时时转译，例如： + +（1） 若用户输入： “⠌⠲⠛⠕⠂” 在开启语音模式的情况下会直接以 TTS 朗读为“中国”。 +（2） 若用户输入： “⠌⠲⠛⠕⠂” 在关闭语音模式的情况下会朗读实际盲文点位，即：“3-4点；2-5-6点；1-2-4-5点；1-3-5点；2点，” + +## 翻译盲文成汉字 + +如需将输入的盲文转换为汉字，用户只需按下 NVDA + X 这组按键即可将已输入的 Unicode 盲文转换为汉字。 + +对于转换后的结果，可以选择使用语音直接读出，或者复制到剪贴板便于粘贴。 + +比如： 若用户输入： “⠌⠲⠛⠕⠂” 后按下 NVDA + X 会听到 TTS 朗读“中国”，同时将“中国”这两个字复制到 Windows 系统剪贴板。