El Linux Documentation Project (LDP) se puso en marcha para proporcionar a los nuevos usuarios una forma más rápida de obtener información sobre un tema concreto. Éste contiene, no sólo una red de libros sobre administración, red y programación, sino también una gran cantidad de temas individuales escritos por aquellos que los han usado. Si desea averiguar cómo imprimir, debe acceder a Printing HOWTO. Si desea averiguar si su tarjeta Ethernet funciona con Linux, acuda a Ethernet HOWTO, y así con el resto. Inicialmente, muchos de estos trabajos estaban escritos en formato de texto o HTML. Con el tiempo, necesitabamos una forma mejor de gestionar estos documentos, que permitiera leerlos desde una página web, desde un fichero de texto en un CD-ROM, o incluso desde un asistente personal digital. La solución final fue SGML.
El Standard Generalized Markup Language (SGML) es un lenguaje que se basa en códigos insertados en un documento. En este sentido, es parecido a HTML, pero aquí acaban las similitudes. La potencia de SGML consiste en que, a diferencia de WYSIWYG (What You See Is What You Get), Usted no define cosas como el color, el tamaño de la fuente o incluso algunos tipos de formato. En cambio, define elementos (párrafos, secciones, listados de números) y deja al procesador de SGML y al programa final que se preocupen por la colocación, los colores, fuentes, etc. En realidad , esto también lo hace HTML , que no es sino es un subconjunto de SGML. SGML está formado por tres partes. La primera es la estructura, que es lo que comúnmente es conocido como la DTD, o Document Type Definition (Definición de tipo de documento). El DTD define las relaciones entre cada uno de los elementos. El DTD DocBook, empleado para crear este documento, es un claro ejemplo. El DTD incluye las reglas que debe seguir el contenido. La segunda parte es el DSSSL o Document Style Semantics and Specification Language (Lenguaje de especificaciones y de semántica de estilos de documento). El DSSSL ordena al programa que realiza la representación cómo convertir SGML en algo que pueda leer el ojo humano. Por ejemplo, le ordena que convierta la etiqueta <table> en negrita de 14 puntos si el formato final es RTF, o que la sustituya por la etiqueta <hl> si se trata de HTML. Finalmente, está el contenido, que es lo que realmente representa el procesador de SGML y que es lo que ve el usuario. Este párrafo es contenido, pero también lo sería una imagen, una tabla, un listado de números, etc. El contenido es lo que está rodeado por las etiquetas, que separan cada elemento.
SGML hace mucho más que formatear. Puede crear automáticamente índices, tablas de contenidos y enlaces, al mismo documento o a otro distinto. Los paquetes de Jade y OpenJade también le permiten exportar de SGML a LaTeX, info, text, HTML, y RTF. Desde estos formatos básicos, puede crear otros formatos como MS Word, PostScript, PDF y otros. Los programas como LyX le permiten escribir en formato TeX, param luego exportarlo a SGML, y desde SGML a cualquiera que Usted elija. En el fondo, SGML se preocupa más por la manera de trabajar de los elementos que por el aspecto que estos presentan. Esto constituye una gran ventaja, que le permitirá escribir más rápido, ya que no tiene que preocuparse por la colocación de los párrafos, el tamaño de la fuente y otros detalles.
Si Usted es nuevo en el LDP y desea encargarse de un CÓMO sin mantener o escribir un nuevo CÓMO o un mini-CÓMO, póngase en contacto con el coordinador del CÓMO en la dirección <ldp-discuss@lists.linuxdoc.org>. Esto es para asegurarse de que el coordinador del CÓMO pueda saber quién está trabajando con la documentación. (N. del. T.: si se trata de un Cómo original en castellano, vaya a http://www.insflug.org/ y siga las instrucciones.
Una vez hecho esto, debe escribir su documentación en el formato que elija y presentar un borrador a <ldp-submit@lists.linuxdoc.org>, que será revisado por un voluntario del LDP. En muy pocos días recibirá el borrador devuelto junto con las observaciones del voluntario. Tras haber aplicado estos comentarios a su texto, debe enviar esta versión otra vez a la lista ldp-submit para su presentación final en el LDP.
En este momento, otro voluntario del LDP traducirá el documento a DocBook y le enviará el documento DocBook final. De aquí en adelante, todas los envíos al LDP han de estar en formato DocBook. Si tiene preguntas sobre el sistema de marcas o etiquetas, puede preguntarle al voluntario que le ayudó o recurrir a la lista de DocBook del LDP.
Hay algunas listas de correo a las que se puede subscribir para participar en el LDP. En primer lugar está <ldp-discuss@lists.linuxdoc.org>, principal grupo de discusión del LDP. Para suscribirse, envie un mensaje con "subscribe" en la línea del asunto <ldp-discuss-request@lists.linuxdoc.org>. Para borrarse, envie un e-mail con "unsubscribe" en la línea del asunto a <ldp-discuss-request@lists.linuxdoc.org>.
Otra lista es la <ldp-docbook@lists.linuxdoc.org>, orientada al marcado y a cuestiones del propio DocBook. Si tiene algún problema con una etiqueta en particular, puede enviar su pregunta aquí para obtener una respuesta. Puede suscribirse a la lista DocBook enviando un mensaje con "subscribe" en la línea del asunto a <ldp-docbook-request@lists.linuxdoc.org>.