script, come personalizzare ed aggiungere senza sorgenti

Roberto Bianchi su uic h.e., 20\12\2009, h. 13.02.

sicuramente ho scoperto l'acqua calda, ma dato che per me è una novità, voglio condividerla con chi ama allargare le proprie conoscenze al solo fine di aumentare la propria autonomia.
Infformatica o meno l'autonomia è sempre emancipazione ed indipendenza.
Premessa:
è sempre buona norma, prima di procedere, di salvarsi i files interessati da qualche parte, per poi se serve poterli rimeterli nel loro posto di origine.
Detto ciò, a volte abbiamo degli script funzionanti e ben fatti di cui però non abbiamo i sorgenti, ai quali tuttavia vorremmo aggiungere delle nostre personalizzazioni:
ovvero delle funzioni, operazioni o dei riscontri vocali di jaws, a noi graditi.
E' nota la procedura che Avendo i sorgenti originali (*.jss), portandoci alla fine del file, è possibile aggiungere altri script da noi creati.
Tuttavia se i sorgenti mancano, si rischia che i nostri-nuovi si sostiutiscano, invece di integrarsi, con quelli già fatti.
Dunque poniamo di avere un programma che convenzionalmente chiamerò "Pippo.Exe", con i suoi files per jaws:
Pippo.jsb : script compilati - binari
pippo.jcf : programma di configurazione
pippo.JKM : programma tastiera
La prima cosa che ho notato, è che mancando il file Pippo.JSM (messaggi-help), ho dato per certo ovviamente che anche i messaggi dell'Help sono stati compilati ed integrati nel Pippo.jsb, e di rischiare di perderli.
Quindi per prima cosa ho aperto l'ehlp da dentro la finestra del programma Pippo (supponiamo il classico Ins-H), copiato il suo contenuto nella keyboard, per uscirne poi con l'altrettanto classico Esc.
Sempre restando nella finestra del programma Pippo, con Ins-0 ho aperto l'editor di jaws per gli script, e dal menu File ho selezionato "nuovo", evidenziato poi nella casella di scorrimento "Messaggi", per poi chiudere con OK.
Qui ho incollato tutto ciò che avevo nella keyboard.
Sono ritornato all'inizio del file ed ho inserito le seguenti righe:
Messages
@Str_Integrato_Help
I seguenti comandi appartengono all'ideatore degli script "Giuseppe Verdi", che ringraziamo a Priori per il Suo lavoro.

Ed ora, un po' di pubblicità

Poi andando alla fine del file inseriamo queste righe:
@@
EndMessages
All'interno quindi di questi indicatori, abbiamo l'help per Pippo, dove aggiungeremo le nostre righe di "creazione":

I comandi seguenti sono invece del sottoscritto:
Shift+Ctrl+...... : operazione o riscontro.....

Ora salviamo il tutto con il nome Pippo.JSM, nella stessa cartella dove si trovano gli altri, Pippo.*, (Condiviso, utente).
Usciamo dall'editor e dal programma Pippo.

A questo punto portiamoci nella cartella dove sono tutti questi files, (AllUser=condivisi, Roberto=utente), e rinominiamo il file binario Pippo.jsb (che con fantasia!) chiameremo Pippo-bravo.jsb ;
quindi "Ins-F2" per dare invio su "Editor di Script".
Ora inseriamo le classiche righe iniziali:

; Script di Jaws integranti quelli di "Giuseppe Verdi"
; (atto intellettualmente dovuto!)
; ripresi e personalizzati dal sottoscritto.
Include "HjGlobal.jsh"
Include "HjConst.jsh"
Include "hjhelp.jsh"
Include "common.jsm"
Include "Pippo.jsm"
use "Pippo_bravo.jsb" ; abbiamo integrato il precedente file.

a questo punto sistemiamo l'ehlp.
scriviamo qualche riga sotto:
Script Help () ; Shift+F1
; Mostra l'elenco dei tasti degli script
If UserBufferIsActive () Then
UserBufferDeactivate ()
EndIf
SpeechOn ()
saystring("APRO LA GUIDA")
SayMessage (ot_user_buffer, Str_Integrato_Help,"")
EndScript

Prima di "salvare" il nostro script, l'editor di script per jaws ci impone di salvare il file.
quindi:
Menu' file;
Salva con nome....
Attenzione a "portarci" nella cartella dove risiedono tutti i precedenti files pippo.* .
per i condivisi:
C:\Documents and Settings\All Users\Dati applicazioni\Freedom Scientific\JAWS\8.0\SETTINGS\ita
per l'utente invece:
C:\Documents and Settings\utente\Dati applicazioni\Freedom Scientific\JAWS\8.0\SETTINGS\ita
(dove ovviamente "utente" è il proprio profilo).
Finalmente salveremo dando il nome
Pippo, e come "tipo file" file sorgente *.jss .
.
Abbiamo quasi finito.
riportiamoci con il cursore sulla riga:
" Script Help () ; Shift+F1 "
qui diamo Ctrl+D per aprire le specifiche dello script, che con "Tab" potremmo compilare.
Accertiamoci che la dicitura
"Può essere assegnato al tasto"
abbia la spunta.
Quando sentiamo jaws recitare
"Assegna al tasto di accesso:"
premiamo la combinazione tasti "Shift-f1"
per poi confermare il classico "Ok".

Allora finalmente abbiamo finito.
Salviamo definitivamente il tutto con Ctrl+S, che provvederà alla compilazione del tanto sudato Pippo.jsb .
Da ora in poi potremmo aggiungere tutte le personalizzazioni che vogliamo, rispettando al contempo il lavoro altrui, infatti
non avendo inserito la :
Void Function AutoStartEvent ()

....

EndIf

il messaggio d'aiuto all'avvio del programma resta coerentemente e giustamente di "Giuseppe Verdi".