Auditoría de calidad del entorno libre de trabajo Docbook

Este esfuerzo pretende identificar los problemas de calidad más importantes que un usuario suele encontrarse al usar el entorno de trabajo docbook que normalmente está disponible en las distribuciones libres. Identificarlos, resolverlos y asegurar que las mejoras se incorporen al menos en las principales distribuciones. Especialmente si se hace a través de las distribuciones originales de las respectivas aplicaciones.

Problema Descripción Posible solución
configuración de jadetex Jadetex no viene preconfigurado en español Ya hay algo preparado
configuración de TeX Al menos el guionado en español no viene preconfigurado
algo ya hay preparado. y más información que hay que mirar.
 docbook2pdf  no incluye imágenes  png (en Debian)
Al respecto dí un hack temporal. Sería interesante que alguién reportara tal problema en debian-sgml@lists.debian.org
Las hojas de estilo entre Debian/RH para una misma versión tienen un resultado bastante diferente Las hojas de estilo parecen tener bastantes diferencias para la misma versión entre RH y Debian.
Comparar los parches aplicados en cada una de las distros y preparar una recomendación para los empaquetadores y el proyecto en sí.
sobre el mantenimiento de las  docbook-utils la página web de referencia  contiene paquetes obsoletos y no documenta muy claramente cómo contribuir
La página de referencia contiene paquetes completamente obsoletos. Mejor sencillamente borrarlos para no confundir a la gente.
comportamiento incongruente de las docbook-utils  Al menos docbook2html crea ficheros pero con el parámetro -u escupe el resultado por la salida estándar, sin miramientos. Además, si rediriges la salida, de paso engancha cadenas informativas de jade que no vienen a cuento.

diferencias de comportamiento entre docbook2 y db2

Por ejemplo db2html crea un directorio ${output}.junk en caso de que ya el documento haya sido procesado por lo menos una vez, mientras que en docbook2html sólo se conserva el último procesamiento del archivo.

Por otro lado creo que db2* no maneja ficheros con
sufijo .xml

Parece que el comportamiento de estas utilidades varía en RH y en Debian... ¡acabáramos!

Configuración de  passivetex No viene preconfigurado con guionado español

aumentar los buffers de TeX para tragar a passivetex a la hora de generar ficheros FO. Al menos en RH los búfferes de TeX no pueden procesar ficheros FO usando PassiveTeX
Se me ocurre que sería conveniente mirar que han hecho al respecto en los paquetes de Debian.
Las URL se escapan de los márgenes en la salida PDF
Pues eso :-)
Una solución al respecto es dada en el Self DocBook de Tim Waugh.
Pies de página (PDF/PS) los pies de página aparecen realmente al pie y no al final del documento
Jaime documenta una solución.
corregir las hojas de estilo para mejorar la calidad final de la presentación en pdf/ps
Se me ocurren las siguientes alternativas:
  1. Usar el trabajo del Mandrake Documentation Project, algo que ya comenté al respecto.
  2. Usar dblatex. Tal herramienta permite la traducción a LaTeX y ConTeXt y debo admitir que la calidad de presentación de éste último es impresionante.
Salida HTML válida y elegante.
Leyendo , al parecer la última versión de las hojas de estilo DSSSL (1.78) incluyen mucho trabajo en esta dirección. En particular hay un parámetro llamado html40 que ayuda en dicho sentido.

Yo no estoy muy al tanto de las hojas de estilo XSL, pero creo que también han hecho un *muy* buen trabajo al respecto. En particular tienen los parámetros make.valid.html y html.cleanup con dicho fin. Además tales hojas de estilo permiten tener salida XHTML si uno quiere ser en exceso riguroso.

Adicionalmente siempre se puede modificar docbook2html para que valide y corrija el html resultante, usando algo como tidy.

uso del atributo scale de las imágenes en HTML

manual de uso y modificación de las hojas de estilo (extracción de la doc empotrada en las mismas)

Las marcas quote no generan las comillas latinas en español.

docbook2html no copia los iconos de stylesheet-images/ al directorio donde se guardan los ficheros html, como tampoco lo hace con las imágenes que incorporan los documentos.

La salida HTML tiene más de 80 columnas de ancho. cuando se recomiendan 70

Estudiar la accesibilidad de la salida HTML y sugerir mejoras si fuera necesario (normas WAI)