URL: https://github.com/paulber19/notepadPlusPlusAccessEnhancementNVDAAddon.git
Download:
Compatibility:
Traducteur (s): automatic translator
This add-on aims to improve the accessibility of the Notepad++ text editor and add features to facilitate editing of files used in Python language and files written in markdown language.
It incorporates most of the additions provided by the NVDA_notepadPlusPlus add-on created by Derek Riemer and Tuukka Ojala, then modified by Robert Hänggi and Andre9642, namely:
And it brings the following complements:
For lines:
Add for Python files #hdr_Python Python:
Adds for Markdown or txt2tags files:
Add for DSpellCheck Notepad++ plugin:
This add-on has been tested with Notepad++ version 8.9.2 and 8.8.3 64 bits.
This add-on uses and intercepts the Notepad++ shortcuts configured by default. It is therefore strongly recommended, for its proper functioning, not to modify these shortcuts.
Most of the input gestures brought by this add-on are modifiable using the NVDA "Input gestures" dialog.
In the document, you can move to the symmetric delimiter by pressing "control + b" (NotePad++ shortcut not to be modified).
To do this, the cursor must be positioned on a delimiter character of the brace, parenthesis, bracket style, to which the symmetric delimiter must correspond.
When you press this command, the add-on will allow NVDA to read the line you landed on, and if the line consists only of the symmetric delimiter character, it will read the line above and below that delimiter so to get an idea of the context.
Notepad++ autofill functionality is not available by default. Autofill has many issues, including showing it in a floating window.
To make this functionality accessible, three things must be done.
Note: All text is displayed in Braille if a Braille display is connected. This feature is currently experimental, so please report any errors.
One of the coolest features of notepad++ is the ability to use incremental search.
Incremental search is a search mode in which you search for a test phrase by typing in the edit field, and the document moves around showing you the search in real time.
As you type, the document moves to display the line of text with the most likely phrase you are looking for. It also highlights the text that matches.
The program also tells you how many matches have been detected. There are buttons to move to the next and previous match.
As you type, NVDA will announce the line of text notepad++ found in the search results. NVDA also announces the number of matches, but only if the number of matches has changed.When you have found the line of text you want, just press "Esc", and that line of text will be on your cursor.
To launch this dialog box, select "Incremental Search" from the "Search" menu, or press "alt + control + i".
By default, if you type "control + f" you open the search dialog box.
If you type some text in its edit box and press "Enter", the text in the window is selected and the focus is moved to the next search result. The window remains open and it must be closed with the "Escape" key.
You can then press "F3" or "Shift + F3" to repeat the search in the forward or backward direction respectively.
NVDA remaining silent in this case, the add-on will allow NVDA to read the current line and the selection in the line which represents the found text.
++ Text comparison ++ [HDR_Compare] This feature allows you to make a quick and easy comparison between the selected text and that on the clipboard.
After selecting the text, use the "windows+control+F2" input gesture.
The result is displayed in a dialog box.
Notepad++ displays, in the title of the edit window and in the list of tabs, the name of the file preceded by its absolute path.
This path can be very long and quite tiring to hear.
In the preferences of Notepad++, it is possible to display in the title of the editing window, only the name of the file, but this does not concern the list of tabs that can be reached by "control + tab" while keeping the "control" key pressed.
This supplement therefore makes it possible to announce in a smaller way the title of the editing window and the names of the elements in the list of tabs, by reducing the path of the files, or even by deleting it completely.
The "Options" category of the add-on settings presents the "Minimized file path advertisement" group of settings to control this functionality.
The "Reduce path" option allows you to activate or deactivate the reduced route announcement.
It is not enabled by default.
When this option is activated, the file path is reduced according to the level configured in the choice "Antecedents hierarchical level to keep".
This level can vary from 0 to 10:
If the level is 0, only the name of the file is announced.
For a level equal to -1, the file path is announced in the form:
"drive letter: \ ... \ hierarchical folder -1 \ filename"
For a level equal to -2, this will be:
"drive letter: \ ...\ hierarchical level folder -2 \ hierarchical folder -1 \ filename "
If the number of hierarchical levels in the path is smaller than the configured level, the path remains unchanged.
Notepad++ displays the name of the document in the title of the editing window or in the list of tabs presented by "control + tab" and "control", in the form: path of the file followed by the name of the file.
This add-in allows NVDA to announce the name of the file before its path.
The option "Announce the name of the file before its path" in the "Document name" parameter group in the "Options" category activates or deactivates this operation.
It may seem annoying to hear all the backslashes in the file path when scrolling through the list of open tabs.
This supplement therefore makes it possible to make them silent.
The option "Do not say backslashes in the path" in the "Document name" group of the category activates or deactivates this operation.
In its "File" menu, Notepad ++ offers the "Open Folder as Workspace" submenu or "Folder as Workspace " in "Open Containing Folder " sub-menu.
By activating one of thes sub-menus, the cursor is move to a dialogue where a file tree is located.
The add-on brings a script to get there faster.
This script is described: "Document: Open the folder of the current file as a workspace".
He launches using the "windows+control+F9" input gesture.
When the cursor is in this tree structure, the "F8" shortcut of Notepad ++ allows you to return to the edition area of the current document.
The add-on installs two scripts to move to lines ending in a space or a tab:
If a line is found, the cursor is positioned at the start of the line and the line is announced.
The add-on installs two scripts to find lines consisting only of spaces or tabs:
Notepad++ has a rule that can be used to check the length of a line. However, this feature is neither accessible nor meaningful for blind users.
Therefore, this add-on has an too long line indicator that triggers a beep when a line is longer than the specified number of characters.
There are two solutions to activate or deactivate the reporting of lines that are too long:
When the feature is enabled, you will hear a beep:
To go to the first overflowing character on the current line, you can use the "windows+control+o" input gesture.+++ Finding lines that are too long +++ The add-on installs two scripts to reach too long lines.
Using the "windows+control+i" input gesture, NVDA will announce the following information:
NVDA already offers the possibility of announcing the number and the withdrawal of the line.
For line numbers, you must configure a global input gesture and if you want the configuration of this functionality to apply only to Notepad++, you must also associate a configuration profile with this application.
As for the withdrawal of lines, the announcement is made in "tab" or "space". The add-on offers a different ad.
For users who wish to keep NVDA running, the option "Let NVDA announce number and line removal" is provided.
All you have to do is check this option to restore NVDA to normal operation.
By default, this option is not checked.
The script "Activate / Deactivate the management of the number announcement and the withdrawal of lines by the add-on", without a input gesture, allows this option to be toggled. It is possible to associate a input gesture with it using the NVDA "input gestures" dialog.
When this option is checked, it is no longer possible to modify the parameters relating to the announcement of the number and withdrawal of lines and the associated scripts are no longer functional.
+++ Announcement of line number +++ [HDR_ReportLigneNumber] The add-on installs the "Enable / Disable Line Number Announcement" script to advertise line numbers.
This script is triggered by the "windows+control+F5" input gesture and loops between the following two choices:
The choice is to save in the configuration of the add-on and reposition when restarting the add-on.
This functionality is used to announce the indentation of the line under a style to be defined.
To do this, the "Announce line withdrawal" option in the "Options" category must be checked.
The script "Activate / deactivate the announcement of the withdrawal of the line" (input gesture "windows+alt+F6"), allows to toggle this option.
When the option is checked, the indentation of the line is announced according to the choice of style selected.
Otherwise, the line is advertised without leading-of-line spaces or tabs.The choice is to save in the configuration of the add-on and reposition when restarting the add-on.
The possible choices for This style are:
To configure this style, two solutions:
When one of the last two styles is chosen, the mixture of space and tab in the indentation is signaled vocally.
Only today, the "tab" character is taken into account to evaluate the level. Therefore, a line having an indentation with spaces will be flagged as having an unknown indentation level.
The choice is to save in the configuration of the add-on and reposition when restarting the add-on.
The following input gestures are used to define the indentation of a line:
These input gestures can be changed using the NVDA "Input Gestures" dialog. In particular to modify "control + ²" which is specific to the azerty keyboard. The "²" key being the leftmost key of the alphanumeric row of this type of keyboard.
This add-in allows NVDA to announce the cursor position after using the "Home" key, ie either at the start of the line or after the indentation.
This functionality, activated by default, can be deactivated with the option "Report cursor position after home keypress" in the "Line" category.
When the text of the edit window is Python code,it is possible to import it using the "windows+control+F7" input gesture.
The result of the import is announced.
In the event of an import error, the cursor is positioned on the line concerned.
the "windows+control+F8" command gesture opens the "Document Preview" dialog.
This dialogue presents:
Pressing the “Preview” button starts the compilation and display of the result.
The selected choices are remembered until NVDA is stopped.
Double-pressing the command gesture allows you to directly view the document without going through the dialog, using the last stored choices.
To display, the add-on uses a temporary file. This file is placed in the folder where the document is located or the user configuration folder if this document is not yet saved. It is deleted one minute after being created.
Except for viewing in an NVDA window in navigation mode, it is possible to set the default header of the add-on. This header uses the add-on's document style files. These are copied to the same location as the temporary file and deleted like the temporary file.
The add-on sets up the browse mode to move from item to item in markdown or txt2tag documents.
The elements concerned are: -title: string of characters surrounded by "+" or "#".
To activate it, type "NVDA + space".
The possible commands are:
This extension module contains a spell checker for Notepad++.
see here for more information:
For the French community:
Once installed, the "DSpellCheck" submenu appears under the "Plugins" menu in the Notepad++ menu bar.
The automatic detection of spelling errors is activated or deactivated using the "Spell Check Document Automatically" sub-menu.
The "Find Next Misspelling" and "Find previous Misspelling" sub-menus allow you to select the next or previous fault respectively.
The pop-up menu is then used to correct it.
Mistakes are marked in red in the text, but NVDA does not flag colors in Notepad++.
This add-on attempts to signal them with a sound when moving line by line.
Please note, this is a totally experimental feature and is not fully operational to date. It may not work in some cases, for example with files with the extension "t2t" and which must be changed to "txt" for DSpellCheck to find the errors.
For the add-on, the essential problem with DSpellCheck is how to retrieve the spelling errors it has detected in order to know if there is one on the line under the cursor.
In the absence of a known API, the only possible solution is to use the clipboard and ask DSpellCheck to copy all the faults found there.
The DSpellCheck's "Copy All Misspelled Words to Clipboard" submenu allows this.
This sub-menu must be activated by the add-on each time the line is changed by the up or down arrow. For important documents and with a large number of errors, this can induce a delay which can be annoying.
To activate this submenu, the add-on uses the "control+shift+alt+space" shortcut.
But this shortcut is not defined by default and it must be configured in Notepad++ for the add-on to work.
Open the "keyboard shortcut manager" dialog and go to the "plugin commands" tab. in the filter type "copy all" and press the "modify" button.
Then check "Ctrl", "shift", "alt" and select the "spacebar" key from the list. confirm with "OK" Finally close the dialog.
The add-on installs the "Activate or deactivate the reporting of spelling errors" script, without a input gesture, to indicate or not the errors when the cursor arrives on a line of text following an up or down arrow move.This script appears in the "Input Gestures" dialog under the "Notepad++ Text Editor: Accessibility enhancements" category and a input gesture can be assigned to it.
If the sound is played, place the cursor at the beginning of the line and activate the "Find Next Misspelling" sub-menu to go to the first fault on the line and correct it.
By default, the add-on update is done automatically shortly after NVDA starts up (between 20 and 600 seconds) and at most once a day. It is possible to deactivate this update by unchecking the option "Automatically check for updates" found in the add-on settings, menu item "Update". The add-on version can be:
By default, a stable version is updated to a more recent stable version (higher version number). But it is possible to update the current stable version with a development version of the next stable version. Just check the option "Also update stable versions to development versions" located in the add-on settings, menu item "Update".
A development version is updated:- with a more recent development version,
The "Check for update" button in the add-on's settings, "Update" menu item, allows you to immediately search for an update.
The "View history" button, placed in this same category, allows you to display the history of the current version in the browser.
In the case of an automatic update and if a new version is detected, the "Update" dialog box is displayed to propose:
In the case of an update to a stable version, the "What's new" button offers the possibility of opening, in the browser, the history of the add-on and thus being able to know the novelties of the proposed version.
The version history of this add-on is in the file "changes.html"