Beyond Linux From Scratch - Versione 6.0

Capitolo 43. Standard Generalized Markup Language (SGML)

DocBook-utils-0.6.14

Introduzione a DocBook-utils

Il pacchetto DocBook-utils è una raccolta di script di utilità usati per convertire e analizzare documenti SGML in generale, e file DocBook in particolare. Gli script sono usati per convertire da DocBook o altri formati SGML in formati di file “classici” come HTML, pagine man, info, RTF e moltri altri. C'è anche un'utilità per confrontare due file SGML e mostrare solo le differenze nei marcatori. Ciò è utile per confrontare documenti preparati per lingue diverse.

Informazioni sul pacchetto

Dipendenze per DocBook-utils

Necessarie

OpenJade-1.3.2, DocBook DSSSL Stylesheets-1.78 e DocBook SGML DTD-3.1

Opzionali

JadeTeX-3.13 (per conversioni in DVI, PS e PDF), Perl modules: SGMLSpm-1.03ii (per conversioni in pagine man e texinfo), e Lynx-2.8.5 o Links-2.1pre15 o w3m (per conversioni in testo ASCII)

Installazione di DocBook-utils

[Nota]

Nota

Precedenti versioni delle istruzioni OpenSP BLFS installavano un catalogo contenente il file di dichiarazione SGMLDECL unicode.sd fra i cataloghi di sistema SGML. Questa dichiarazione provoca occasionalmente il fallimento di alcuni dei programmi OpenJade. Sarà necessario rimuovere queste definizioni se esistono, o la costruzione del pacchetto fallirà. Il seguente comando può determianre se è necessario rimuovere queste definizioni di catalogo: 

grep "OpenSP-1.5.1" /etc/sgml/catalog

Se non viene restituito niente, eseguire il seguente comando come utente root per rimuovere le definizioni di catalogo: 

sed -i.orig \
    -e "/CATALOG \/etc\/sgml\/OpenSP-1.5.1.cat/d" \
    /etc/sgml/catalog \
    /etc/sgml/sgml-docbook.cat

Installare DocBook-utils eseguendo i seguenti comandi: 

./configure --prefix=/usr &&
make

Ora, come utente: 

make install

Molti pacchetti usano un nome alternativo per gli script DocBook-utils. Se si desidera creare questi nomi alternativi, usare il seguente comando: 

for doctype in html ps dvi man pdf rtf tex texi txt
do
    ln -s docbook2$doctype /usr/bin/db2$doctype
done

Contenuti

Programmi installati: docbook2dvi, docbook2html, docbook2man, docbook2pdf, docbook2ps, docbook2rtf, docbook2tex, docbook2texi, docbook2txt, jw e sgmldiff
Librerie installate: Nessuna
Directory installate: /usr/share/doc/html/docbook-utils-0.6.14 e /usr/share/sgml/docbook/utils-0.6.14
Link simbolici installati: db2dvi, db2html, db2man, db2pdf, db2ps, db2rtf, db2tex, db2texi e db2txt

Brevi descrizioni

docbook2*

sono semplici script wrapper di una linea per jw. Sono dati come nomi facili da ricordare per convertire file DocBook o altri file SGML nel rispettivo formato.

db2*

sono link simbolici che puntano ai rispettivi comandi docbook2*, creati per soddisfare l'uso di questi nomi da parte di alcuni programmi.

jw

è uno script usato per convertire file DocBook o altri file SGML in vari formati output. Nasconde la maggior parte della complessità di OpenJade e aggiunge comode funzionalità.

sgmldiff

è usato per confrontare due file SGML e restituire solo le differenze nei marcatori. Ciò è particolarmente utile per confrontare file che potrebbero essere identici tranne che per le differenze di lingua nel contenuto.

Last updated on