El Cómo de los Cómos

Mark F. Komarinski

v1.4 12 junio de 2000

Revision History
Revision 1.412 de junio de 2000Revised by: mfk
Se añadieron las herramientas vim y sgedit. Nuevo nombre y otros cambios relacionados con la lista ldp. También se aplicaron las pautas de estilo del LDP.

Lista de las herramientas, procedimientos y pistas necesarios para acelerar el trabajo de los autores de CÓMOs.


Table of Contents
Sobre este CÓMO
Introducción al LDP y a SGML
Herramientas
Primeros pasos con DocBook
Pautas de estilo
Trucos y consejos para DocBook
CVS
Distribución de la documentación
PUFs (Preguntas de Uso Frecuente) sobre el LDP

Sobre este CÓMO

La finalidad de este CÓMO

Comencé a escribir este documento el 26 de agosto de 1999, tras dos días de total frustración a la búsqueda de las herramientas necesarias para trabajar. Si llegara a servir de ayuda a una sola persona, se habrá cumplido mi objetivo.

La versión más reciente del documento se puede encontrar en mi página web http://www.cgipc.com/~markk , en formato SGML. También existen versiones en otros formatos en el sitio web del LDP http://www.linuxdoc.org.

Existen diversas maneras de contribuir al movimiento Linux sin tener que escribir código fuente.Una de las más importantes es la producción de documentación, que permite a cada persona compartir sus conocimientos con otros miles de personas de todo el mundo. Este CÓMO tiene por fin que Usted se familiarice con el funcionamiento del LDP, y con las herramientas necesarias para escribir su propio CÓMO.

El LDP

Lo que mostramos a continuación es la traducción de un fragmento del Manifiesto LDP (http://www.linuxdoc.org/manifesto.html)

EL Linux Documentation Project (LDP) dedica sus esfuerzos al desarrollo de documentación gratuita y de máxima calidad para el sistema operativo GNU/Linux. El principal objetivo del LDP es colaborar en todos los aspectos de la documentación de Linux. Esto implica la creación de "CÓMOs" y "Guías". Esperamos poder establecer un sistema de documentación para Linux, que sea sencillo de utilizar y de consultar, para lo cual es necesaria la integración de documentos texinfo, las páginas de manual, los CÓMOs y otros documentos.

Si desea saber más sobre el Linux Documentation Project, visite su página web http://www.linuxdoc.org

Sugerencias

Si tuviese algún comentario o sugerencia que hacer sobre este CÓMO, diríjase a su autor ).

Copyright

(c) 1999-2000 Mark F. Komarinski

Este manual puede reproducirse total o parcialmente, sin cargos, sujeto a las siguientes restricciones:

  • La nota sobre los derechos de autor y esta nota sobre los permisos debe mantenerse tal cual en todas las copias, completas o parciales.

  • Cualquier traducción o trabajo derivado de éste debe ser aprobado por escrito por parte del autor antes de su distribución.

  • Si se distribuyera una parte de este trabajo, tendrían que incluirse las instrucciones necesarias y un medio para obtener la versión completa de este manual.

  • Pueden reproducirse pequeños extractos como ilustraciones para revisiones o citas en otros trabajos, sin la inclusión de este permiso, siempre que se proporcione una referencia apropiada. Se podrían hacer excepciones a estas reglas si se persigue un fin académico. Si ese es el caso, póngase en contacto con el autor. Estas restricciones han sido creadas para protegernos a nosotros como autores, y, en ningún caso, para poner trabas a los lectores y educadores. Todo el código fuente de este documento (junto con el SGML en que fue escrito el documento) se acoge a la licencia GNU, disponible vía FTP anónimo en el archivo de GNU.

Reconocimientos y agradecimientos

Me gustaría dar las gracias a todos aquellos que aportaron su punto de vista mientras escribía este documento. Entre ellos se encuentran David Lawyer, Deb Richardson, Daniel Barlow, Greg Ferguson, Mark Craig y otros miembros de la lista . Algunas secciones han sido extraídas del HOWTO Index (disponible en muchas réplicas del LDP) y de la documentación de sgmltools. Las secciones sobre acceso en red al CVS fueron parcialmente escritas por Serek (), y las relacionadas con DocBook, por Jorge Godoy (). A ambos, un millón de gracias por su inestimable ayuda.

Convenciones

A lo largo de este texto, las órdenes se muestran siempre en el formato que describimos a continuación: la orden está precedida por el nombre del intérprete de órdenes activo en ese momento; tras el intérprete de órdenes se inserta el símbolo $ cuando se trata de órdenes que hayan de ejecutarse como usuario normal (no superusuario), o el símbolo # cuando sean órdenes que vayan a ejecutarse como superusuario.