Newsgroup: it.hobby.fai-da-te
Titolo: scrivere un manuale

Ciao
dovrei scrivere un manuale (da stampare poi su carta) relativo all'uso
di un prodotto.
Quale e' il miglior software per organizzare un manuale (quindi che
gestisca indici, sommari ecc ecc)?
Grazie

 gestisca indici, sommari ecc ecc)?
Io ho usato con soddisfazione OpenOffice.
-- 
===============================================================
Alberto Rubinelli - A2 SISTEMI  Opera 8.50->
news.bbip.it
Via Costantino Perazzi 22 - 28100 NOVARA - ITALY
Tel 0321 640149  Fax 0321 391769 BBS 0321 392320
Mail: 
alb...@retrocomputing.net
  ICQ : 49872318
Skype : albertorubinelli
Visita il mio museo di computers: 
http://www.oldcomputers.it
=====================================

 wrote in message
news:1137952698....@g47g2000cwa.googlegroups.com...

In azienda per il software da noi sviluppato usiamo RoboHelp, crei i files
in formato html (ad esempio con il Dreamweaver) e li assembli in una "toc"
(table of contents) e crei l'help in formato ".chm" (stile l'help di
Windows). Il RoboHelp era prodotto dalla EHelp che due anni fa fu acquistata
dalla Macromedia che un mese fa e' stata acquistata dalla Adobe. Quindi lo
trovi su 
www.adobe.com
, costa intorno agli 800 Euro.
Per la cronaca, si ritiene che questo software verrà dismesso da Adobe,
infatti ci stiamo attualmente interessando al "Flare" della madcap
www.madcapsoftware.com
 (attualmente in beta, release finale a febbraio).



LaTeX, senza nessunissima ombra di dubbio!
Qui spiegano cos'è:
http://it.wikipedia.org/wiki/Latex
Questa è la pagina ufficiale di LaTeX:
http://www.latex-project.org/
Qui trovi una distribuzione per Windows:
http://www.miktex.org/
Questo è il Newsgroup italiano:
it.comp.software.tex
Questa è *la* guida per chi inizia (in italiano). È essa stessa
scritta in LaTeX, così ti fai un'idea dei risultati ottenibili.
www.tug.org/tex-archive/info/italian/lshort/itlshort.pdf
Esiste poi il KOMA-Script per adattarsi allo standard europeo e
aprirsi innumerevoli possibilità.
Se hai bisogno chiedi! Iniziare è un po' traumatico, ma poi hai per le
mani uno strumento potentissimo.
Boiler

trovi su 
www.adobe.com
, costa intorno agli 800 Euro.
LaTeX costa sugli 800 Euro in meno ;-)
Inoltre dice che vuole stampare us carta, il chm non penso sia cosě
comodo per questo scopo, no?
Boiler

 comodo per questo scopo, no?
Funziona bene, puoi stampare una sola pagina, un solo capitolo o l'intero
manuale.

 manuale.
Si', ma il prodotto e' stato studiato per generare i file di help, non 
manuali testuali. LaTeX invece e' nativo...
Ciao,
Taz

 manuali testuali. LaTeX invece e' nativo...
Attenzione, se si č nuovi al LaTeX, che non č un software, bensě un vero e 
proprio linguaggio di programmazione. Altamente specializzato per la stesura 
di testi complessi in ambito scientifico.
http://www.latex-project.org/intro.html
E' un'evoluzione specializzata nell'ambito scientifico del linguaggio TeX
http://it.wikipedia.org/wiki/TeX
Quindi, occhio, LaTeX e TeX sono strumenti potentissimi, ma richiedono una 
certa dose di conoscenza, o l'utilizzo di editor WYSIWYG 
(
http://it.wikipedia.org/wiki/WYSIWYG
), che semplifica parecchio l'uso.
Vari programmi qui: 
http://www.cs.unipr.it/~pescetti/latex.html
.
Un editor tipo word qui 
http://www.lyx.org/
Buon lavoro :D
Ciao
Felix 

certa dose di conoscenza, o l'utilizzo di editor WYSIWYG 
IMNSHO usare un WYSIWYG con LaTeX è come mangiare il sushi con le
chiavi inglesi: una grezzata ;-)
Boiler

(era?) lo standard.
Dimmi cosa vuoi e ti dirò che c'è ;-)
Vuoi fare dei Flow-Charts? Si può.
Vuoi inserire dei diagrammi di Veitch-Karnaugh? Si può.
Vuoi fare delle slides per una presentazione? Si può.
Vuoi disegnare circuiti? Si può.
Il bello è che è tutto integrabile perfettamente in un unico documento
senza che il tutto sappia di messo-insieme-alla-bellemeglio.
Puoi inserire codici a barre, pentagrammi, c'è davvero di tutto!
Con questo non voglio dire che RoboHelp non lo faccia. È un programma
che non conosco. Ma voglio far notare che non perche' un programma è
free che contenga meno features di quello a pagamento!
Boiler

 chiavi inglesi: una grezzata ;-)
Non è vero!!!! Hai detto una cazzata!!!! LOL
:D
Una classica cazzata da geek!!!!
Nessuno nasce imparato. E nessuno impara se le barriere all'ingresso che 
percepisce sono troppo elevate.
Ammesso che tu scriva tutto il codice TeX in notepad, ti sfido a provarmi 
che almeno il 90% di quello che tu scrivi non potrebbe essere fatto 
tranquillamente da un editor, risparmiandoti ore di lavoro in fondo alla 
settimana ...
Che poi quel 10% come lo fai tu non lo farà mai nessun editor ... ne 
possiamo discutere ;)
Ma il "controllo del codice" lo puoi avere anche con un editor.
Colla differenza che un editor permette di produrre un output anche al 
principiante ...
Se ti pare poco!
Quindi direi che è palesemente il contrario: scrivere qualunque codice col 
notepad (o uno qualunque dei 64mila editor di testo *nix) è come mangiare il 
susci colle chiavi inglesi, solo per dimostrare che si è più fighi ... 
Infatti lo fa il 2% degli utenti a dire tanto.
Usare un editor è come usare la forchetta. Non sarà educato e bello da 
vedere per un purista, ma ti assicuro che è TANTO COMODO!!!! E il sushi è 
sempre lo stesso, garantito.
;)
Ciao
Felix 

Se ti pare poco!
Non sai cos'è un WYSIWYG.
Hai detto una cazzata ;-)
Non uso notepad, né vim o emacs. Uso TeXnicCenter o Kile.
Sono editor che ti semplificano il processo di "compilazione", ti
evidenziano correttamente il codice e hanno dei bottoni su cui clicci
per evitare di scrivere ogni volta \Rightarrow et similia.
Ma non si tratta di WYSIWYG.
Lyx sì che è un editor di questo tipo, ma dopo aver visto un collega
tentare di usarlo mi sono cascate le braccia (e qualcos'altro...).
Vermante, secondo me l'utilizzo di un WYSIWYG va contro l'idea
originale di LaTeX (nota che uso LaTeX, non TeX) che è di togliere
all'autore l'incombenza della parte tipografica.
Boiler

 Hai detto una cazzata ;-)
E seguenti ...
Il fatto è che hai saltato a pie' pari il concetto di fondo del mio post. Ed 
è un problema tuo, non del post.
Infatti io ho detto che per un utente pigro, è meglio cominciare con un 
WYSIWYG.
Tanto, se non ha voglia non imparerà comunque.
E se si trova bene sarà naturalmente spinto ad approfondire il lato del 
codice.
E a passare a qualcosa di più complesso
Nel frattempo avrà prodotto output in quel linguaggio, e avrà gradualmente 
preso confidenza.
Certo, c'è chi si trova meglio a rompere i muri a testate, io personalmente 
mi trovo meglio coi piedi, dopo una cura al piccone. Gusti personali.
1) non mi hai assolutamente provato che praticamente tutto quello che fai tu 
con un editor "intelligente" non lo si possa fare con un WYSIWYG, senza 
dover vedere codice (che ai niubbi fa tanto passare la voglia, ndr) In 
pratica il tuo è solo un esercizio di stile. Come mangiare con forchetta e 
coltello il panino in campeggio?
2) il tuo collega, o tuo cugggino, o chiunque altro ... sinceramente mi 
lasciano indifferenti, oltre ad aver visto una tesi di laurea in Wheather 
Derivatives scritta con Scientific WorkPlace, ho usato SWP svariate volte 
per fare documenti di modesta entità, e ti assicuro che non mi è nemmeno mai 
venuta voglia di mettere mano al codice.
Io sarò anche un poveretto che non sa di cosa parla, ma sono un poveretto 
che schifa particolarmente i puristi del cazzo, quelli che se non è tutto 
estremamente difficile ed elitario non va bene.
Soprattutto quando è una mera questione di forma, con confidenza 0,95.
In medio stat virtus.
Tu fai le cose come ti pare, però non impedire agli altri di sapere che c'è 
un modo più facile.
Altrimenti è DISINFORMAZIONE.
Continua ad impastare a mano il tuo codice "pulito", che il mio codice 
sporco me lo pappo da solo a macchina. In un ventesimo del tempo. LMAO!
Ciao
Felix 

un modo più facile.
Ho cercato di impedire a qualcuno qualcosa?
Boiler

 wrote:

Come rapporto qualità/prezzo, OpenOffice.
L'ho usato spesso proprio per scrivere piccoli manuali.
-- 
Bye, Yorgos
To send me an email, please change loose with free

 L'ho usato spesso proprio per scrivere piccoli manuali.
Mi sembra si possano portare direttamente i documenti in PDF volendo.
-- 
 maccumba
 Castelfranco Veneto 
 ex GSXR 1100 SACS
 Lee Cougan Revenge pro disk '05