Newsgroup: it.comp.lang.delphi
Titolo: Help

Fino ad ora i miei applicativi che giravano su xp, hanno il loro help creato 
da me utilizzando un file unico .hlp invocato tramite 
Application.HelpCommand(HELP_CONTENTS, 0);
Ora i miei applicativi girano anche su win 7 dove il file .hlp non � pi� 
leggibile.
Quale soluzione alternativa semplice potete consigliarmi ?
Per semplicit� di utilizzo e installazione, vorrei un file di help unico, 
non l'html che tra link e immagini si porta dietro molti file e basta 
perderne uno per non fare funzionare nulla.
In conclusione cerco un modo semplice per colegare un help alla mia 
applicazione .
Grazie
Stefano 

> Quale soluzione alternativa semplice potete consigliarmi ?
Hai gia provato a cercare sul web?
A.

Hai gia provato a cercare sul web?
Si certo, ma vorrei un consiglio dagli utilizzatori

 Si certo, ma vorrei un consiglio dagli utilizzatori
il modulo software per leggere/aprire i file .hlp da Vista/7 �
opzionale, e comunque distribuito da Microsoft. Googla e vedrai che lo
trovi.
Ale

Ale
Si, lo so, � WinHlp32.exe ma visto che il formato hlp sta andando in disuso,
vorrei capire quale soluzione alternativa intraprendere per il futuro, quale
la pi� semplice, ho visto che molti integrano l'help nell'applicativo
stesso, altri usano il formato chm, altri ancora html (ma come dicevo non
piace), ecc...
Quindi volevo un consiglio su dove dirigermi .
S. 

 html (ma come dicevo non piace), ecc...
file readme esterno con l'ABC dell'uso, oppure videocorsi per
approfondire questioni specifiche. Lascia perdere i file di help in
genere, sono un retaggio degli anni '80.
Ale

DETESTO avere risposte via email per domande del NG!
Grazie.

Ale
Nel mio caso i video corsi mi sembrano eccessivi, io cercavo qualcosa da 
agganciare a delphi in modo semplice che mi descrive alcune funzioni con 
immagini, esempi e testo. 

Grazie.
Sorry, ho sbagliato pulsante di risposta, infatti ho messo la risposta anche 
qui.
Chiedo umilmente perdono :-)
S.

Se scaricando un addon riesci a riutilizzare i file hlp gia pronti,
io non spenderei tempo a inventarmi qualcosa di nuovo, fermo restando
che, a prescindere dal formato, in italia nessuno li legge....
A.

prescindere dal formato, in italia nessuno li legge....
"in italia nessuno li legge"
Verissimo !
Tra le varie possibilità stavo pensando a utilizzare un componente che 
visualizza file hlp esterno, sto vaneggiando ? 

 che, a prescindere dal formato, in italia nessuno li legge....
non solo in Italia.
A me, comunque, � capitato qualche cliente che ha chiesto "il manuale
d'uso" (cartaceo, perch� "mica devo spendere soldi per stamparlo io..")
Forse era rimasto fermo agli anni '80 :D
Non c'� stato verso di fargli capire che con aggiornamenti che escono
ogni 2 mesi � improponibile realizzare manuali d'uso stampati.. e la
documentazione online, comunque sia, non pu� essere fatta "a manuale",
ma al massimo a faq. Niente da fare, non ha voluto sentire ragioni. :DDD
Ale

 genere, sono un retaggio degli anni '80.
Quindi una man page[1] e` un anacronismo da buttare... :)
Enrico
[1] ovvero il sistema di help utilizzato nel mondo unix, coadiuvato dalle 
info pages e da internet in generale

 Quindi una man page[1] e` un anacronismo da buttare... :)
è valido tanto quanto lo sarebbe, oggi, proporre ad un utente Windows
di andare in prompt e digitare type blabla.txt|more
:D
Ale

 immagini, esempi e testo.
Ti voglio dare qualche spunto: io sto lavorando con QT e lo standard � 
l'html.
Una mossa intelligente del team � stata quella di codificare un tipo 
stringa (QString) che pu� contenere anche rich content, un RTF arrichito 
di tags html (html standard v. 4).
Questo porta il vantaggio non indifferente che i tre sistemi di help 
standard di un'applicazione (l'help online, l'hint ed il whatsthis)
possono mostrare contenuto di tipo RTF.
Se tu, dall'object inspector del form editor, clicchi sulla propriet� 
whhatsthis di un oggetto, ti si apre una finestrella con un editor RTF 
minimale dove puoi inserire tutto ci� che ti pare, da un testo html con 
link esterni, ad immagini embeded.Capir�i quindi che per te il lavoro si 
riduce a scrivere come fossi in word, salvare e lanciare la compilazione 
del programma.
Io sto proprio usando questo sistema per fornire l'help all'utente, 
risparmiando ore di lavoro. Come gi� detto da altri, l'help online 
classico sta cadendo in disuso, sostituito da link a pagine web 
interattive dove l'utente pu� vedere video tutorials,consultare la 
knowledge base o le faq del sito.
Non so se embarcadero ha migliorato il sistema di produzione degli help 
di vecchio stampo, fattost� che il trend va verso html e rich content.
Pensaci.
ciao
-- 
morde
D5,D6,D7
Firebird 2.1
QT 4.7.0 (MingW) QT Creator 2.1

 di vecchio stampo, fattost� che il trend va verso html e rich content.
Magari questa pagina pu� essere d'aiuto con qualche tool per l'authoring 
dell'help.
http://delphi.about.com/od/toppicks/tp/aatphelp.htm


 ogni 2 mesi è improponibile realizzare manuali d'uso stampati..
Considera che io in un lavoro dovevo ristampare il manuale ogni volta che 
eseguivo una modifica al codice. Una volta sono stato costretto a ristampare 
un intero manuale di 200 pagine (una facciata per foglio) quando 
effettivamente erano cambiate due pagine
Enrico

 di andare in prompt e digitare type blabla.txt|more
Da questo ritengo che la manualistica non e` tra le attivita` da te 
preferite :P
Enrico

 quando effettivamente erano cambiate due pagine
immagino che il tuo non fosse un software da 129 euro, però ;)
Ale

 preferite :P
al contrario, ho scritto e scrivo tuttora molta documentazione, ma in
forma di faq, non in forma di manuale. Il manuale, tra l'altro, ha lo
svantaggio che, a seconda dell'utente, può essere talmente ovvio da
risultare prolisso, e quindi inutilizzabile, oppure, al contrario, di
dare per scontate troppe cose che un utente invece non conosce. Diciamo
che un manuale è realizzabile e utile solo se si conosce esattamente il
tipo di utente che lo userà, e il suo livello (è il caso di aziende e
industrie che fanno corsi di addestramento all'uso di macchine e
attrezzature, ad esempio). Altrimenti meglio andare di faq: risposte
reali e concrete a problemi altrettanto reali e concreti.
Ale

 immagino che il tuo non fosse un software da 129 euro, però ;)
Touche` :)
Enrico

 sviluppatore ed approvati dai responsabili del progetto)
Il mio precedente lavoro era presso un'azienda certificata ISO sul 
processo di produzione del software, ed ogni volta che facevamo una 
release, anche un bugfix, si doveva rifare il manuale. Ogni modifica, 
anche minima, nelle finestre o nelle caption (a volte ci veniva chiesto 
di disambiguare delle captions)impone il rifacimento degli screenshots e 
dell'help.


 
http://delphi.about.com/od/toppicks/tp/aatphelp.htm
Grazie, si molto utile