Exigences pour la soumission d'extensions

Pour soumettre une nouvelle extension ou une nouvelle version d'une extension incluse sur le site Web :

• Hébergez-la, idéalement sur GitHub, le modèle d'extension facilite cela.
• Suivez le processus pour ajouter une nouvelle version d'extension NVDA, expliquée sur addon-datastore submission guide, sous la section Submitting an add-on version.

Pour ajouter ou mettre à jour la page Web de votre extension :

• Demandez une invitation sur la liste de diffusion pour la traduction. Vous devez le faire même si l'extension n'a pas besoin de traductions à ce stade.
• Suivez les instructions pour télécharger le dépôt. Vous pouvez faire seulement un checkout du site Web en ajoutant "/website" à l'URL pour modifier la documentation des extensions.

• Sous le sous-dossier addons, ajoutez un fichier nomDuDepotDeLExtension.mdwn. Assurez-vous qu'il contient un titre et des balises telles que dev, stable ou legacy, afin que la page Web puisse être affichée dans les sections correspondantes du site Web. Les exemples suivants peuvent être utiles :

  • access8math.mdwn, avec les balises dev et stable.
  • AudioThemes.mdwn, avec la balise dev.
  • teamViewer.mdwn, avec la balise legacy.

• Soyez attentifs à la syntaxe markdown :

  • Utilisez des astérisques suivis d'un espace, et non des tirets, pour les listes. Les tirets sont autorisés sur Github et sur le site Web, mais uniquement en anglais. Lorsque la documentation est convertie en fichiers .po, l'utilisation de tirets ne divise pas la liste en éléments souhaités.
  • Si les URL ne sont pas trop longues, utilisez le style "référence" pour les liens, c'est-à-dire incluez les URL correspondantes au bas du fichier, avec une ligne vide entre les URL et une ligne vide à la fin du fichier.
  • Essayez d'utiliser des paragraphes courts, des listes et des titres de niveau 2 ou 3, pour obtenir une bonne structure et une documentation compréhensible.
  • Pour les listes imbriquées, placez une ligne vide avant le premier sous-élément et après le dernier, et utilisez quatre espaces pour l'indentation.

• Si vous souhaitez gérer les traductions de votre extension via le système de traduction de NVDA, demandez-le sur la liste de diffusion des extensions.

https://github.com/nvaccess/addon-datastore/blob/master/docs/submitters/submissionGuide.md