Beyond Linux® From Scratch (Edição systemd ) - Versão 13.0

Capítulo 49. Linguagem Extensível de Marcação (XML)

docbook-xml-4.5

Introdução ao DocBook-4.5 XML DTD

O pacote DocBook-4.5 XML DTD-4.5 contém definições de tipo de documento para verificação de arquivos de dados XML em relação ao conjunto de regras do DocBook. Elas são úteis para estruturar livros e documentação de software em um padrão, permitindo que você utilize transformações já escritas para esse padrão.

[Nota]

Nota

Esse pacote é conhecido por construir e funcionar adequadamente usando-se uma plataforma LFS 13.0.

Informação do Pacote

  • Transferência (HTTP): https://archive.docbook.org/xml/4.5/docbook-xml-4.5.zip

  • Transferência (FTP):

  • Soma de verificação MD5 da transferência: 03083e288e87a7e829e437358da7ef9e

  • Tamanho da transferência: 96 KB

  • Espaço em disco estimado exigido: 1,2 MB

  • Tempo de construção estimado: menos que 0,1 UPC

Dependências do DocBook-4.5 XML DTD

Exigidas

libarchive-3.8.5 e libxml2-2.15.1

Instalação do DocBook-4.5 XML DTD

[Nota]

Nota

O fonte do pacote é distribuído no formato zip e exige o unzip (na verdade, um link simbólico para bsdunzip proveniente da libarchive). Você deveria criar um diretório e mudar para esse diretório antes de descompactar o arquivo para facilitar a remoção dos arquivos do fonte depois que o pacote tiver sido instalado.

Instale o DocBook XML DTD executando os seguintes comandos como o(a) usuário(a) root: 

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

O arquivo catalog.xml enviado manuseia os identificadores públicos formais do DTD XML do DocBook-4.5. Nós precisamos adicionar algumas entradas na instalação dele para lidar também com as URLs do DTD, executando os seguintes comandos como o(a) usuário(a) root: 

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

Crie (ou atualize) e povoe o arquivo de catálogo /etc/xml/catalog executando os seguintes comandos como o(a) usuário(a) root: 

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

Configurando a DTD XML do DocBook-4.5

Arquivos de Configuração

/etc/xml/catalog

Informação de Configuração

[Cuidado]

Cuidado

Vários pacotes do BLFS solicitam a versão 4.x do DocBook XML DTD antes da V4.5, de forma que a etapa a seguir precisa ser feita para que esses pacotes sejam construídos com sucesso.

A instalação acima cria os arquivos e atualiza os catálogos. Para a finalidade de utilizar a V4.5 do DocBook XML DTD quando qualquer versão 4.x for solicitada no Identificador do Sistema, você precisa adicionar declarações adicionais aos arquivos de catálogo. Se você tiver algum dos DocBook XML DTD mencionados abaixo já instalados em teu sistema, remova essas entradas do comando for abaixo (emita os comandos como o(a) usuário(a) root): 

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

Conteúdo

Aplicativos Instalados: Nenhum(a)
Bibliotecas Instaladas: Nenhum(a)
Arquivos Instalados: Arquivos DTD, MOD e ENT
Diretórios Instalados: /etc/xml e /usr/share/xml/docbook/xml-dtd-4.5

Descrições Curtas

Arquivos DTD

contém uma definição de tipo de documento que define os tipos de elementos e as listas de atributos que podem ser usados nos arquivos XML correspondentes

Arquivos MOD

contêm componentes da definição do tipo de documento que são carregados nos arquivos DTD

Arquivos ENT

contém listas de entidades nomeadas de caracteres permitidas em HTML