Beyond Linux® From Scratch (systemd Utgave) - Versjon r13.0-1090

Kapittel 49. Utvidbart Merkespråk (XML)

docbook-xml-4.5

Introduksjon til DocBook-4.5 XML DTD

DocBook-4.5 XML DTD-4.5 pakken inneholder dokumenttypedefinisjoner for verifisering av XML data filer mot DocBook regelsettet. Disse er nyttige for strukturering av bøker og programvaredokumentasjon til en standard som lar deg bruke transformasjoner som allerede er skrevet for den standarden.

[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

DocBook-4.5 XML DTD Avhengigheter

Påkrevd

libxml2-2.15.3

Installasjon av DocBook-4.5 XML DTD

[Notat]

Notat

Pakkekilden er distribuert i zip formatet, og du kan bruke python3 -m zipfile -e <navn>.zip <navn> kommandoen for å pakke den ut. Den siste parameteren, <navn>, sørger for å pakke ut innholdet i zip arkivet til mappen med navnet <navn> (den vil bli opprettet automatisk hvis den ikke finnes ennå), så etter at pakken er installert, vil fjerningen av kildefilene være enklere.

Installer DocBook XML DTD ved å kjøre følgende kommandoer som root bruker: 

install -v -d -m755 /usr/share/xml/docbook/xml-dtd-4.5 &&
install -v -d -m755 /etc/xml                           &&
cp -v -af --no-preserve=ownership                      \
    catalog.xml docbook.cat *.dtd ent/ *.mod           \
    /usr/share/xml/docbook/xml-dtd-4.5

Den medfølgende catalog.xml filen håndterer de formelle offentlige identifikatorene til DocBook-4.5 XML DTD-en. Vi må legge til noen oppføringer i installasjonen for å håndtere URL-ene til DTD-en også, ved å kjøre følgende kommandoer som root bruker: 

xmlcatalog --noout --add "rewriteSystem"        \
    "http://www.oasis-open.org/docbook/xml/4.5" \
    "file:///usr/share/xml/docbook/xml-dtd-4.5" \
    /usr/share/xml/docbook/xml-dtd-4.5/catalog.xml &&

xmlcatalog --noout --add "rewriteURI"           \
    "http://www.oasis-open.org/docbook/xml/4.5" \
    "file:///usr/share/xml/docbook/xml-dtd-4.5" \
    /usr/share/xml/docbook/xml-dtd-4.5/catalog.xml

Opprett (eller oppdater) og fyll ut /etc/xml/catalog katalogfilen ved å kjøre følgende kommandoer som root bruker: 

if [ ! -e /etc/xml/catalog ]; then
    xmlcatalog --noout --create /etc/xml/catalog
fi &&

xmlcatalog --noout --add "delegatePublic"                   \
    "-//OASIS//ENTITIES DocBook XML"                        \
    "file:///usr/share/xml/docbook/xml-dtd-4.5/catalog.xml" \
    /etc/xml/catalog                                        &&

xmlcatalog --noout --add "delegatePublic"                   \
    "-//OASIS//DTD DocBook XML"                             \
    "file:///usr/share/xml/docbook/xml-dtd-4.5/catalog.xml" \
    /etc/xml/catalog                                        &&

xmlcatalog --noout --add "delegateSystem"                   \
    "http://www.oasis-open.org/docbook/"                    \
    "file:///usr/share/xml/docbook/xml-dtd-4.5/catalog.xml" \
    /etc/xml/catalog                                        &&

xmlcatalog --noout --add "delegateURI"                      \
    "http://www.oasis-open.org/docbook/"                    \
    "file:///usr/share/xml/docbook/xml-dtd-4.5/catalog.xml" \
    /etc/xml/catalog

Konfigurere DocBook-4.5 XML DTD

Konfigurasjonsfiler

/etc/xml/catalog

Konfigurasjonsinformasjon

[Obs]

Obs

Ulike BLFS pakker forespør DocBook XML DTD versjon 4.x før V4.5, så følgende trinn må gjøres for at disse pakkene skal bygges med suksess.

Installasjonen ovenfor oppretter filene og oppdaterer katalogene. For å utnytte DocBook XML DTD V4.5 når en hvilken som helst versjon 4.x er forespurt i System Identifikator, du må legge til flere utsagn i katalogfiler. Hvis du har noen av DocBook XML DTD referert nedenfor allerede installert på ditt system, fjern disse oppføringene før kommandoene nedenfor (utsted kommandoene som root bruker): 

for DTDVERSION in 4.1.2 4.2 4.3 4.4
do
  xmlcatalog --noout --add "public"                                  \
    "-//OASIS//DTD DocBook XML V$DTDVERSION//EN"                     \
    "http://www.oasis-open.org/docbook/xml/$DTDVERSION/docbookx.dtd" \
    /usr/share/xml/docbook/xml-dtd-4.5/catalog.xml

  xmlcatalog --noout --add "rewriteSystem"              \
    "http://www.oasis-open.org/docbook/xml/$DTDVERSION" \
    "file:///usr/share/xml/docbook/xml-dtd-4.5"         \
    /usr/share/xml/docbook/xml-dtd-4.5/catalog.xml
  
  xmlcatalog --noout --add "rewriteURI"                 \
    "http://www.oasis-open.org/docbook/xml/$DTDVERSION" \
    "file:///usr/share/xml/docbook/xml-dtd-4.5"         \
    /usr/share/xml/docbook/xml-dtd-4.5/catalog.xml
done

Innhold

Installerte Programmer: Ingen
Installerte Biblioteker: Ingen
Installerte Filer: DTD, MOD og ENT filer
Installerte Mapper: /etc/xml og /usr/share/xml/docbook/xml-dtd-4.5

Korte Beskrivelser

DTD filer

inneholder en dokumenttypedefinisjon som definerer elementtyper og attributtlistene som kan brukes i de tilsvarende XML filene

MOD files

inneholder komponenter av dokumenttypedefinisjonen som er hentet inn i DTD filer

ENT files

inneholder lister over navngitte karakterenheter som er tillatt i HTML