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 |
|
| 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:
|
|
| 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) |