URL: https://github.com/paulber19/notepadPlusPlusAccessEnhancementNVDAAddon.git
Téléchargement:
Compatibilité:
Traducteur (s): auteur de l'extension
Cette extension a pour objectif d'améliorer l'accessibilité de l'éditeur de texte Notepad++ et ajouter des fonctionnalités pour faciliter l'édition de fichiers utilisés en langage Python et des fichiers écrit en langage markdown.
Elle reprend la plupart des compléments apportées par l'extension NVDA_notepadPlusPlus créé par Derek Riemer et Tuukka Ojala, puis modifiée par Robert Hänggi et Andre9642, à savoir:
Et elle apporte les compléments suivants:
Compléments pour les fichiers Python:
Compléments pour les fichiers Markdown ou txt2tags:
Compléments pour le module d'extension DSpellCheck de Notepad++:
Cette extension a été testé avec Notepad++ version 8.9.2 et 8.8.3 64 bits.
Cette extension utilise et intercepte les raccourcis de Notepad++ configuré par défaut. Il est donc vivement conseillé, pour son bon fonctionnement, de ne pas modifier ces raccourcis.
La plupart des gestes de commande amenés par cette extension sont modifiable à l'aide du dialogue "Gestes de commande" de NVDA.
Notepad++ permet de définir des signets dans votre texte.
Un signet vous permet de revenir rapidement sur une ligne dans l’éditeur à n’importe quel moment.
Pour définir un signet, positionnez le curseur sur la ligne que vous souhaitez mettre en signet et appuyez sur "control+f2" (raccourci Notepad++ à ne pas modifier).
Puis, lorsque vous souhaitez revenir sur ce signet, appuyer sur "F2" pour aller au signet suivant, ou "majuscule+F2" pour revenir au Signet précédent (raccourcis Notepad++ à ne pas modifier).
Vous pouvez définir autant de signets que vous souhaitez.
Pour annuler un signet, déplacez le curseur sur la ligne marqué par le signet et tapez "control+f2".
Vous pouvez annuler tous les signets en utilisant le sous-menu "Enlever tous les signets" du sous-menu "Signets" du sous-menu "Recherche".
NVDA restant muet lors de l'arrivée du curseur sur un signet, l'extension corrige ce problème en annonçant la ligne.
Dans le document, vous pouvez vous déplacer au délimiteur symétrique en appuyant sur "control+b" (raccourci NotePad++ à ne pas modifier).
Pour cela, le curseur doit être positionné sur un caractère délimiteur du style accolade, parenthèse, crochet, auquel le délimiteur symétrique devra correspondre.
Lorsque vous appuyez sur cette commande, l'extension permettra à NVDA de lire la ligne sur laquelle vous avez atterri, et si la ligne se compose uniquement du caractère délimiteur symétrique, il lira la ligne au-dessus et au-dessous de ce délimiteur afin d'avoir une idée du contexte.
La fonctionnalité de la saisie automatique de Notepad++ n'est pas accessible par défaut. La saisie automatique a de nombreux problèmes, y compris qu'elle s'affiche dans une fenêtre flottante.
Pour rendre cette fonctionnalité accessible, trois choses à faire.
Remarque: tout le texte est affiché en braille si un afficheur braille est connecté. Cette fonctionnalité est actuellement expérimentale, n'hésitez pas à signaler toute erreur.
L'une des caractéristiques les plus intéressantes de notepad++ est la possibilité d'utiliser la recherche incrémentielle.
La recherche incrémentielle est un mode de recherche dans lequel vous recherchez une phrase-test en tapant dans le champ d'édition, et le document se déplace en vous montrant la recherche en temps réel.
Pendant que vous tapez, le document se déplace pour afficher la ligne de texte avec la phrase la plus probable que vous recherchez. Il met également en évidence le texte qui correspond.
Le programme vous indique également combien de correspondances ont été détectées. Il y a des boutons pour se déplacer à la correspondance suivante et précédente.
Au fur et à mesure que vous tapez, NVDA annoncera la ligne de texte que notepad++ a détectée dans les résultats de la recherche. NVDA annonce également le nombre de correspondances, mais uniquement si le nombre de correspondances a changé.
Lorsque vous avez trouvé la ligne de texte que vous voulez, il suffit d'appuyer sur "Echap", et cette ligne de texte sera sur votre curseur.
Pour lancer cette boîte de dialogue, sélectionnez "Recherche Incrémentielle" dans le menu "Recherche", ou appuyez sur "alt+control+i".
Par défaut, si vous tapez "control+f" vous ouvrez la boîte de dialogue de recherche.
Si vous tapez du texte dans sa zone d'édition et appuyez sur "Entrée", le texte dans la fenêtre est sélectionné et le focus est déplacé vers le résultat de recherche suivant. La fenêtre reste ouverte et il faut la fermer avec la touche "Échapp".
Vous pouvez alors appuyer sur "F3" ou "majuscule+F3" pour répéter la recherche dans la direction vers l'avant ou vers l'arrière respectivement.
NVDA restant muet dans ce cas, l'extension permettra à NVDA de lire la ligne courante et la sélection dans la ligne qui représente le texte trouvé.
Cette fonctionnalité permet de faire une simple et rapide comparaison entre le texte sélectionné et celui du presse-papier.
Après avoir sélectionné le texte, utilisez le geste de commande "windows+control+F2".
Le résultat est affiché dans une boite de dialogue.
Notepad++ affiche, dans le titre de la fenêtre d'édition et dans la liste des onglets, le nom du fichier précédé par son chemin absolu.
Ce chemin peut être très long et assez fatigant à entendre.
Dans les préférences de Notepad++, il est possible de faire afficher dans le titre de la fenêtre d'édition, seulement le nom du fichier, mais cela ne concerne pas la liste des onglets que l'on atteint par "control+tab" en gardant la touche "control" enfoncé.
Ce complément permet donc d'annoncer de manière plus réduite le titre de la fenêtre d'édition et les noms des éléments dans la liste des onglets, en réduisant le chemin des fichiers, voire même en le supprimant complètement.
La catégorie "Options" des paramètres de l'extension présente le groupe de paramètres "Annonce réduite du chemin des fichiers" pour contrôler cette fonctionnalité.
L'option "Réduire le chemin" permet d'activer ou désactiver l'annonce réduite du chemin.
Elle n'est pas activée par défaut.
Quand cette option est activée, le chemin du fichier est réduit en fonction du niveau configuré dans le choix "Niveau hiérarchique antécédents à conserver".
Ce niveau peut varier de 0 à 10:
Si le niveau est égal à 0, seul le nom du fichier est annoncé.
Pour un niveau égal à -1, le chemin du fichier est annoncé sous la forme:
"lettre du lecteur:\...\dossier hiérarchique -1\nom du fichier"
Pour un niveau égal à -2, cela sera:
"lettre du lecteur:\...\dossier niveau hiérarchique -2\dossier hiérarchique -1\nom du fichier"
Si le nombre de niveaux hiérarchiques du chemin est plus petit que le niveau configuré, le chemin reste inchangé.
Notepad++ affiche le nom du document dans le titre de la fenêtre d'édition ou dans la liste des onglets présentée par "control+tab" et "control", sous la forme: chemin du fichier suivi du nom du fichier.
Ce complément permet de faire annoncer par NVDA le nom du fichier avant son chemin.
L'option "Annoncer le nom du fichier avant son chemin" du groupe de paramètres "Nom des documents" de la catégorie "Options" active ou désactive ce fonctionnement.
Il peut sembler pénible d'entendre toutes les barres obliques inversées du chemin du fichier quand on déroule la liste des onglets ouverts.
Ce complément permet donc de les rendre muettes.
L'option "Ne pas dire les barres obliques inversées du chemin" du groupe "Nom des documents" de la catégorie active ou désactive ce fonctionnement.
Dans son menu "Fichier", Notepad++ propose le sous-menu "Ouvrir le dossier en tant qu’espace de travail" ou le sous-menu "Ouvrir le répertoire du fichier en cours" et dans lequel nous trouvons le sous-menu "Dossier en tant qu'espace de travail".
En activant l'un ou l'autre de ces sous-menus, le curseur est amené dans un dialogue où se trouve une arborescence de fichiers.
L'extension apporte un script pour y arriver plus rapidement. Ce script a pour description: "Document: Ouvrir le dossier du fichier courant en tant qu'espace de travail".
Il se lance à l'aide du geste de commande "KEY_FolderAsWorkSpace".
Quand le curseur est dans cette arborescence, le raccourci "f8" de Notepad++ permet de revenir dans la zone d'édition du document courant.
L'extension installe deux scripts pour se déplacer aux lignes se terminant par un espace ou une tabulation:
Si une ligne est trouvée, le curseur est positionné en début de ligne et la ligne est annoncée.
L'extension installe deux scripts pour rechercher les lignes se composant uniquement d'espaces ou de tabulations:
Notepad++ a une règle qui peut être utilisée pour vérifier la longueur d'une ligne. Cependant, cette fonctionnalité n’est ni accessible ni significative pour les utilisateurs non-voyants.
Par conséquent, cette extension dispose d'un indicateur de ligne trop longue qui déclenche un bip lorsqu'une ligne est plus longue que le nombre de caractères spécifié.
Pour activer ou désactiver le signalement des lignes trop longues, deux solutions:
Lorsque la fonctionnalité est activée, vous entendrez un bip:
Pour aller jusqu’au premier caractère débordant sur la ligne courante, vous pouvez utiliser le geste de commande "windows+control+o".
L'extension installe deux scripts pour atteindre les lignes trop longues.
En utilisant le geste de commande "windows+control+i", NVDA annoncera les informations suivantes:
NVDA offre déjà la possibilité de faire annoncer le numéro et le retrait de la ligne.
Pour les numéros de ligne, il faut configurer un geste de commande global et si l'on veut que la configuration de cette fonctionnalité ne s'applique qu'à Notepad++, il faut aussi associer un profil de configuration à cette application.
Quant au retrait des lignes, l'annonce se fait en "tab" ou "espace". L'extension propose une annonce différente.
Pour les utilisateurs qui désirent conserver le fonctionnement de NVDA, l'option "Laisser NVDA annoncer le numéro et le retrait des lignes" est prévue.
Il suffit de cocher cette option pour retrouver le fonctionnement normal de NVDA.
Par défaut, cette option n'est pas cochée.
Le script "Activer/Désactiver la gestion de l'annonce du numéro et du retrait des lignes par l'extension", sans geste de commande, permet de basculer cette option. Il est possible de lui associer un geste de commande à l'aide du dialogue "Gestes de commande" de NVDA.
Quand cette option est cochée, il n'est plus possible de modifier les paramètres relatifs à l'annonce du numéro et du retrait des lignes et les scripts associés ne sont plus fonctionnels.
L'extension installe le script "Activer/désactiver l'annonce des numéros de ligne" pour faire annoncer les numéros de ligne.
Ce script se déclenche par le geste de commande "windows+control+F5" et boucle entre les deux choix suivants:
Le choix est sauvegarder dans la configuration de l'extension et repositionner lors du redémarrage de l'extension.
Cette fonctionnalité permet de faire annoncer le retrait de la ligne sous un style à définir.
Pour cela, l'option "Annoncer le retrait de la ligne" de la catégorie "Options" doit être cochée.
Le script "Activer/désactiver l'annonce du retrait de la ligne" (geste de commande "windows+alt+F6"), permet de basculer cette option.
Quand l'option est cochée, le retrait de la ligne est annoncé suivant le choix de style sélectionné.
Sinon, la ligne est annoncée sans les espaces ou tabulation de début de ligne.
Le choix est sauvegarder dans la configuration de l'extension et repositionner lors du redémarrage de l'extension.
Les choix possible pour Ce style sont:
Pour configurer ce style, deux solutions:
Quand l'un des deux derniers styles est choisi, le mélange d'espace et de tabulation dans l'indentation est signalé vocalement.
Seul aujourd'hui, le caractère "tab" est pris en compte pour évaluer le niveau. Par conséquence, une ligne ayant une indentation avec des espaces sera signalée comme ayant un niveau d'indentation inconnu.
Le choix est sauvegarder dans la configuration de l'extension et repositionner lors du redémarrage de l'extension.
Les gestes de commandes suivants permettent de définir le retrait d'une ligne:
Ces gestes de commandes sont modifiables à l'aide du dialogue "Gestes de commandes" de NVDA. En particulier pour modifier "control+²" qui est spécifique au clavier azerty. La touche "²" étant la touche la plus à gauche de la rangé alphanumériques de ce type de clavier.
Ce complément permet de faire annoncer par NVDA la position du curseur après l'utilisation de la touche "Début", c'est à dire soit en début de ligne, soit après l'indentation.
Cette fonctionnalité, activé par défaut, pe être désactivé avec l'option "Annoncer la position du curseur après l'appui sur la touche début" de la catégorie "Ligne".
Cette extension offre la possibilité de se déplacer de class en class ou de méthode en méthode dans un fichier contenant du code python.
Elle apporte les scripts suivants:
Lorsque le texte de la fenêtre d'édition est du code Python, il est possible de l'importer à l'aide du geste de commande "windows+control+F7".
Le résultat de l'importation est annoncé.
Dans le cas d'une erreur d'importation, le curseur est positionné sur la ligne concernée.
L'extension offre la possibilité de visualiser le résultat HTML de la compilation du texte d'un simple document par Markdown ou txt2tags.
Le document généré peut être visualiser avec :
Le geste de commande "windows+control+F8" ouvre le dialogue "Prévisualisation du document".
Ce dialogue présente :
L'appui sur le bouton "Prévisualiser" lance la compilation et l'affichage du résultat.
Les choix sélectionnés sont mémorisés jusqu'à l'arrêt de NVDA.
Un double appui du geste de commande permet de visualiser directement le document sans passer par le dialogue en utilisant les derniers choix mémorisés.
Pour visualiser, l'extension utilise un fichier temporaire. Ce fichier est placé dans le dossier où se trouve le document ou le dossier de la configuration utilisateur si ce document n'est pas encore enregistré. Il est effacé une minute après avoir été créé.
Sauf pour la visualisation dans une fenêtre NVDA en mode navigation, il est possible de mettre l'en-tête par défaut de l'extension. Cette en-tête utilise les fichiers de style des documents de l'extension. Ceux-ci sont copiés au même endroit que le fichier temporaire et effacés comme le fichier temporaire.
L'extension met en place le mode navigation pour se déplacer d'élément en élément dans les documents markdown ou txt2tag.
Les éléments concernés sont:
Pour l'activer, tapez "NVDA+espace".
Les commandes possibles sont alors:
Ce module d'extension contient un correcteur orthographique pour Notepad++.
Voir ici pour plus d'informations:
Pour la communauté française:
Une fois installé, le sous-menu "DSpellCheck" apparait sous le menu "Modules d'extension" de la barre de menu de Notepad++.
La détection automatique des fautes d'orthographes s'active ou désactive à l'aide du sous-menu "Spell Check Document Automatically".
Les sous-menus "Find Next Misspelling" et "Find previous Misspelling" permettent d'aller sélectionner la prochaine ou précédente fautes respectivement.
Le menu contextuel permet alors de la corriger.
Les fautes sont marquées en rouge dans le texte, mais NVDA ne signale pas les couleurs dans Notepad++.
Ce complément tente de les signaler par un son lors de déplacement ligne par ligne.
Attention, c'est une fonctionnalité totalement expérimentale et n'est pas complètement opérationnelle à ce jour. Elle peut ne pas marcher dans certain cas, comme par exemple avec les fichiers avec l'extension "t2t" et qu'il faut changer en "txt" pour que DSpellCheck trouve les fautes.
Pour le complément, le problème essentiel avec DSpellCheck, c'est comment récupérer les fautes d'orthographe qu'il a détectées afin de savoir s'il y en a une sur la ligne sous le curseur.
En l'absence d'API connu, la seule solution possible est d'utiliser le presse-papier et de demander à DSpellCheck d'y copier toutes les fautes trouvées.
Le sous-menu "Copy All Misspelled Words to Clipboard" de DSpellCheck le permet.
Ce sous-menu doit être activé par le complément à chaque changement de ligne par flèche haut ou bas. Pour des documents importants et avec un grand nombre de fautes, cela peut induire un délai qui peut être gênant.
Pour activer ce sous-menu, le complément utilise le raccourci "contrôle+shift+alt+espace".
Mais ce raccourci n'est pas défini par défaut et il faut le configurer dans Notepad++ pour que le complément marche.
Ouvrir le dialogue " gestionnaire de raccourcis clavier" et aller dans l'onglet " commandes de plugins". Dans le filtre taper "copy all" et appuyer sur le bouton "modifier.
Puis cocher "Ctrl", "shift", "Alt" et sélectionner dans la liste la touche "spacebar". Valider par "OK" Enfin fermer le dialogue.
Le complément installe le script "Activer ou désactiver le signalement des fautes d'orthographe ", sans geste de commande, pour signaler ou non les fautes quand le curseur arrive sur une ligne de texte suite à un déplacement par flèche haut ou bas. Ce script apparaît dans le dialogue "Gestes de commande" sous la catégorie "Éditeur de texte Notepad++: compléments d'accessibilité " et un geste de commande peut lui être assigné.
Si le son est joué, placer le curseur au début de la ligne et activer le sous-menu "Find Next Misspelling" pour aller à la première faute sur la ligne et la corriger.
Ce dialogue s'affiche lorsque le raccourci "Alt+d" suivi de "d" est tapé, ce qui correspond au menu "Documents" et à son sous-menu "Documents...".
Il présente la liste des documents ouverts.
Pour chaque fichier, le nom du fichier est suivi de trois informations: son chemin, son type, sa taille.
À l'ouverture du dialogue, l'extension empêche que le fichier sélectionné soit annoncé plusieurs fois.
Le chemin sera annoncé sous une forme plus réduite suivant l'option "Réduire le chemin", c'est à dire en n'annonçant pas tous les niveaux de la hiérarchie des dossiers (Voir le chapitre "Arrangement du chemin").
Par exemple, le chemin:
"F:\documents\temp\nvda 2023.1 beta\userConfig\addons\notepadPlusPlusAccessEnhancement\doc\fr\" sera annoncer comme ceci en gardant les 3 derniers niveaux:
"F:\...\notepadPlusPlusAccessEnhancement\doc\fr\"
Le nombre de niveaux à conserver est configurable (voir le chapitre "Arrangement du chemin")
Par configuration, chaque information associée au fichier peut ne pas être annoncée (voir le groupe "Dialogue Documents" de la catégorie "Général" des paramètres de l'extension). Par défaut, elles sont toutes annoncées.
La mise à jour de l'extension se fait, par défaut, automatiquement peu de temps après le démarrage de NVDA (entre 20 et 600 secondes) et au maximum une fois par jour. Il est possible de désactiver cette mise à jour en décochant l'option "Rechercher automatiquement les mises à jour" se trouvant dans les paramètres de l'extension, élément de menu "Mise à jour". La version de l'extension peut être:
Par défaut, une version stable est mise à jour avec une version stable plus récente (numéro de version supérieur). Mais il est possible de mettre à jour la version stable courante avec une version de développement de la prochaine version stable. Il suffit de cocher l'option "Mettre aussi à jour les versions stable vers les versions de développement " situé dans les paramètres de l'extension, élément de menu "Mise à jour".
Une version de développement est mise à jour:
Le bouton "Rechercher une mise à jour" placé dans les paramètres de l'extension, élément de menu "Mise à jour", permet de rechercher immédiatement une mise à jour.
Le bouton "Voir l'historique", placé dans cette même catégorie, vous permet d'afficher l'historique de la version actuelle dans le navigateur.
Dans le cas d'une mise à jour automatique et si une nouvelle version est détectée, la boite de dialogue "Mise à jour" s'affiche pour proposer:
Dans le cas d'une mise à jour vers une version stable, le bouton "Quoi de neuf" offre la possibilité d'ouvrir, dans le navigateur, l'historique de l'extension et ainsi pouvoir connaître les nouveautés de la version proposée.
L'historique des versions de cette extension est dans le fichier "changes.html"