Beyond Linux® From Scratch (System V Utgave) - Versjon 12.1

Chapter 48. Standard Generalisert Markeringsspråk (SGML)

DocBook-utils-0.6.14

Introduksjon til DocBook-utils

DocBook-utils pakken er en samling av verktøyskript som brukes til å konvertere og analysere SGML dokumenter generelt, og DocBook filer spesielt. Skriptene brukes til å konvertere fra DocBook eller andre SGML formater til “klassiske” filformater som HTML, man, info, RTF og mange flere. Det er også et verktøy for å sammenligne to SGML filer og viser bare forskjellene i markeringene. Dette er nyttig for å sammenligne dokumenter utarbeidet for forskjellige språk.

Denne pakken er kjent for å bygge og fungere riktig ved å bruke en LFS 12.1 plattform.

Pakkeinformasjon

Ytterligere Nedlastinger

DocBook-utils Avhengigheter

Påkrevd

OpenJade-1.3.2, docbook-dsssl-1.79, og docbook-3.1-dtd

Anbefalt (Kun kjøretidsavhengigheter)

SGMLSpm-1.1 (for konvertering til man og texinfo), og Lynx-2.8.9rel.1 eller Links-2.29 eller W3m (for konvertering til ASCII text)

Installasjon av DocBook-utils

Installer DocBook-utils ved å kjøre følgende kommandoer: 

patch -Np1 -i ../docbook-utils-0.6.14-grep_fix-1.patch &&
sed -i 's:/html::' doc/HTML/Makefile.in                &&

./configure --prefix=/usr --mandir=/usr/share/man      &&
make

Denne pakken kommer ikke med en testpakke.

Nå, som root bruker: 

make docdir=/usr/share/doc install

Mange pakker bruker et alternativt navn for DocBook-utils skript. Hvis du ønsker å lage disse alternative navnene, bruk følgende kommando som root bruker: 

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

Note

jw skriptet bruker which kommando for å finne nødvendige verktøy. Du må installere Which-2.21 før du prøver å bruke noen av DocBook-utils programmene.

Parameterforklaringer

patch -Np1 -i ../docbook-utils-0.6.14-grep_fix-1.patch: Denne oppdateringen korrigerer syntaksen i jw (Jade Wrapper) skriptet som er i hjertet av mye db2* behandling, slik at den nåværende versjonen av grep ikke vil avvise det.

sed -i 's:/html::' doc/HTML/Makefile.in: Denne kommandoen endrer installasjonsmappen til HTML dokumentene.

docdir=/usr/share/doc: Dette alternativet er plassert på make install linjen fordi den ikke er gjenkjent av configure.

Innhold

Installerte Programmer: docbook2dvi, docbook2html, docbook2man, docbook2pdf, docbook2ps, docbook2rtf, docbook2tex, docbook2texi, docbook2txt, jw, og sgmldiff
Installerte Biblioteker: Ingen
Installerte Mapper: /usr/share/doc/docbook-utils-0.6.14 og /usr/share/sgml/docbook/utils-0.6.14
Installerte Symbolkoblinger: db2dvi, db2html, db2man, db2pdf, db2ps, db2rtf, db2tex, db2texi, og db2txt

Korte Beskrivelser

docbook2*

er enkel en-linjes innpakningsskript til jw. De er gitt som navn som er enkle å huske og brukes til å konvertere DocBook eller andre SGML filer til det respektive formatet

db2*

er symbolkoblinger som peker på de respektive navngitte docbook2* kommandoer, laget for å tilfredsstille noen programmers bruk av disse navnene

jw

er et skript som brukes til å konvertere DocBook eller andre SGML filer til forskjellige utdataformater. Den skjuler det meste av OpenJade sin kompleksitet og legger til komfortable funksjoner

sgmldiff

brukes til å sammenligne to SGML filer og bare returnere forskjellene i markeringen. Dette er spesielt nyttig for å sammenligne filer som skal være identisk bortsett fra språkforskjeller i innholdet