3. Los HOWTO

Los HOWTO son unos documentos mßs breves que los manuales, centrados en alg·n asunto determinado (como puede ser la instalaci≤n de un determinado tipo de hardware en Linux). Son extremadamente ·tiles (como ya debe haber comprobado el lector mßs de una vez) lo que ha motivado la ``formalizaci≤n'' de su estructura frente a la ``anarquφa'' de los primeros documentos.

La herramienta que debe usarse hoy en dφa para su composici≤n es el sistema linuxdoc, un sistema basado en el lenguaje SGML (Standard Generalized Markup Language), del que ahora mismo existe ya una versi≤n, la 1.5, que soporta los caracteres espa±oles seg·n las tablas ISO 8859-1 (que son las que usa Linux, cualquier Unix e incluso Windows, puesto que ahora mismo solo MS-DOS u OS/2 usan las clßsicas tablas del IBM-PC, que contrariamente a lo que se piensa no son, ni mucho menos, un estßndar de futuro).

3.1 Instalaci≤n de linuxdoc-SGML

Se puede obtener linuxdoc-sgml-1.5.tar.gz de diversas fuentes, destacando el servidor FTP del autor del sistema: ftp://ftp.cc.gatech.edu/pub/people/gregh/linuxdoc-sgml/linuxdoc-sgml-1.5.tar.gz.

Antes de instalarlo es recomendable tener ya en nuestro sistema algunas herramientas, como groff, LaTeX y gawk.

A continuaci≤n se puede desempaquetar linuxdoc-sgml-1.5.tar.gz en alg·n directorio de acceso p·blico, y compilarlo siguiendo las instrucciones del fichero INSTALL que contiene el paquete. Para ello, serß preciso tener instalado las herramientas de desarrollo en C (gcc y demßs).

3.2 Peque±a introducci≤n a SGML

Existe un HOWTO escrito, por supuesto, en SGML, que describe con elevada claridad c≤mo se usa linuxdoc-SGML. Su autor es Matt Welsh y desde hace poco se encuentra traducido por Francisco J. Montilla (ver el final de este documento). Por lo tanto, aquφ solo veremos algunas guφas de traducci≤n de documentos en SGML.

Los comandos SGML son un superconjunto de los de HTML, el lenguaje mßs utilizado para los documentos del World Wide Web, por lo que si conoce este sencillo lenguaje, pocas cosas nuevas tendrß que aprender.

Los comandos van todos encerrados entre </ y >. Algunos usuales son </p>, para cambiar de pßrrafo, </sect> para hacer una nueva secci≤n, </sect1> para abrir una subsecci≤n, etc.

El procesamiento de un documento .sgml se hace con los comandos:

    % sgml2txt -l fichero.sgml           (producir texto ASCII)
    % sgml2latex -l fichero.sgml         (producir fuente LaTeX)
    % sgml2html -l fichero.sgml          (producir ficheros HTML)

Para procesar los ficheros .tex, recomendamos hacer un enlace simb≤lico desde el directorio /usr/lib/linuxdoc-sgml-lib/ a /usr/lib/texmf/tex/latex/linuxdoc-sgml para no tener problemas.

Hay otros formatos, pero creemos que los tres anteriores serßn los mßs usuales. Insistimos en remitirle a la excelente traducci≤n de Francisco J. Montilla para saber mßs.