WPCustPad 1.1 Utility per la personalizzazione di WEBpatente e WEBpatentino AM offline.

Transcript

1 1 WPCustPad 1.1 Utility per la personalizzazione di WEBpatente e WEBpatentino AM offline Che cos è Questo programma permette di generare in modo automatico il file cust.js di WEBpatente/WEBpatentino AM, realizzando impostazioni personalizzate che sarebbe troppo complesso operare in modo manuale. In particolare consente di: Impostare un nuovo elenco di argomenti per l esame su argomenti selezionati. Utilizzare detto elenco nelle funzioni Quiz per argomento e Soluzioni. Utilizzare detto elenco nel manuale di teoria. Preimpostare e nascondere alcune opzioni di WEBpatente/WEBpatentino AM. Per altre informazioni sull uso del file cust.js, si veda l apposita guida pubblicata all indirizzo: Esempio di elenco personalizzato per WEBpatente Si ricorda che per l uso di WEBpatente e WEBpatentino AM in attività professionali e la realizzazione di versioni personalizzate dei programmi che includano logo e recapiti della propria autoscuola è necessario l acquisto di una apposita licenza d uso, che può essere ottenuta in cambio di un contributo a progetti di solidarietà in campo educativo. Pur ulteriori informazioni in merito contattare il prof. Mastri:

2 Come funziona WPCustPad Riceve come input un file di testo (che può essere editato a parte oppure direttamente con l editor del programma) e produce come output il file cust.js che va copiato nella cartella: chrome\pers posta all interno della cartella di installazione di WEBpatente/WEBpatentino AM. In base al sistema operativo utilizzato, potrebbe essere necessario possedere particolari privilegi utente per compiere questa operazione; per questa ragione, sui sistemi Windows, WPCustPad viene installato in modo da essere eseguito come amministratore. NOTA: anche se WPCustPad funziona solo su Windows il file cust.js con esso generato può essere utilizzato su qualsiasi piattaforma (Windows, Linux, Mac OSX) Uso di WPCustPad: scelta del programma La prima operazione da compiere, per potere usare WPCustPad, è scegliere il programma per il quale si vuole effettuare la personalizzazione: WEBpatente (per i quiz per le patenti A e B) o WEBpatentino AM (per i quiz per la patente AM). Utilizzare un file cust.js compilato per un programma con l altro potrebbe portare a errori di esecuzione imprevedibili, facilmente eliminabili cancellando il file stesso (cf. sotto il 6). Per scegliere il programma, utilizzare l apposito menu che compare in alto nella finestra di WPCustPad. La scelta effettuata verrà memorizzata tra una sessione e l altra. NOTA: Come indicato nel menu, il file cust.js prodotto con questa versione di WPCustPad non è compatibile con le versioni di WEBpatente precedenti al Per creare un file compatibile con tali versioni utilizzare WPCustPad Immissione del file di input. La sezione //QUIZ Perché possa funzionare, in file di input deve essere formattato secondo una precisa sintassi (molto semplice). In primo luogo il file può contenere tre sezioni, contraddistinte da una delle seguenti intestazioni: //QUIZ //FILE //SUGG Se non è presente alcuna intestazione, viene sottinteso che il file presenti solo una sequenza di argomenti da usare nell esame personalizzato, con l indicazione dei gruppi di quiz ad essi riferiti (si sottintende, cioè, che all inizio del file sia inserita l intestazione //QUIZ). La sezione //QUIZ va così formattata: <Titolo dell argomento> <numerogruppo 1 > <numerogruppo> <numerogruppo> 1 Per numero del gruppo si intende, in WEBpatente, un valore da 1 a 923, che rappresenta uno dei 923 gruppi tematici in cui i quesiti ministeriali sono stati suddivisi. In WEBpatentino AM i valori vanno da 1 a 334. I gruppi di quesiti possono essere facilmente visualizzati tramite la funzioni Quiz per argomento e Soluzioni dei quiz.

3 3 Oppure: <Titolo dell argomento> <numeroblocco 2 > <numeroblocco> <numeroblocco> Esempio della immissione per gruppi 3 : Esempio di immissione per blocchi: Inserire i questi per gruppi o per blocchi è questione di gusto personale; si sottolinea tuttavia che, in WEBpatente, i gruppi consentono di ottenere una suddivisione più analitica delle varie tematiche Gestione dei capitoli ministeriali Tutti gli argomenti dovrebbero fare riferimento ad un capitolo ministeriale 4. Di default si considera capitolo di riferimento quello del primo gruppo/blocco dell argomento. Nell esempio soprariportato il capitolo di riferimento sarà quello del blocco ossia il cap. 1. Dal momento che gli argomenti possono contenere anche gruppi/blocchi fuori capitolo e che il primo può essere uno di questi, è possibile specificare esplicitamente il capitolo di riferimento, inserendolo dopo il titolo dell argomento in una riga a parte con il prefisso *. Ad esempio: *1 Imposta il capitolo anche se il primo blocco appartiene al capitolo Nell elenco degli argomenti per l esame personalizzato i titoli dei capitoli ministeriali che non abbiano un solo argomento sono indicati con i titoli utilizzati da WEBpatente/WEBpatentino AM (si veda il menu 2 Per numero del blocco si intende un valore da a (WEBpatente) o da a (WEBpatentino AM) che rappresenta una delle suddivisioni in cui è articolato il listato dei quiz diffuso dal Ministero. A differenza di gruppi i blocchi non hanno sempre unità tematica e possono vertere su diverse figure. 3 Nella cartella di installazione di WPCustPad sono presento i file di esempio webpatente.txt e webpatentino.txt che contengono le sequenze degli argomenti di default dei due programmi. Se si vuole, si possono usare questi file come base per la personalizzazione. Compilare un cust.js a partire da uno di questi file così com è non ha senso, perché non produce modifiche nella struttura di WEBpatente/WEBpatentino AM. 4 Per capitolo ministeriale si intende uno dei 25 (WEBpatente) o 10 (WEBpatentino AM) argomenti sempre compresi nelle prove d esame.

4 4 degli argomenti nei Quiz per argomento ). Si può modificare il titolo inserendo, in qualunque punto (anche prima di tutto l elenco) una o più righe come la seguente: #<numero capitolo><spazio><nuovo titolo del capitolo> Ad esempio: #1 Definizioni stradali - classificazione dei veicoli - doveri del conducente nell uso della strada Se si vuole generare un elenco che prescinda dai capitoli ministeriali è possibile eliminare la loro presenza selezionando l apposita voce dal menu Opzioni Commenti E possibile specificare commenti a destra dell informazione immessa, separandoli con il segno I commenti a sinistra devono essere separati dal segno ] Esempi: Questo commento sarà ignorato] Questo commento sarà ignorato Nei file di esempio webpatente.txt/webpatentino.txt, inclusi nella cartella di installazione, i commenti chiariscono il contenuto di ciascun gruppo di quesiti, facilitando il loro riordino La sezione //FILE La sezione //FILE che può essere posizionata prima o dopo quella relativa ai quiz consente di inserire, in coda al file cust.js le informazioni contenute all interno di un file di testo specificato. Ad esempio, se si è preparato un nuovo elenco di commenti alle prove di esame, seguendo le istruzioni contenute nella guida sopracitata, e lo si è salvato nel file COMMENTI.TXT, all interno della cartella documenti, queste righe: //FILE C:\Users\<nomeutente>\Documents\COMMENTI.TXT consentono di includerne il contenuto all interno del nuovo cust.js. Come si vede dall esempio, deve essere indicato il percorso assoluto del file ( <nomeutente> sta ovviamente per il nome dell utente sul sistema utilizzato; il percorso potrebbe differire nelle varie versioni di Windows). 3.5 La sezione //SUGG Di default WPCustPad produce un file cust.js che modifica solo l elenco degli argomenti per l esame personalizzato; attraverso le apposite opzioni, tuttavia, come si chiarirà nel prossimo paragrafo, è possibile utilizzare il medesimo elenco anche per i quiz per argomento e per il manuale di teoria. In quest ultimo caso, qualora l elenco fosse compilato per blocchi o in altre particolari circostanze, è possibile che i medesimi suggerimenti siano visualizzati in più capitoli del manuale. La sezione //SUGG,

5 5 che va obbligatoriamente posizionata prima della sezione //QUIZ, consente di eliminare uno o più suggerimenti da ciascun argomento del manuale, in questo modo: //SUGG <numeroargomento>:<suggerimentodaeliminare>,<suggerimentodaeliminare> Ad esempio la sezione potrà apparire così: //SUGG 22:11075,295 23:11038 Laddove 22 e 23 sono rispettivamente il 22mo e il 23mo argomento della lista personalizzata e gli altri valori corrispondono ai numeri dei suggerimenti da non fare apparire in quegli argomenti. Per visualizzare il numero di un suggerimento, posizionare il cursore del mouse sulla finestra del suggerimento (o sulla pagina del manuale) e attendere qualche istante. Numero di un suggerimento 4. - Modifica delle opzioni Nel menu Opzioni appaino alcune voci che, se spuntate, consentono di: Nascondere e/o modificare alcune opzioni di WEBpatente. Eliminare i titoli dei capitoli ministeriali dall elenco degli argomenti per l esame personalizzato. Utilizzare l elenco personalizzato anche per le funzioni Esercizio per argomento e Soluzioni dei quiz. Utilizzare l elenco personalizzato anche per organizzare i contenuti del Manuale di teoria.

6 6 Il menu Opzioni Compilazione del file cust.js Terminata la modifica del file di input e l eventuale impostazione delle opzioni, salvarlo e avviare la compilazione, scegliendo dal menu Compila la voce Genera cust.js (oppure premendo il tasto F5). Apparirà una finestra con la richiesta della posizione in cui salvare il nuovo file cust.js. Si può scegliere di salvarlo direttamente nella cartella chrome/pers dell installazione di WEBpatente oppure in un altro luogo (occorre comunque tener presente che per scrivere nella cartella di installazione occorre disporre di particolari privilegi di sistema, altrimenti, in alcuni versioni di Windows, si potrebbero ottenere risultati imprevisti). Dopo aver collocato il file cust.js per verificare gli effetti della personalizzazione, avviare WEBpatente/WEBpatentino AM. Cust.js in funzione. Questo manuale personalizzato comprende per WEBpatente 59 lezioni invece di 40.

7 Avvertenze L uso di WPCustPad è sconsigliato se non si possiedono nozioni di base sul funzionamento del sistema operativo impiegato. E opportuno evitare l impiego di caratteri speciali nell elenco (infatti potrebbero non essere visualizzati, oppure potrebbero bloccare l esecuzione di WEBpatente/WEBpatentino AM). In caso di problemi si può facilmente ripristinare la situazione di partenza, chiudendo il WEBpatente/WEBpatentino AM e cancellando o rinominando il file cust.js Roberto Mastri Versione del manuale: 1.10 Anche se distribuito gratuitamente per l uso personale, WEBpatente e WEBpatentino AM non sono di pubblico dominio. L impiego dei programmi richiede il rispetto del contratto licenza incluso nei rispettivi pacchetti di installazione del software.