Newsgroup: it.comp.software.tex
Titolo: DocBook

Beh, ragazzi, lo so che è un po' OT, però non conosco l'Inglese e ng 
Italiani sul genere non ce ne sono ....
Sto cominciando ad impazzire con tutti questi DTD, ho provato SGML-tool con 
linux-doc; Debian doc ed infine DocBook, senza dimenticare LaTeX2html.
Ognuno di loro ha un difetto, che magari elenco a seguito, però il mio 
problema è che DocBook, nonostante sia il più completo (e sotto sviluppo 
attivo ...) formatta i documenti ps e pdf senza giustificarli, ho scaricato 
un po' di documenti per controllare meglio ma mi sembra che il problema 
permanga. Non esiste il modo per "fargli cambiare idea" ?
Come dicevo, i difetti:
1 Debian doc: Il più semplice ed intuitivo, peccato che non supporta 
l'inserimento delle immagini. Non supporta la divisione in tomi;
2 Linux doc: Più complesso di Debian doc, non supporta l'appendice e 
neanche la suddivisione in tomi;
3 LaTeX2html: LaTeX è il migliore per i documenti dvi,ps e pdf.  LaTeX è 
sicuramente il più difficile da usare ma ha una duttilità ed un'efficienza 
senza pari. Si può realizzare qualsiasi genere di documento tranquillamente.
L'unico problema è la conversione in html e txt, latex2html,a mio modesto 
parere non è all'altezza, poco documentato e poco flessibile. Ancora 
nessuno ha pensato a scrivere qualcosa in python o Perl per sostituirlo con 
un tool più facile ?
4 DocBook, molto più complesso dei primi due, ma si sa le cose complesse 
solitamente permettono più funzionalità. Difatti è il più completo, anche 
l'inserimento di "codice" è praticamente perfetto, l'unico carattere che 
deve essere modificato (e vorrei vedere ...) è il '<'. 
Problema che mi ha portato al post .... NON GIUSTIFICA.
Clamoroso, me ne sono accorto tardi, altrimenti probabilmente per l'ultimo 
documento non l'avrei usato, mi sembra anche strano, si propone come il 
nuovo standard per sostiuire SGML e poi ha questo macroscopico difetto, 
boh ?
Detta tra noi tutto sommato anche DocBook, se analizzato il comportamento a 
fondo qualche pecca ce l'ha, infatti ho "impaginato" un libro che un amico 
aveva tradotto, risultato:
Versione ps perfetta, per contro alcune parti in html risultano "attaccate".
Viceversa, versione html perfetta, quella ps presenta troppi spazi tra i 
paragrafi.
Questo comunque è un difetto presente anche nella conversione con 
latex2html, ma almeno la versione ps è perfettamente giustificata !!
Va beh, se qualcuno mi sa dire qualcosa sulla giustificazione in DocBook mi 
fa un grosso favore.
Scusate anche la lunghezza, ma ho pensato che tutto sommato anche altri 
potrebbero avere o magari avranno interesse in futuro a creare 
documentazione facilmente "convertibile" e magari avere l'esperienza di uno 
che ci ha sbattuto "il grugno" potrebbe fare piacere. 
Un saluto a tutti
Ferdinando
 

boh ?
DocBook NON si propone di sostituire SGML, sarebbe come dire che la Fiat
Punto si propone di sostituire l'industria automobilistica. DocBook E` SGML,
una particolare classe di documenti SGML, descritti da un particolare DTD.
Ciao.

 particolare DTD.
Si, come al solito hai ragione, io intendevo SGM tool e non SGML, d'altra 
parte se anche i documenti DocBook hanno l'estensione .sgml un motivo ci 
sarà  ;-)
Ho controllato anche altri documenti, come ad esempio quelli su  TLDP, 
anche quelli non sono giustificati.
Possibile ?
Ciao e grazie delle spiegazioni ne sai sempre una più del diavolo ;-)
Ferdinando

Possibile ?
"In the alphabet, all 26 of the letters appear in alphabetical order:
coincidence?".
Francamente, non ne ho la piu` pallida idea.
Ciao.

 esperti".
Ok, non intendo piů angustiarti con queste problematiche, perň, tanto per 
parlare ... 
Mi sembra, opinione personale, un'esigenza da non sottovalutare il fatto di 
avere a disposizione un formato che faccia ciň che promette, tanti formati, 
ognuno con i suoi difetti, capirei tanti programmi che offrono formati 
TUTTI funzionanti ma non cosě com'č. Ho chiesto anche ad altri, insomma, 
piů o meno hanno risposto come te, perň nessuno č stato in grado di 
mostrarmi un documento DocBook "giustificato", diamine, non penso di essere 
l'unico ad aver avuto questa esigenza, in compenso ho trovato molto 
interessante la documentazione a corredo del linguaggio Python :-)))
Non so se ti č capitato di vederla, ma č veramente esemplare (che 
probabilmente ruberň a mani basse ;-) )
Riassumendo, č stata costruita una classe "manual", create apposite 
directory e un makefile e da un semplice documento in LaTeX si ottengono 
"in automatico" tutti i formati, output in .html con colorazione delle 
parti di "codice" d'esempio, tabelle con intestazione colorate ecc.
Insomma, un ottimo esempio di come con il buon,caro e vecchio laTeX si 
possa ottenere tutto ciň che cercavo e anche di piů.
Inoltre si ha il vantaggio di poter creare documenti aventi lo stesso 
"aspetto", l'ideale per racchiudere un "filone/argomento". Senza poi 
contare la facilitŕ (rispetto a DocBook, LinuxDoc ecc.) con cui č possibile 
modificare la classe di riferimento, tutti i vari SGML sono 'semplici' se 
presi cosě come sono, ma 'metterci le mani' non č cosě semplice, molto piů 
facile modificare una classe LaTeX.
Ciao e grazie per i tuoi sempre utili consigli
Ferdinando 

l'unico ad aver avuto questa esigenza
DocBook DSSSL Stylesheet FAQ
Michael Wiedmann
....
Q: How do I get justified output?
A: Set the following in your customization stylesheet:
    (define %default-quadding% 'justify)
(the default stylesheet sets this to 'start, which means left-justified). 
....
Ciao.

(the default stylesheet sets this to 'start, which means left-justified). 
Per la precisione, con riferimento ai "DocBook DSSSL stylesheets"
distribuiti da Norman Walsh (che puoi trovare al seguente indirizzo:
http://sourceforge.net/project/showfiles.php?group_id=21935
), credo che sia
sufficiente intervenire nel(nei) file dbparam.dsl (non so dove sia, ma
immagino un /usr/share/qualchecosa): cerca la riga
  ;; REFERENCE Quadding
e modifichi %default-quadding% o il quadding relativo all'elemento che ti
interessa.
Questo, sempre se usi Jade. Con XSL non so (ancora). Da qui:
http://docbook.org/wiki/moin.cgi/DocBookPublishingTools
 in  poi, comunque,
trovi tutte le informazioni che ti servono.
Ciao.

facile modificare una classe LaTeX.
Quelli di Python vogliono comunque passare ad usare SGML per la loro
documentazione.
-- 
Marco Barisione (ICQ 84277092)

Giovanni Zezza wrote:

WoW !
Grazie mille, purtroppo la mia non conoscenza dell'Inglese mi impedisce 
spesso di scovare informazioni utili ... se ho a disposizione il documento 
dove sono sicuro di trovare le informazioni che mi servono, tra 
vocabolario, tentativi ecc. mi arrangio, ma fino ad un certo punto, poi 
passo :-(
Comunque adesso tento ad applicare le modifiche che mi hai suggerito, mi 
hai salvato ...
Ciao, ancora grazie
Ferdinando

Marco Barisione wrote:

Ciao Marco, mi sa che io e te ci dobbiamo sentire in privato, sto 
convertendo in DocBook due documenti in Italiano, uno è il manuale 
dell'OSKIT e non so se arriverò alla fine perchè è enorme ... l'altro è il 
Tutorial for non programmers di Cogliati, che conoscerai, visto che sei 
iscritto anche tu alla lista Python (e moderatore del ng :-) .
Quindi, visto che anche tu avevi avuto perplessità su LaTeX2html e 
"bazzichi" sicuramente più di me in Python, ho il sospetto che mi "dovrai" 
aiutare ....
Ciao
Ferdinando