Beyond Linux® From Scratch (Edição System V) - Versão 12.4

Capítulo 48. Standard Generalized Markup Language (SGML)

DocBook-utils-0.6.14

Introdução ao DocBook-utils

O pacote DocBook-utils é uma coleção de conjuntos de comandos sequenciais utilitários usados para converter e analisar documentos SGML em geral, e arquivos DocBook em particular. Os conjuntos de comandos sequenciais são usados para converter DocBook ou outros formatos SGML em formatos de arquivo “clássicos”, como HTML, man, info, RTF e muitos mais. Existe também um utilitário para comparar dois arquivos SGML e exibir somente as diferenças na marcação. Isso é útil para comparar documentos preparados para diferentes idiomas.

Esse pacote é conhecido por construir e funcionar corretamente usando uma plataforma LFS 12.4.

Informação do Pacote

Transferências Adicionais

Dependências do DocBook-utils

Exigidas

OpenJade-1.3.2, docbook-dsssl-1.79 e docbook-3.1-dtd

Recomendadas (dependências somente de tempo de execução)

SGMLSpm-1.1 (para conversão para manual e texinfo) e Lynx-2.9.2 ou Links-2.30 ou W3m (para conversão para texto ASCII)

Instalação do DocBook-utils

Instale o DocBook-utils executando os seguintes comandos: 

patch -Np1 -i ../docbook-utils-0.6.14-grep_fix-1.patch &&
sed -i 's:/html::' doc/HTML/Makefile.in                &&

./configure --prefix=/usr --mandir=/usr/share/man      &&
make

Esse pacote não vem com uma suíte de teste.

Agora, como o(a) usuário(a) root: 

make docdir=/usr/share/doc install

Muitos pacotes usam um nome alternativo para os conjuntos de comandos sequenciais DocBook-utils. Se você desejar criar esses nomes alternativos, use o seguinte comando como o(a) usuário(a) root: 

for doctype in html ps dvi man pdf rtf tex texi txt
do
    ln -svf docbook2$doctype /usr/bin/db2$doctype
done
[Nota]

Nota

O conjunto de comandos sequenciais jw usa o comando which para localizar os utilitários exigidos. Você precisa instalar o Which-2.23 antes de tentar usar qualquer um dos aplicativos DocBook-utils.

Explicações do Comando

patch -Np1 -i ../docbook-utils-0.6.14-grep_fix-1.patch: Esse remendo corrige a sintaxe no conjunto de comandos sequenciais jw (Jade Wrapper), o qual está no centro de grande parte do processamento do db2*, de forma que a versão atual do grep não o rejeitará.

sed -i 's:/html::' doc/HTML/Makefile.in: Esse comando muda o diretório de instalação dos documentos HTML.

docdir=/usr/share/doc: Essa opção é colocada na linha make install porque não é reconhecida pelo configure.

Conteúdo

Aplicativos Instalados: docbook2dvi, docbook2html, docbook2man, docbook2pdf, docbook2ps, docbook2rtf, docbook2tex, docbook2texi, docbook2txt, jw e sgmldiff
Bibliotecas Instaladas: Nenhum(a)
Diretórios Instalados: /usr/share/doc/docbook-utils-0.6.14 e /usr/share/sgml/docbook/utils-0.6.14
Links Simbólicos Instalados: db2dvi, db2html, db2man, db2pdf, db2ps, db2rtf, db2tex, db2texi e db2txt

Descrições Curtas

docbook2*

são conjuntos de comandos sequenciais envolucradores simples de uma linha para jw. Eles são fornecidos como nomes fáceis de lembrar usados para converter DocBook ou outros arquivos SGML para o respectivo formato

db2*

são links simbólicos apontando para os comandos docbook2* respectivamente nomeados, criados para satisfazer o uso desses nomes por alguns aplicativos

jw

é um conjunto de comandos sequenciais usado para converter DocBook ou outros arquivos SGML para vários formatos de saída. Eles escondem a maior parte da complexidade do OpenJade e adiciona recursos confortáveis

sgmldiff

é usado para comparar dois arquivos SGML e retornar somente as diferenças na marcação. Isso é especialmente útil para comparar arquivos que deveriam ser idênticos, exceto pelas diferenças linguísticas no conteúdo