gnome-doc-utils

paquetes gnome-doc-utils contiene una colección de utilidades de documentación para el proyecto GNOME. Cabe destacar, que contiene utilidades para la construcción de la documentación y todos los archivos auxiliares en su árbol de fuentes, y contiene las hojas de estilo XSLT DocBook que una vez que se distribuyeron con Yelp. A partir de Gnome 2.8, Yelp requerirá gnome-doc-utils para el XSLT. Prueba

ORGANIZACIÓN
/
El directorio de prueba contiene una serie de pruebas para gnome -doc-utils. Directorios de forma testdocn, donde n es un entero positivo, son árboles de código fuente esqueleto que contienen la documentación, con el mismo diseño que sería utilizado por los proyectos reales. El directorio testdocs contiene las pruebas unitarias de docbook-testdocs, desarrollados por Norm and Co. para los pan-galácticos hojas de estilo DocBook. Un archivo README adicional es en ese directorio, dando instrucciones sobre cómo prolongar o cambiar cualquiera de los archivos en gnome-doc-utils CVS.
Doc /
El directorio doc contiene documentación para gnome-doc -utils. En la mayoría de casos, se requiere gnome-doc-utils para construir su documentación. Se han establecido mecanismos para el arranque.
Xslt /
El directorio XSLT contiene toda la XSLT en gnome-doc-utils. Cabe destacar que el directorio de XSLT / docbook contiene el DocBook XSLT, y XSLT / gettext contiene la utilidad gettext XSLT para la traducción de texto automático.
Sandbox /
El directorio recinto no se DISTed, por lo que lo hará sólo aparecerá si tiene un checkout. Es una zona de juegos para nuevas ideas.
Xml2po /
El directorio xml2po contiene la herramienta xml2po desarrollado por Danilo Segan para la traducción de los formatos XML arbitrarios. Es utilizado por gnome-doc-utils para la traducción DocBook.
PRUEBAS
Bajo el directorio test son una serie de pruebas para gnome-doc-utils. Para probar el sistema de construcción (gnome-doc-utils.m4 y gnome-doc-utils.make), puede utilizar cualquiera de los testdocn (para n entero positivo) directorios. Estos se instalan árboles de código fuente como esqueleto, comportándose exactamente como un proyecto real lo haría. También, gnome-doc-utils utiliza en sí para construir su propia documentación (bajo doc), por lo que gnome-doc-utils en sí es una prueba de las herramientas de construcción.
Para probar las hojas de estilo DocBook, utilice el directorio test / testdocs. Estas pruebas unitarias son del paquete docbook-testdocs en docbook.sourceforge.net, desarrollado por Norm and Co. Simplemente escribiendo hacer en ese directorio construirá cada prueba. Si el nombre del archivo de prueba es foo.001.xml, la salida será html / foo.001 / foo.001.html. Cada prueba general prueba un pequeño número de elementos DocBook relacionados. Muchas de las características de DocBook o del XSLT en gnome-doc-utils no podría ser probado por estos. Los exámenes adicionales pueden ser añadidos; siga las instrucciones de la prueba / testdocs / README para eso.
también útil para probar el XSLT es transformar algunos documentos de gran tamaño utilizan. La Guía del usuario de Gnome y el Manual de Gnumeric tanto sirven como excelentes documentos de prueba.
HACKING
diferencia de la mayoría de programación C, que trabaja en gran parte de gnome-doc-utils realmente no involucrar aislado mejoras incrementales. No hay manera de dar una breve lista de características generales en una lista TODO.
Para trabajar en las herramientas de construcción (gnome-doc-utils.m4 y gnome-doc-utils.make), la construcción de la docs de prueba y ver lo que no funciona. gnome-doc-utils.make tiene una lista de todos los objetivos de alto nivel que deben ser totalmente compatibles.
para trabajar en el DocBook XSLT, encontrar un elemento que no se ha implementado todavía y aplicarla . Si usted tiene XML Starlet (xmlstar.sourceforge.net) instalado, puede escribir 'make report.html' en el xslt / docbook / html directorio para obtener
un informe HTML agradable en lo que se implementan elementos. También hay un archivo de TODO en este directorio con una lista muy sucinta de partidos que hay que hacer, que no pueden ser capturados por report.html.
Tenga en cuenta que el XSLT se documenta en línea con xsldoc, que es en sí mismo una parte de gnome-doc-utils. Siéntase libre para trabajar en xsldoc también. La documentación generada por xsldoc está incluido en el manual bajo doc / XSLT

¿Cuál es nuevo en esta versión:.

• Fijo problemas con dist e instalar con demasiados archivos
• Traducciones actualizadas:
• km (Morn Met)

¿Cuál es nuevo en la versión 0.20.9:

• añadir Temporalmente RNG recibir archivos para la compatibilidad. Ahora que los archivos RNG ya no son llamados (a partir de 0.20.8), los ficheros RNG serán retirados de nuevo después de un período de transición.

¿Qué hay de nuevo en la versión 0.20.6:

• Actualización esquema Mallard
• Fijo 'hacen olla' regla para Mallard
• Traducciones actualizadas:
• ca (Jordi Serratosa)
• es (Jorge González, Daniel Mustieles)
• ug (Abduxukur Abdurixit)

¿Qué hay de nuevo en la versión 0.20.5:

• Actualizado archivos Mallard RNG
• Traducciones actualizadas:
• como (Amitakhya Phukan)
• bn_IN (Runa Bhattacharjee)
• eo (Kristjan SCHMIDT)
• es (Jorge González)
• gu (Sweta Kothari)
• o (Manoj Kumar Giri)

¿Qué es nuevo en la versión 0.20.3:

• Fijo sustitución comando anidado en gnome-doc-utils .make (Chris Coleman)
• Traducciones actualizadas:
• ca @ valencia (Carles Ferrando)
• de (Christian Kirbach)
• de (Mario Blattermann)
• el (Michael Kotsarinis)
• es (Jorge González)
• et (Ivar Smolin)
• fa (Mahyar Moghimi)
• fr (Bruno Brouard)
• gl (Fran Dieguez)
• sl (Matej Urbancic)
• ug (Gheyret T.Kenji)

¿Qué hay de nuevo en la versión 0.20.2:

• Traducciones actualizadas:
• de (Mario Blattermann)
• es @ shaw (Thomas Thurman)
• es (Jorge González)
• fr (Geode)
• gl (Fran Dieguez)
• él (Yaron Shahrabani)
• hu (Gabor Kelemen)
• id (Dirgita)
• ja (Takayuki Kusano)
• lv (Rudols Mazurs)
• sl (Andrej Žnidaršič)
• zh_CH (Aron Xu)