[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[linux_var] texi2man e zdl
ciao,
vi segnalo un paio di cose, che potrebbero essere utili a
qualcuno:
1) negli ultimi tempi ho ripreso in mano il progetto
ZigzagDownLoader (http://nongnu.org/zdl).
L'ho sviluppato in tutte le direzioni (molti
più strumenti, opzioni, interattività...) e reso più efficiente
(anche per Cygwin) attraverso un uso intensivo di gawk.
Inoltre, ho creato un intero sistema per la documentazione del
programma, che serve a introdurre la seconda cosa:
2) ho pubblicato il progetto "texi2man", uno script in perl che
serve a generare una pagina per "man" da un sorgente "texi"
scritto per un ipertesto di "info" o in html. Attraverso
l'introduzione di una serie di comandi in stile texinfo,
ma ignorati da makeinfo, texi2man estrae pezzi di testo, li
riordina e di codifica in groff.
Un esempio: la documentazione di ZDL.
il sito web: http://nongnu.org/zdl
la pagina di manuale: 'man zdl'
l'ipertesto di info: 'info zdl'
Pur essendo differenti, sono tutti generati a partire da un
unico sorgente: zdl.texi
Devo ancora scrivere un manuale per texi2man e lo script è
ancora agli inizi, anche se è già perfettamente utilizzabile
(come si può notare dall'esempio) ma, se serve a qualcuno,
sono disponibile a spiegazioni (attraverso email).
Il progetto: https://savannah.nongnu.org/projects/texi2man
PS: la testata del sito di ZDL è una raffigurazione giocosa della
curva di Peano-Hilbert, lo zigzag "pandimensionale" :)
--
Z O N I N O Z
Gianluca Zoni
zoninoz@inventati.org
http://inventati.org/zoninoz
http://savannah.gnu.org/users/zoninoz
_______________________________________________
Talking mailing list
Talking@ml.linuxvar.it
http://ml.linuxvar.it/cgi-bin/mailman/listinfo/talking