¿Cómo escribir un documento en Linuxdoc-SGML?

Por Ismael Olea (olea@iname.com)
 

Introducción

Cómo debéis saber, el formato Linuxdoc-SGML es el formato oficial de la biblioteca de Howtos del LDP.

Igualmente lo es de la biblioteca oficial de «cómos» que mantiene Insflug y replica LuCAS.

Insflug no acepta más que documentos en este formato por una serie de motivos:

Podéis comprender que si no se edita con Linuxdoc-SGML, un «cómo» nunca tendrá tanta difusión, ya que no se beneficia de la red de réplicas a nivel mundial y que alcanza igualmente a todas y cada una de las distribuciones modernas merced a la red de replicación de Insflug.

Y no resta que documento no pueda ser categorizado como «cómo» para que no uséis Linuxdoc-SGML en su maquetación. Usándolo disfrutamos de la mayoría de las ventajas enumeradas anteriormente y facilitáis la labor a los administradores de Lucas.

Es importante señalar que el próximo formato estándar que usará el LDP en algún momento del futuro está igualmente basado en SGML y está asegurada la transición del antiguo formato (Linuxdoc-SGML) al que lo sucederá (DocBook).
 

¿Qué es Linuxdoc-SGML?

Linuxdoc-SGML es una aplicación de SGML.

SGML es un metalenguaje para la construcción de lenguajes de marcas.

HTML es un ejemplo, en sus diferentes versiones, de lenguaje de marcas creado con SGML.

Linuxdoc-SGML es, como HTML, otra aplicación SGML.

Linuxdoc-SGML está diseñado para la estructuración, mediante marcas, de documentos técnicos.

Desgraciadamente no está diseñado con exhaustivo rigor. Sin embargo es muy útil y su simplicidad hace que sea muy fácil de aprender y de usar.

El usuario típico de Linuxdoc-SGML hace uso de la herramienta SGMLtools que puede encontrarse en cualquier distribución conocida digna de ese nombre.

Pueden encontrarse versiones anteriores de SGMLtools con los nombres SGML-tools y Linuxdoc-SGML.

El kit SGMLtools incluye un analizador que sirve para comprobar que el documento escrito es correcto (osea, que se atiene perfectamente a la definición del lenguaje de marcas que se encuentra en el fichero linuxdoc-sgml.dtd).

Además, el kit dispone de un conjunto de programas que permiten exportar el documento a los diferentes formatos abiertos enumerados más arriba.

Para alguno de ellos puede necesitar otras herramientas típicas de un sistema GNU/Linux (groff, latex, etc).

Una vez que su documento está acabado y ha comprobado que el analizador de SGMLtools lo abala puede enviarlo a los coordinadores de Lucas o Insflug para proceder a su publicación.

Es MUY importante usar versiones 1.0.* de SGMLtools. Las versiones 2.0.* son para DocBook.dtd.

Puede encontrar SGMLtools en http://www.sgmltools.org.
 

¿Cómo aprender Linuxdoc-SGML?

Insisto en que es muy fácil aprender a usarlo. Y muy recomendable puesto que la herramienta podemos usarla para nuestros propios documentos prescindiendo de otras herramientas, conocidas de todos, que acaban siendo bastante más difíciles de usar.

Asegúrate que tienes ya instalado en tu sistema el paquete SGMLtools. Insisto en que debe tratarse de una versión 1.0.* ó inferior.

Hazte con los manuales de SGMLtools en español que encontrarás en:

Finalmente, y como ilustración, pueden usarse los originales de cualquier «cómo» ya publicado. Un examen a su contenido resultará revelador.

Con todo este material podréis dar un paso en vuestro desarrollo personal como autores, ya que a partir de ahora podéis crear de forma abstracta documentos, con más sencillez y rapidez que las típicas herramientas de autoedición y procesado de textos que los tiempos están demostrando que caen en la obsolescencia arrastrando con ellas a los usuarios.