Beyond Linux From Scratch. Версия 6.0

Глава 44. Расширяемый язык разметки (XML )

DocBook XSL Stylesheets-1.67.2

Введение в DocBook XSL Stylesheets

Пакет DocBook XSL Stylesheets содержит XSL-стили оформления. Он полезен для выполнеия преобразований над XML-DocBook файлами.

Информация о пакете

Зависимости DocBook XSL Stylesheets

Требуемые

libxslt-1.1.12.

Установка DocBook XSL Stylesheets

Установим DocBook XSL Stylesheets запуском следующих команд:


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

Описание команд

sh INSTALL: Эта команда создает локальный каталог для файлов XSL.

Конфигурация DocBook XSL Stylesheets

Файлы конфигурации

/etc/xml/catalog.

Конфигурационная информация

Системный профиль должен быть обновлен для использования нового установленного каталога. Это может быть сделано при помощи следующей команды:


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

Вышеуказанный скрипт установки создает файлы и обновляет каталог. Некоторые стили оформления проекта ссылаются на особые версии стилей оформления XSL, например, BLFS и требуют следующие дополнительные команды. Эти команды также могут служить как пример для использования одиночной XSL-версии для поддержки любых жестко указанных версий, если необходимо.


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

Альтернативно, другие версии могут быть установлены в их собственные каталоги, а содержания каталогов сделаны в следующем виде:


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
[Замечание]

Замечание

Для использования XSL Stylesheets для GTK-Doc и, возможно, других пакетов, необходима текущая версия вместо особого номера версии. В таком случае используйте следующие инструкции:


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

Это обход, который может работать или нет для других пакетов, которым может понадобится текущая версия каталога.

Для LFS 6.0 должна быть установлена версия 1.65.1 этого пакета. В дополнение, надо сделать символическую ссылку, как описано в файле INSTALL LFS 6.0.


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

Содержание

Установленные файлы: XSL стили оформления для HTML и FO . Установленные каталоги: /usr/share/xml/docbook/xsl-stylesheets-1.67.2 и /usr/share/doc/xml.

Последнее обновление 2005-04-03 00:40:42 -0700.