Diferencia entre revisiones de «Documentación en Software libre»
(Página creada con «{{Sección |Título=Documentación |Libro=Software libre |Capítulo=Entornos y tecnologías de desarrollo |Número sección=6 |Introducción=En el mundo del software libre,...») |
(Sin diferencias)
|
Revisión del 01:04 28 feb 2012
Wikilibro: Software libre > Capítulo 7: Entornos y tecnologías de desarrollo |
Sección 6
En el mundo del software libre, apenas se usan procesadores de texto WYSIWYG y otras herramientas ofimáticas que tanto éxito tienen en otros entornos, a pesar de haber ya herramientas libres, como OpenOffice. Ello es debido a varios factores importantes:
Por todo ello el programador libre, acostumbrado también a programar y compilar, prefiere formatos de documentación transparentes, en muchos casos simple texto puro, en muchos otros formatos de documentación procesables. Los formatos procesables utilizados no son muchos. Tradicionalmente en el mundo Unix los programas se han documentado en los formatos esperados por la familia de procesadores roff, con versión libre[groff] de Norman Walsh. No obstante esta práctica se ha ido abandonando, excepto para las páginas de manual tradicionales, ya que es casi obligado preparar páginas de manual para las herramientas más básicas del sistema. Debido a que muchas páginas de manual han crecido excesivamente, de modo que difícilmente se les puede llamar páginas, fue necesario elaborar un formato alternativo hiper-textual, que permitiera seguir documentos estructurados con índices y referencias cruzadas. El proyecto GNU diseñó el formato texinfo[texinfo] y lo convirtió en su estándar. Este formato permite obtener documentos navegables con la herramienta info o dentro del editor emacs, y a su vez obtener documentos impresos de calidad con ayuda del procesador de textos TeX, de Donald Knuth[knuth:tex]. El formato texinfo puede traducirse a HTML multipágina si se desea, y mucha gente prefiere ver la información con un navegador Web, pero se pierde la capacidad de búsqueda de palabras en un documento. Esta es una de las consecuencias indeseables de la popularidad de HTML, ya que los navegadores no implementan el concepto de documento multipágina, a pesar de que existen elementos link que permiten enlazar las partes. Existe una imperiosa demanda de que los documentos complejos se puedan ver como páginas Web multipágina fácilmente navegables. Hay gente que escribe documentación en LaTeX[lamport:latex], también aplicación de TeX, muy popular entre los científicos, más expresivo que Texinfo, y convertible a HTML multipágina con ciertas herramientas[goosens:texweb], siempre que se guarde cierta disciplina. En efecto, las aplicaciones de TeX son conjuntos de macros que combinan operadores tipográficos de muy bajo nivel para convertirlos en lenguajes abstractos que trabajan con conceptos de alto nivel (autor, título, resumen, capítulo, apartado, etc.). Si sólo se utilizan las macros básicas, la conversión es sencilla. Pero como nadie impide usar operadores de bajo nivel y, además, existen cantidades enormes de paquetes de macros fuera de la capacidad de mantenimiento de los mantenedores de los conversores, es difícil conseguir que las conversiones salgan bien. |
< Sección anterior |
Sección siguiente > |