URL: https://github.com/paulber19/notepadPlusPlusAccessEnhancementNVDAAddon.git
Загрузка:
Совместимость:
Переводчик(и): автоматический перевод
Это дополнение направлено на улучшение доступности текстового редактора Notepad++ и добавление функций для облегчения редактирования файлов, используемых в языке Python, и файлов, написанных на языке разметки Markdown.
Оно включает большинство дополнений, предоставленных дополнением NVDA_notepadPlusPlus, созданным Дереком Римером (Derek Riemer) и Тууккой Ояла (Tuukka Ojala), затем модифицированным Робертом Хенгги (Robert Hänggi) и Andre9642, а именно:
И оно добавляет следующие дополнения:
Для строк:
Добавлено для файлов Markdown или txt2tags:
Добавлено для плагина Notepad++ DSpellCheck:
Это дополнение было протестировано с версиями Notepad++ 8.9.2 и 8.8.3 64-бит.
Это дополнение использует и перехватывает сочетания клавиш Notepad++, настроенные по умолчанию. Поэтому для его правильной работы настоятельно рекомендуется не изменять эти сочетания клавиш.
Большинство жестов ввода, предоставляемых этим дополнением, можно изменить с помощью диалогового окна NVDA «Жесты ввода».
В документе вы можете перейти к симметричному разделителю, нажав «control + b» (сочетание клавиш Notepad++, которое не следует изменять).
Для этого курсор должен быть расположен на символе-разделителе типа фигурной скобки, круглой скобки, квадратной скобки, которому должен соответствовать симметричный разделитель.
Когда вы нажимаете эту команду, дополнение заставляет NVDA прочитать строку, на которую вы попали, и если строка состоит только из символа симметричного разделителя, оно прочитает строку выше и ниже этого разделителя, чтобы получить представление о контексте.
Функциональность автозаполнения Notepad++ недоступна по умолчанию. Автозаполнение имеет множество проблем, включая отображение во всплывающем окне.
Чтобы сделать эту функциональность доступной, необходимо выполнить три действия.
Примечание: Весь текст отображается шрифтом Брайля, если подключено брайлевское устройство. Эта функция в настоящее время является экспериментальной, поэтому, пожалуйста, сообщайте о любых ошибках.
Одна из самых замечательных функций Notepad++ — возможность использовать инкрементальный поиск.
Инкрементальный поиск — это режим поиска, в котором вы ищете тестовую фразу, вводя её в поле редактирования, и документ перемещается, показывая вам результат поиска в реальном времени.
По мере ввода документация перемещается, чтобы отобразить строку текста с наиболее вероятной фразой, которую вы ищете. Он также выделяет текст, который соответствует.
Программа также сообщает вам, сколько совпадений было обнаружено. Есть кнопки для перехода к следующему и предыдущему совпадению.
По мере ввода NVDA будет объявлять строку текста, найденную Notepad++ в результатах поиска. NVDA также объявляет количество совпадений, но только если количество совпадений изменилось. Когда вы нашли нужную строку текста, просто нажмите «Esc», и эта строка текста окажется на вашем курсоре.
Чтобы запустить это диалоговое окно, выберите «Инкрементальный поиск» в меню «Поиск» или нажмите «alt + control + i».
По умолчанию, если вы нажмете «control + f», откроется диалоговое окно поиска.
Если вы введёте некоторый текст в его поле редактирования и нажмёте «Enter», текст в окне будет выделен, и фокус переместится к следующему результату поиска. Окно остаётся открытым, и его необходимо закрыть клавишей «Escape».
Затем вы можете нажать «F3» или «Shift + F3», чтобы повторить поиск в прямом или обратном направлении соответственно.
Поскольку NVDA в этом случае молчит, дополнение позволит NVDA прочитать текущую строку и выделение в строке, которое представляет собой найденный текст.
++ Сравнение текста ++ [HDR_Compare] Эта функция позволяет быстро и легко сравнить выделенный текст с текстом в буфере обмена.
После выделения текста используйте жест ввода «windows+control+F2».
Результат отображается в диалоговом окне.
Notepad++ отображает в заголовке окна редактирования и в списке вкладок имя файла, которому предшествует его абсолютный путь.
Этот путь может быть очень длинным и довольно утомительным для восприятия на слух.
В настройках Notepad++ можно отображать в заголовке окна редактирования только имя файла, но это не касается списка вкладок, до которого можно добраться с помощью «control + tab», удерживая клавишу «control» нажатой.
Поэтому это дополнение позволяет объявлять в более краткой форме заголовок окна редактирования и имена элементов в списке вкладок, сокращая пути к файлам или даже полностью удаляя их.
Категория «Параметры» настроек дополнения содержит группу настроек «Минимизированное объявление пути к файлу» для управления этой функцией.
Опция «Сокращать путь» позволяет активировать или деактивировать объявление сокращённого пути.
По умолчанию она не включена.
Когда эта опция активирована, путь к файлу сокращается в соответствии с уровнем, настроенным в выборе «Иерархический уровень предшественников для сохранения».
Этот уровень может варьироваться от 0 до 10:
Если уровень равен 0, объявляется только имя файла.
Для уровня, равного -1, путь к файлу объявляется в форме:
«буква диска: \ ... \ иерархическая папка -1 \ имя файла»
Для уровня, равного -2, это будет:
«буква диска: \ ... \ папка иерархического уровня -2 \ иерархическая папка -1 \ имя файла»
Если количество иерархических уровней в пути меньше настроенного уровня, путь остаётся неизменным.
Notepad++ отображает имя документа в заголовке окна редактирования или в списке вкладок, представленном «control + tab» и «control», в форме: путь к файлу, за которым следует имя файла.
Это дополнение позволяет NVDA объявлять имя файла перед его путем.
Опция «Объявлять имя файла перед его путём» в группе параметров «Имя документа» в категории «Параметры» активирует или деактивирует эту операцию.
Может быть неприятно слышать все обратные слеши в пути к файлу при прокрутке списка открытых вкладок.
Поэтому это дополнение позволяет сделать их безмолвными.
Опция «Не произносить обратные слеши в пути» в группе «Имя документа» категории активирует или деактивирует эту операцию.
В своём меню «Файл» Notepad++ предлагает подменю «Открыть папку как рабочее пространство» или «Папка как рабочее пространство» в подменю «Открыть папку с файлом».
При активации одного из этих подменю курсор перемещается в диалоговое окно, где находится дерево файлов.
Дополнение предоставляет скрипт для более быстрого туда попадания.
Этот скрипт описан: «Документ: открыть папку текущего файла как рабочее пространство».
Он запускается с помощью жеста ввода «KEY_FolderAsWorkSpace».
Когда курсор находится в этой древовидной структуре, сочетание клавиш Notepad++ «F8» позволяет вернуться в область редактирования текущего документа.
Дополнение устанавливает два скрипта для перехода к строкам, оканчивающимся пробелом или табуляцией:
Если строка найдена, курсор устанавливается в начало строки, и строка объявляется.
Дополнение устанавливает два скрипта для поиска строк, состоящих только из пробелов или табуляций:
В Notepad++ есть правило, которое можно использовать для проверки длины строки. Однако эта функция не является доступной и не имеет смысла для незрячих пользователей.
Поэтому в этом дополнении есть индикатор слишком длинной строки, который подаёт звуковой сигнал, когда строка длиннее указанного количества символов.
Есть два решения для активации или деактивации сообщения о слишком длинных строках:
Когда функция включена, вы услышите звуковой сигнал:
Чтобы перейти к первому переполняющему символу на текущей строке, можно использовать жест ввода «windows+control+o».+++ Поиск слишком длинных строк +++ Дополнение устанавливает два скрипта для перехода к слишком длинным строкам.
Используя жест ввода «windows+control+i», NVDA объявит следующую информацию:
NVDA уже предлагает возможность объявления номера и отступа строки.
Для номеров строк необходимо настроить глобальный жест ввода, а если вы хотите, чтобы настройка этой функции применялась только к Notepad++, вам также необходимо связать с этим приложением профиль конфигурации.
Что касается отступа строк, объявление происходит в виде «табуляция» или «пробел». Дополнение предлагает другое объявление.
Для пользователей, которые хотят сохранить работу NVDA, предусмотрена опция «Позволить NVDA объявлять номер и отступ строк».
Вам просто нужно установить этот флажок, чтобы восстановить нормальную работу NVDA.
По умолчанию этот флажок не установлен.
Скрипт «Активировать/деактивировать управление объявлением номера и отступа строк дополнением», без жеста ввода, позволяет переключить эту опцию. Можно назначить жест ввода с помощью диалогового окна NVDA «жесты ввода».
Когда этот флажок установлен, невозможно изменить параметры, относящиеся к объявлению номера и отступа строк, и связанные скрипты больше не работают.
+++ Объявление номера строки +++ [HDR_ReportLigneNumber] Дополнение устанавливает скрипт «Включить/отключить объявление номера строки» для объявления номеров строк.
Этот скрипт запускается жестом ввода «windows+control+F5» и циклически переключается между следующими двумя вариантами:
Выбор сохраняется в конфигурации дополнения и восстанавливается при перезапуске дополнения.
Эта функция используется для объявления отступа строки в определённом стиле.
Для этого должен быть установлен флажок «Объявлять отступ строки» в категории «Параметры».
Скрипт «Активировать/деактивировать объявление отступа строки» (жест ввода «windows+alt+F6») позволяет переключить эту опцию.
Когда опция отмечена, отступ строки объявляется в соответствии с выбранным стилем.
В противном случае строка объявляется без начальных пробелов или табуляций. Выбор сохраняется в конфигурации дополнения и восстанавливается при перезапуске дополнения.
Возможные варианты для этого стиля:
Чтобы настроить этот стиль, есть два решения:
Когда выбран один из двух последних стилей, смесь пробелов и табуляций в отступе сигнализируется голосом.
На сегодняшний день символ «табуляция» учитывается для оценки уровня. Поэтому строка с отступом из пробелов будет помечена как имеющая неизвестный уровень отступа.
Выбор сохраняется в конфигурации дополнения и восстанавливается при перезапуске дополнения.
Следующие жесты ввода используются для определения отступа строки:
Эти жесты ввода можно изменить с помощью диалогового окна NVDA «Жесты ввода». В частности, для изменения «control + ²», который специфичен для клавиатуры Azerty. Клавиша «²» — это самая левая клавиша буквенно-цифрового ряда на этом типе клавиатуры.
Это дополнение позволяет NVDA объявлять позицию курсора после использования клавиши «Home», то есть либо в начале строки, либо после отступа.
Эта функция, активированная по умолчанию, может быть деактивирована с помощью опции «Сообщать позицию курсора после нажатия home» в категории «Строка».
Когда текст окна редактирования является кодом Python, его можно импортировать с помощью жеста ввода «windows+control+F7».
Результат импорта объявляется.
В случае ошибки импорта курсор устанавливается на соответствующую строку.
Жест команды «windows+control+F8» открывает диалоговое окно «Предварительный просмотр документа».
Это диалоговое окно представляет:
Нажатие кнопки «Предварительный просмотр» запускает компиляцию и отображение результата.
Выбранные варианты запоминаются до остановки NVDA.
Двойное нажатие жеста команды позволяет просмотреть документ напрямую, без прохождения через диалоговое окно, используя последние сохранённые варианты.
Для отображения дополнение использует временный файл. Этот файл помещается в папку, где находится документ, или в папку конфигурации пользователя, если этот документ ещё не сохранён. Он удаляется через минуту после создания.
За исключением просмотра в окне NVDA в режиме навигации, можно установить заголовок дополнения по умолчанию. Этот заголовок использует файлы стилей документа дополнения. Они копируются в то же место, что и временный файл, и удаляются вместе с временным файлом.
Дополнение настраивает режим навигации для перемещения от элемента к элементу в документах markdown или txt2tags.
Затронутые элементы:
Чтобы активировать его, нажмите «NVDA + пробел».
Возможные команды:
Этот модуль расширения содержит проверку орфографии для Notepad++.
Смотрите здесь для получения дополнительной информации:
Для французского сообщества:
После установки подменю «DSpellCheck» появляется в меню «Плагины» в строке меню Notepad++.
Автоматическое обнаружение орфографических ошибок активируется или деактивируется с помощью подменю «Автоматически проверять орфографию в документе».
Подменю «Найти следующую орфографическую ошибку» и «Найти предыдущую орфографическую ошибку» позволяют перейти соответственно к следующей или предыдущей ошибке.
Затем используется всплывающее меню для её исправления.
Ошибки отмечены красным цветом в тексте, но NVDA не обозначает цвета в Notepad++.
Это дополнение пытается сигнализировать о них звуком при перемещении по строкам.
Пожалуйста, обратите внимание, что это совершенно экспериментальная функция и на сегодняшний день она не полностью работоспособна. Она может не работать в некоторых случаях, например, с файлами с расширением «t2t», которые необходимо изменить на «txt», чтобы DSpellCheck нашёл ошибки.
Для дополнения основная проблема с DSpellCheck заключается в том, как получить обнаруженные им орфографические ошибки, чтобы узнать, есть ли ошибка в строке под курсором.
В отсутствие известного API единственным возможным решением является использование буфера обмена и запрос DSpellCheck скопировать туда все найденные ошибки.
Подменю DSpellCheck «Копировать все слова с ошибками в буфер обмена» позволяет это сделать.
Это подменю должно активироваться дополнением каждый раз при изменении строки с помощью стрелки вверх или вниз. Для больших документов с большим количеством ошибок это может вызвать задержку, которая может быть неприятной.
Чтобы активировать это подменю, дополнение использует сочетание клавиш «control+shift+alt+пробел».
Но это сочетание клавиш не определено по умолчанию, и его необходимо настроить в Notepad++ для работы дополнения.
Откройте диалоговое окно «менеджер сочетаний клавиш» и перейдите на вкладку «команды плагинов». В поле фильтра введите «copy all» и нажмите кнопку «изменить».
Затем отметьте «Ctrl», «Shift», «Alt» и выберите клавишу «пробел» из списка. Подтвердите «ОК». Наконец, закройте диалоговое окно.
Дополнение устанавливает скрипт «Активировать или деактивировать сообщение об орфографических ошибках», без жеста ввода, чтобы указывать на ошибки или нет, когда курсор попадает на строку текста после перемещения стрелкой вверх или вниз. Этот скрипт отображается в диалоговом окне «Жесты ввода» в категории «Текстовый редактор Notepad++: улучшения доступности», и ему может быть назначен жест ввода.
Если звук воспроизводится, поместите курсор в начало строки и активируйте подменю «Найти следующую орфографическую ошибку», чтобы перейти к первой ошибке в строке и исправить её.
По умолчанию обновление дополнения выполняется автоматически вскоре после запуска NVDA (от 20 до 600 секунд) и не чаще одного раза в день. Вы можете отключить это обновление, сняв флажок «Автоматически проверять наличие обновлений» в настройках дополнения, пункт меню «Обновление». Версия дополнения может быть:
По умолчанию стабильная версия обновляется до более новой стабильной версии (с бо́льшим номером версии). Но можно обновить текущую стабильную версию до версии для разработчиков следующей стабильной версии. Для этого достаточно установить флажок «Также обновлять стабильные версии до версий для разработчиков» в настройках дополнения, пункт меню «Обновление».
Версия для разработчиков обновляется:
Кнопка «Проверить наличие обновлений» в настройках дополнения, пункт меню «Обновление», позволяет немедленно выполнить поиск обновления.
Кнопка «Просмотреть историю», расположенная в той же категории, позволяет отобразить историю текущей версии в браузере.
В случае автоматического обновления, если обнаружена новая версия, отображается диалоговое окно «Обновление», которое предлагает:
В случае обновления до стабильной версии кнопка «Что нового» предоставляет возможность открыть в браузере историю дополнения и, таким образом, узнать о новых возможностях предлагаемой версии.
История версий этого дополнения находится в файле: «changes.html»