A filosofia entre os dois sistemas é bem diferente e é ela o principal motivo pelo qual o Departamento de Publicações trocou sua linguagem de marcação.
Como explicado anteriormente, o LaTeX é otimizado para a geração de documentos impressos, permitindo um ajuste fino para, por exemplo, um livro. Não há uma preocupação por parte do sistema TeX (LaTeX, AMSTeX, etc.) em gerar uma saída diferente da impressa, mas isso não reflete os anseios de seus usuários, portanto há programas que visam realizar essa troca.
Já a preocupação de sistemas SGML é com a descrição dos elementos presentes no texto. A otimização é feita para ter-se o máximo de elementos possíveis descritos de uma maneira coerente e que possa ser usada para destacar ou facilitar a procura de informações.
Descrevendo-se o máximo possível de elementos podemos fazer estatísticas de uso de comandos, prompts usados, exemplos dados, etc. Vamos comparar duas estruturas:
Exemplo 1. Código em LaTeX
\chapter{Projetos de Documentação Existentes Para o Linux} \label{cap:ldp} \index{LDP} \noindent \section{LDP - Projeto de Documentação do Linux} A LDP (Linux Documentation Project) é um projeto que visa documentar o Linux. É sabido que os programadores não são muito fãs de escrever o que fazem. Se você quer saber algo, basta olhar o código, certo? Bem... seria se todos fôssemos programadores e todos tivéssemos a mesma familiaridade com a programação. O projeto LDP visa documentar em linguagem leiga ou técnica os programas e torná-los acessíveis para os que não sabem programar ou não têm tempo de olhar o código mas possuem um mínimo de conhecimentos técnicos. %LDP - criada há muito tempo para documentar o Linux. Sítio oficial:~\url{http://www.linuxdoc.org}. |
Este exemplo está presente no Guia do Usuários do Conectiva Linux 5.0. Se tivesse sido marcado com DocBook teríamos:
Exemplo 2. Código em DocBook
<chapter id="cap-ldp"> <title>Projetos de Documentação Existentes Para o Linux</title> <indexterm> <primary>LDP</primary> </indexterm> <section> <title>LDP - Projeto de Documentação do Linux</title> <para>A <acronym>LDP</acronym> (<foreignphrase lang="en">Linux Documentation Project</foreignphrase>) é um projeto que visa documentar o <application>Linux</application>. É sabido que os programadores não são muito fãs de escrever o que fazem. Se você quer saber algo, basta olhar o código, certo? Bem... seria se todos fôssemos programadores e todos tivéssemos a mesma familiaridade com a programação. O projeto <acronym>LDP</acronym> visa documentar em linguagem leiga ou técnica os programas e torná-los acessíveis para os que não sabem programar ou não têm tempo de olhar o código mas possuem um mínimo de conhecimentos técnicos.</para> <!-- LDP - criada há muito tempo para documentar o Linux. --> <para>Sítio oficial: <ulink url="http://www.linuxdoc.org">http://www.linuxdoc.org</ulink></para> </section> </chapter> |
Reparem que já temos condições de dar um tratamento diferenciado para, por exemplo, a palavra LDP e também para a sua explicação que pode, inclusive, receber o tratamento correto quanto a divisão silábica do inglês e uma fonte diferenciada para destacá-la do restante do texto.
As utilidades e diferenças aparecem mais ainda quando se descreve, por exemplo, códigos de programa. O LaTeX não possui um ambiente onde seja preservada a aparência do que ali foi escrito e sejam tratados comandos LaTeX ao mesmo tempo. O DocBook já possui essa facilidade e foi através dela que montei o código acima.
Exemplo 3. Marcando códigos de programas com DocBook
#include <stdio.h>
|
As únicas marcações adicionadas ao código acima são no que diz respeito à prototipação da função main e de seus parâmetros. Ainda marquei os "defines" e seus valores, para termos um possível destaque nesse ponto.