DocBook XSL Stylesheets-1.67.2

Introduzione a DocBook XSL Stylesheets

Il pacchetto DocBook XSL Stylesheets contiene fogli di stile XSL. Questi sono utili per eseguire trasformazioni su file DocBook XML.

Informazioni sul pacchetto

Dipendenze per DocBook XSL Stylesheets

Necessarie

libxslt-1.1.12

Installazione di DocBook XSL Stylesheets

Installare DocBook XSL Stylesheets eseguendo i seguenti comandi:

install -d /usr/share/xml/docbook/xsl-stylesheets-1.67.2 &&
chown -R root:root . &&
cp -af INSTALL VERSION common eclipse extensions fo html htmlhelp \
    images javahelp lib manpages params profiling template xhtml \
    /usr/share/xml/docbook/xsl-stylesheets-1.67.2 &&
install -d /usr/share/doc/xml &&
cp -af doc/* /usr/share/doc/xml &&
cd /usr/share/xml/docbook/xsl-stylesheets-1.67.2 &&
sh INSTALL &&
if [ ! -f /etc/xml/catalog ]; then mkdir -p /etc/xml; xmlcatalog \
    --noout --create /etc/xml/catalog; fi &&
if [ ! -e /etc/xml/docbook ]; then xmlcatalog --noout --create \
    /etc/xml/docbook; fi &&
xmlcatalog --noout --add "rewriteSystem" \
    "http://docbook.sourceforge.net/release/xsl/1.67.2" \
    "/usr/share/xml/docbook/xsl-stylesheets-1.67.2" /etc/xml/catalog &&
xmlcatalog --noout --add "rewriteURI" \
    "http://docbook.sourceforge.net/release/xsl/1.67.2" \
    "/usr/share/xml/docbook/xsl-stylesheets-1.67.2" /etc/xml/catalog &&
xmlcatalog --noout --add "delegateSystem" \
    "http://docbook.sourceforge.net/release/xsl/" \
    "file:///etc/xml/docbook" /etc/xml/catalog &&
xmlcatalog --noout --add "delegateURI" \
    "http://docbook.sourceforge.net/release/xsl/" \
    "file:///etc/xml/docbook" /etc/xml/catalog

Spiegazioni dei comandi

sh INSTALL: questo comando crea un catalogo locale per i file XSL.

Configurazione di DocBook XSL Stylesheets

File di configurazione

/etc/xml/catalog

Informazioni di configurazione

Il profilo di sistema deve essere aggiornato per poter utilizzare il nuovo catalogo installato. Ciò può esser fatto con il seguente comando:

cat > /etc/profile.d/xsl.sh << "EOF"
# Set up Environment Variable for XSL Processing
export XML_CATALOG_FILES="/usr/share/xml/docbook/\
xsl-stylesheets-1.67.2/catalog.xml /etc/xml/catalog"
EOF

Il succitato script di installazione crea i file e aggiorna il catalogo. Alcuni progetti di fogli di stile fanno riferimenti a specifiche versioni dei folgi di stile XSL, come BLFS, che richiede i seguenti comandi aggiuntivi. Questi comandi possono anche servire da esempio per utilizzare una singola versione di XSL per supportare altre versioni personalizzate, a seconda delle necessità.

xmlcatalog --noout --add "rewriteSystem" \
    "http://docbook.sourceforge.net/release/xsl/1.65.1" \
    "/usr/share/xml/docbook/xsl-stylesheets-1.67.2" \
    /etc/xml/catalog &&
xmlcatalog --noout --add "rewriteURI" \
    "http://docbook.sourceforge.net/release/xsl/1.65.1" \
    "/usr/share/xml/docbook/xsl-stylesheets-1.67.2" \
    /etc/xml/catalog

In alternativa, si possono installare altre versioni nelle ripsettive directory di versione creando le entrate nel catalogo nella seguente forma:

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
[Nota]

Nota

Per usare XSL Stylesheets con GTK-Doc, ed eventualmente con altri pacchetti, è richiesta una versione "corrente" invece che uno specifico numero di versione. In questo caso, utilizzare le seguenti istruzioni:

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

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

Questo è uno stratagemma che può funzionare o meno per altri pacchetti che potrebbero richiedere una versione "corrente" di catalogo.

Per LFS 6.0, dovrebbe essere installata la versione 1.65.1 di questo pacchetto. Inoltre è necessario un link simbolico come descritto nel file INSTALL di LFS 6.0.

cd /usr/share/xml/docbook/ &&
ln -s xsl-stylesheets-1.65.1 xsl-stylesheets-current

Contenuti

File installati: XSL style sheet per HTML e FO
Directory installate: /usr/share/xml/docbook/xsl-stylesheets-1.67.2 e /usr/share/doc/xml

Last updated on