plugin
mini guida: come rendere i plugin compatibili con il gestore plugin di NVDA
Simone Dal Maso e Chris  su nvda,dal  10\05\2012, h. 17.22.

a partire da NVDA 2012.2beta1, molti utenti si saranno accorti che
esiste nel menu strumenti una nuova voce chiamata manage Addons, che
verr presto tradotta in italiano come Gestore Componenti Aggiuntivi, o
Gestore Plugin, vediamo.
Se si apre questa funzione, purtroppo non troveremo alcun plugin
precedentemente installato, sebbene la nostra cartella dei plugin sia,
magari, piena.
Questo perch nessuno dei plugin segue le direttive richieste per il
gestore di componenti aggiuntivi.
Tuttavia, rendere un plugin compatibile  facile, ed ora vado a spiegarlo.
Si supponga di voler rendere compatibile il driver per la barra mb408.
Il file in origine si chiama mb408.zip, comprende un leggimi, una dll, e
un file con estensione .py.
Ecco come fare:
1. Creare un file chiamato manifest.ini
2. Esso deve essere fatto nel seguente modo, naturalmente modificare i
nomi e le descrizioni a seconda del plugin che vorrete rendere compatibile.
esempio di manifest.ini
***
name = DriverDisplayBrailleMb408
summary = Driver per MDV Mb408L
version = 1.0
description = Driver per rendere compatibile Mb408l con NVDA.
author = Gianluca Casalino
url = http://www.nvda.it

***
come vedete, sei righe molto semplici, ricordate che summary  un breve
riassunto di poche parole di ci che fa il driver, description invece
pu contenere anche righe intere pi particolareggiate.
3. Salvare il file e posizionarlo assieme agli altri file che compongono
il plugin.
4. Ora, prendete il vostro programma per comprimere preferito, si
consiglia 7zip, e create un archivio in formato zip.
Continuando con l'esempio, otterremo il file mb408.zip.
5. ora bisogna rinominarlo in:
mb408.nvda-addon
infatti, i componenti aggiuntivi non sono altro che file zip, rinominati
per con l'estensione nvda-addon
Fine.
Se ora aprite Manage Addon e aggiungete un componente aggiuntivo tramite
il pulsante Add, dategli in pasto il file appena creato.

Nota:
ho trovato nella cartella delle impostazioni personali di NVDA la
cartella addon, con il driver appena installato.
Bisogner capire se tutti i plugin quindi andranno a finire nella stessa
cartella, senza quindi distinzione tra voce, braille o moduli vari.
Chris:
mi sa che bisogna distinguere i vari componenti nelle diverse cartelle
che conosciamo; globalPlugin, appModules e i drivers per i braille. Per
questi ultimi non sono sicuro perch ora non ho opportunit di provare,
ma per i plugin e moduli aggiuntivi se non gli raggruppiamo in cartelle
diverse non vengono ricaricati.
Se non ho capito male, le cartelle appmodules e globalPlugin nella
cartella di configurazione personale di NVDA usando questa nuova
funzione di load verranno ignorate.
Avremo quindi una cartella addon che contiene le solite cartelle
globalplugin ed appmodules sotto la cartella addon che abbiamo inserito.
Praticamente se voglio creare un pacchetto addons devo conoscere in che
directory va inserito, creare la cartella con il nome della directory e
inserirlo dentro.
Per esempio, se voglio creare un addons con OCR plugin devo creare la
cartella globalPlugin, inserire i file dentro e poi comprimerlo
accoppiato al file manifest.ini. Ovviamente quest'ultimo deve stare
fuori dalla cartella globalplugin o appmodules.
Di seguito il collegamento a un pacchetto esempio con alcuni plugin che
ho inserito a caso che ho provato con la nuova beta:
http://goo.gl/NZ0gE
