Newsgroup: it.comp.os.linux.software
Titolo: Creare manuali online.

Esiste un  sw  per poter scrivere facilmente guide tipo questa?
http://ildp.pluto.it/HOWTO/3D-Modelling.html
Grazie per il prezioso aiuto.
-- 
Cordialmente.
Melus.
dal mio e-mail togli i simboli di Zorro.

tasto destro , mostra sorgente , 3a riga.... 
<META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21">
-- 
Quando si puo' scommettere, si puo' anche barare.

 
http://ildp.pluto.it/HOWTO/3D-Modelling.html
In generale, vi sono almeno quattro metodi di scrittura per guide, manuali o
qualsiasi altra cosa ti venga in mente, due tramite un linguaggio di
descrizione e due tramite un programma WYSIWYG:
1 - SGML
L'acronimo sta per Standard General Markup Language, ed e` un linguaggio
dedicato soprattutto all'editoria in generale. Da esso sono derivati XML e
HTML. La sintassi, quindi, e` del tipo:
<marcatore>testo</marcatore>
Un documento SGML puo` essere esportato in qualsiasi forma tu lo voglia
(HTML, PDF, PostScript, RTF...). Una buona documentazione su tale
linguaggio la trovi su Appunti di informatica libera (che trovi sullo
stesso sito da te indicato). Inoltre, gli HOWTO ufficiali (tra cui quello
da te riportato nel link) sono scritti in SGML
2 - TeX/LaTeX
E` un linguaggio nato per lo piu` per la scrittura di articoli scientifici
(addirittura alcune riviste accettano solo articoli scritti in questo
formato), anche se e` utilizzato in molti ambiti. Il suo punto forte e`
quindi la scrittura di formule matematiche, anche se si puo` adattare a
qualsiasi ambito. Il suo funzionamento e` simile ad un linguaggio di
programmazione (dal file .tex si genera un file oggetto .dvi, che poi
verra` esportato nel formato finale) e la sua sintassi di TeX (ed in
particolare della sua piu` famosa variante, LaTeX) e`
\textbf{testo} % produce la parola testo in grassetto
Anch'esso ha la possibilita` di poter esportare ipropri documenti in
qualsiasi forma a te necessaria, e di documentazione su tale linguaggio se
ne trova a bizeffe (a partire dall'omnicomprensivo Appunti di informatica
libera per finire wu 
http://www.ctan.org
).
3 - DTP
In pratica si tratta di programmi che ti permettono un approccio visuale a
cio` che stai scrivendo, permettendoti una gestione completa e semplice del
documento
4 - Word Processing
Penso che non ci sia bisogno di dire altro :)
Per tirare due somme, le prime due possibilita` sono veri e propri linguaggi
di descrizione della pagina e sono utilizzati soprattutto in ambito
professionale con risultati soddisfacenti (la documentazione di PostgreSQL,
ad esempio, e` completamente scritta in LaTeX, ed e` un volume di oltre
1000 pagine), e che ti permettono inoltre di concentrarti sul contenuto del
documento (in special modo TeX), gli altri sono programmi con un approccio
piu` visuale, che ti permettono di gestire il layout con piu`
flessibilita`.
Per quanto riguarda i programmi da utilizzare, per l'SGML non mi sembra che
vi sia qualcosa di specifico (un qualsiasi editor, quindi, va bene), mentre
per il DTP puoi usare Scribus (probabilmente ve ne sono altri, ma ora non
me ne vengono in mente). Per i word processor, ovviamente, hai solo
l'imbarazzo della scelta, mentre per TeX hai due vie: la prima e`
utilizzare un programma WYSIWYG tipo LyX o TeXmacs, oppure usare un editor
di testo qualsiasi (tra cui kile, che e` un'IDE specifica per TeX).
Per quanto riguarda il cosa usare, dipende dalle tue esigenze: se devi
scrivere poche pagine (sotto il centinaio) e non hai esigenze particolari,
penso che un word processor sia piu` che ottimo. Se invece ti interessa
anche la resa grafica del documento, allora ti conviene buttarti sulle
altre alternative, in quanto sono state pensate proprio per essere il piu`
professionali possibili.
Spero di essere stato chiaro
Henryx
P.S. un ultimo appunto: per utilizzare SGML o TeX devono essere installati
gli appositi interpreti