Beyond Linux® From Scratch (systemd Utgave) - Versjon -wip

Kapittel 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.

[Notat]

Notat

Utviklingsversjoner av BLFS kan kanskje ikke bygge eller kjøre noen pakker riktig hvis LFS eller avhengigheter har blitt oppdatert siden de siste stabile versjonene av bøkene.

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.9.2 eller Links-2.30 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
[Notat]

Notat

jw skriptet bruker which kommando for å finne nødvendige verktøy. Du må installere Which-2.23 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