[script nvda] Re: aide contextuel

  • From: "cyrille.bougot2" <dmarc-noreply@xxxxxxxxxxxxx> ("cyrille.bougot2")
  • To: script NVDA <scriptnvda@xxxxxxxxxxxxx>
  • Date: Wed, 8 Jun 2022 18:26:39 +0200 (CEST)

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 !


 

Other related posts: