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

Kapittel 49. Utvidbart Merkespråk (XML)

docbook-xsl-nons-1.79.2

Introduksjon til DocBook XSL Stilark

DocBook XSL Stilark pakken inneholder XSL stilark. Disse er nyttige for å utføre transformasjoner på XML DocBook filer.

[Notat]

Notat

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

Pakkeinformasjon

Ytterligere Nedlastinger

Valgfri dokumentasjon

DocBook XSL Stilark Avhengigheter

Anbefalt (ved kjøretid)

libxml2-2.13.5

Valgfri (alle brukt under kjøring)

apache-ant-1.10.15 (å produsere «webhelp» dokumenter), libxslt-1.1.42 (eller en hvilken som helst annen XSLT prosessor), for å behandle Docbook dokumenter, Ruby-3.3.6 (for å bruke «epub» stilark), Zip-3.0 (for å produsere «epub3» dokumenter), og Saxon6 og Xerces2 Java (brukt med apache-ant-1.10.15 for å produsere «webhelp» dokumenter)

Installasjon av DocBook XSL Stilark

Først, fiks et problem som forårsaker stabeloverflyt når du gjør rekursjon: 

patch -Np1 -i ../docbook-xsl-nons-1.79.2-stack_fix-1.patch

Hvis du lastet ned den valgfrie dokumentasjonens tarball, pakk den ut med følgende kommando: 

tar -xf ../docbook-xsl-doc-1.79.2.tar.bz2 --strip-components=1

BLFS installerer ikke de nødvendige pakkene for å kjøre testpakken og gi meningsfulle resultater.

Installer DocBook XSL Stilark ved å kjøre følgende kommandoer som root bruker: 

install -v -m755 -d /usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2 &&

cp -v -R VERSION assembly common eclipse epub epub3 extensions fo        \
         highlighting html htmlhelp images javahelp lib manpages params  \
         profiling roundtrip slides template tests tools webhelp website \
         xhtml xhtml-1_1 xhtml5                                          \
    /usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2 &&

ln -s VERSION /usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2/VERSION.xsl &&

install -v -m644 -D README \
                    /usr/share/doc/docbook-xsl-nons-1.79.2/README.txt &&
install -v -m644    RELEASE-NOTES* NEWS* \
                    /usr/share/doc/docbook-xsl-nons-1.79.2

Hvis du lastet ned den valgfrie dokumentasjonens tarball, installer dokumentasjonen ved å utsted følgende kommando som root bruker: 

cp -v -R doc/* /usr/share/doc/docbook-xsl-nons-1.79.2

Konfigurere DocBook XSL Stilark

Konfigurasjonsfiler

/etc/xml/catalog

Konfigurasjonsinformasjon

Opprett (eller legg til) og fyll ut XML katalogfilen ved å bruke følgende kommandoer som root bruker (både http og https skjemaer brukes fordi oppstrøms har hatt begge i sin dokumentasjon): 

if [ ! -d /etc/xml ]; then install -v -m755 -d /etc/xml; fi &&
if [ ! -f /etc/xml/catalog ]; then
    xmlcatalog --noout --create /etc/xml/catalog
fi &&

xmlcatalog --noout --add "rewriteSystem" \
           "http://cdn.docbook.org/release/xsl-nons/1.79.2" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &&

xmlcatalog --noout --add "rewriteSystem" \
           "https://cdn.docbook.org/release/xsl-nons/1.79.2" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &&

xmlcatalog --noout --add "rewriteURI" \
           "http://cdn.docbook.org/release/xsl-nons/1.79.2" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &&

xmlcatalog --noout --add "rewriteURI" \
           "https://cdn.docbook.org/release/xsl-nons/1.79.2" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &&

xmlcatalog --noout --add "rewriteSystem" \
           "http://cdn.docbook.org/release/xsl-nons/current" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &&

xmlcatalog --noout --add "rewriteSystem" \
           "https://cdn.docbook.org/release/xsl-nons/current" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &&

xmlcatalog --noout --add "rewriteURI" \
           "http://cdn.docbook.org/release/xsl-nons/current" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &&

xmlcatalog --noout --add "rewriteURI" \
           "https://cdn.docbook.org/release/xsl-nons/current" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &&

xmlcatalog --noout --add "rewriteSystem" \
           "http://docbook.sourceforge.net/release/xsl/current" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &&

xmlcatalog --noout --add "rewriteURI" \
           "http://docbook.sourceforge.net/release/xsl/current" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog

Noen ganger kan du finne behov for å installere andre versjoner av XSL stilark ettersom noen prosjekter refererer til en spesifikk versjon. Et eksempel er BLFS-6.0, som krevde 1.67.2-versjonen. I disse forekomster bør du installere enhver annen nødvendig versjon i sin egen versjonert mappe og opprett katalogoppføringer som følger (erstatt ønsket versjonsnummer for <version>): 

xmlcatalog --noout --add "rewriteSystem" \
           "http://docbook.sourceforge.net/release/xsl/<version>" \
           "/usr/share/xml/docbook/xsl-stylesheets-<version>" \
    /etc/xml/catalog &&

xmlcatalog --noout --add "rewriteURI" \
           "http://docbook.sourceforge.net/release/xsl/<version>" \
           "/usr/share/xml/docbook/xsl-stylesheets-<version>" \
    /etc/xml/catalog

Innhold

Installerte Filer: /usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2/*/*.xsl
Installerte Mapper: /usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2 og /usr/share/doc/docbook-xsl-nons-1.79.2

Korte Beskrivelser

XSL Stilark

brukes til å utføre transformasjoner på XML filer