Home Up

               Visual Analyser Project (vers. 25 Silvia edition )

Help

 

Novità
Panoramica su VA
Volume di windows
Scarica programma
Fai una donazione
Autore di VA
Hardware
Altri programmi
ZRLC

L'help "democratico"

Uno dei più grossi problemi che affligge VA sin dalle sue primissime versioni è la mancanza di un vero help, o meglio ancora, di un manuale. Questo principalmente per due motivi: il primo è che scrivere un help (o manuale) richiede un sacco di tempo. E siccome io non guadagno soldi da VA (eccetto qualche sporadica e veramente simbolica donazione) devo lavorare per vivere e il tempo certo non mi avanza.

La seconda ragione è che non sono un grande conoscitore dell'inglese (credo si noti!) e dunque (visto che la lingua "ufficiale" di VA è l'inglese) per me è veramente difficoltoso scrivere un help degno di tale nome. Invero, per chi parla Italiano c'è un "bonus" in più, che essenzialmente è la mia tesi di laurea e recentemente (dal rilascio della versione 2011) la mia tesi di dottorato.  Che comunque non è un vero manuale, sebbene ci siano validi spunti.

Tuttavia, sin dalle prima versioni di VA era presente un rudimentale meccanismo di help, che avevo messo su semplicemente implementando una semplice finestra, fatta con oggetti di libreria, che consentiva di caricare e visualizzare un file con estensione .rtf (dunque "editabile" con un normale "WordPad" o equivalente) a mo' di help. Ossia, cliccando sul bottone "help" presente nelle finestre principali appariva (appare) una finestra che cerca di caricare un determinato file di help con estensione rtf. Semplice, un banale file di testo "evoluto" ma nulla più; usando le scarne funzioni di libreria di un compilatore C++ non si possono nemmeno caricare le immagini.

Di questo tipo di help avevo fatto giusto tre file, con un help rudimentale sulla finestra principale e le prime due "cartelle" della finestra di Settings. Poi nelle ultime versioni, complice il fatto che nessuno probabilmente lo usava (zero feedback), mi sono perso qualcosa mentre compilavo e l'help funzionava "male" non andando a capo e rendendo illeggibili quei pochi file esistenti.

In questa recente versione ho "ripristinato" il meccanismo, ma come aggiunta ho messo il bottone di help praticamente dovunque. I file attualmente esistenti e distribuiti sono svariati, che con la versione 2014 vengono automaticamente installati nella directory "help", e che qui possono essere scaricati comunque:

File di Help

E' possibile modificarli e se li modificate, correggete o ne create di nuovi mandatemeli e li farò diventare "ufficiali".

Se tuttavia si tenta di invocare un help non esistente, la finestra comparirà comunque, ovviamente vuota ma con un messaggio di "warning". Per esempio, se si prova ad invocare l'help nella finestra del Voltmetro, appare il messaggio:

"No help found. Check your help directory for file:Help\VoltMeter.rtf"

Benissimo. A questo punto sapete che: l'help non è stato ancora scritto, ed il corrispondente file che viene caricato è "Voltmeter.rtf". Pertanto, se avete una particolare conoscenza del voltmetro, magari solo perché mi avete scritto o per semplice "praticaccia" potrete collaborare attivamente al "progetto Visual Analyser" scrivendo voi stessi il file di help; me lo potrete proporre via posta ed io lo (se necessario) aggiornerò e lo includerò in una delle prossime versioni; e comunque lo renderò scaricabile da questa stessa pagina in tempi brevissimi. E naturalmente - se vorrete - verrete esplicitamente citati come collaboratori.

Questo apre le porte ad un nuovo mondo; a me, perché posso scrivere l'help indipendentemente dalla compilazione/rilascio di VA e quando ho tempo/voglia; a voi perché potrete collaborare. Naturalmente tutto questo non esclude la possibilità di impostare un help plurilingue...

Insomma, a me non sembra una cattiva idea, resto in attesa di feedback. Scrivete all'indirizzo di posta in calce alla pagina.

Alfredo Accattatis

Pubblicazioni recenti:

 

 

Invia una e-mail a  alfredo[at]accattatis.org in caso di domande o consigli sul sito.
Last modified: 03/25/14