salut Cyril, et bien tu réponds tout simplement à ma question ...
vu que j'ai mis de coté tout l'aspect monkey patch, et bien je ne
pouvais pas tout comprendre.
je pensais qu'Abdel l'avait utilisé pour palier l'absence de cette
fonctionnalité dans les versions plus anciennes de NVDA.
c'est vraiment dommage qu'ils ne l'ont pas prévu pour chaque module,
d'ailleurs dans les paramètres, c'est plus rapide d'appuyer sur f1 au
lieu de retourner dans le gestionnaire des modules.
j'ai réenvoyer le mail ou Abdel en parle ...
Le 08/06/2022 à 18:26, cyrille.bougot2 (cyrille.bougot2) a écrit :
Hello
L'aide contextuelle n'est supportée par défaut que dans NVDA et pas dans les extensions.
Donc si tu utilises un SettingsPanel et que tu définis l'attribut helpId, NVDA va ouvrir le guide utilisateur de NVDA et chercher le paragraphe correspondant à ton helpId "screamer". Evidemment, ce paragraphe n'existe pas.
Probablement qu'Abdel avait rajouté un petit bout de code quelque part pour aller chercher la doc dans l'extension plutôt que la doc NVDA. Mais vu que tu ne cites pas son mail et que je ne l'ai plus, je ne pourrai pas t'en dire plus.
D'ailleurs, les listes groups.io mettent en bas des mails le lien vers la discussion sur leur site. Est-ce qu'il y aurait une option similaire à activer ici? Ca serai super pratique.
A+
Cyrille
De : "yannick"
A : scriptnvda@xxxxxxxxxxxxx
Envoyé: mercredi 8 Juin 2022 16:57
Objet : [script nvda] aide contextuel
bonjour, j'ai beau lire le message d'Abdel, je ne trouve pas mes réponses.
Sans doute que c'est la référence au monkey patch qui doit m'embrouiller
un peu ...
je lie gui.configProfiles.py
et hop, je crois avoir compris comment fonctionne l'aide contextuel :
on ajoute un attribut helpId à la sous classe gui.SettingsPanel .
je rappelle que l'on utilises cette sous classe pour ajouter un panneau
d'option à notre module dans les paramètres de NVDA.
donc j'ai en gros :
class Options(gui.SettingsPanel):
helpId = "screamer"
Aussi je m'assure que :
1. mon module comprend une aide déclaré dans le manifest.ini avec
docFileName = readme.htm
2 que le fichier existe bel et bien dans doc/fr/readme.htm
# ici il n'y a pas le fichier au format mark down, readme.md (je suppose
que pour mon test, il n'est pas utile )
il n'y a pas non plus doc/en/readme.htm
3. dans mon fichier readme.htm , il y a bien un titre de niveau 1 dont
l'id est "screamer"
pour vérifier que ma documentation est accessible, je vais même
l'appeler dans menu outils /Gestionnaire d'Extensions.
tout fonctionne, il n'y a plus qu'à essayer en vrai .
je vais donc dans mes paramètres de l'extension , je suis dans la liste
des catégories, rubrique screamer puisque c'est dans cette application
que je fais tous mes tests ...
et là j'appuie sur la touche f1.
hélas c'est le guide utilisateur qui s'ouvre,avec comme fin de lien :
#screamer"
aurait je oublié de déclarer quelque chose ?
merci !
