gnome-doc-utils Gnome-Doc-Utils es una colección de utilidades de documentación para el proyecto GNOME.
Descargar ahora

gnome-doc-utils Clasificación y resumen

gnome-doc-utils Etiquetas

GNOMO Gnome utilidades documentación Utilidades de la documentación Documentación gnome gnome-doc-utils

gnome-doc-utils Descripción

Gnome-Doc-Utils es una colección de utilidades de documentación para el proyecto GNOME. Los paquetes de Gnome-Doc-Utils contienen una colección de utilidades de documentación para el proyecto GNOME. En particular, contiene utilidades para la construcción de documentación y todos los archivos auxiliares en su árbol de origen, y contiene las hojas de estilo XSLT de DocBook que una vez se distribuyeron con Yelp. Comenzando con GNOME 2.8, Yelp requerirá GNOME-DOC-UTILS para el directorio XSLT.ORGANIZATYSTEST / El directorio de pruebas contiene una serie de pruebas para Gnome-Doc-Utils. Los directorios del formulario TestDocn, donde N es un entero positivo, son árboles de fuente de esqueleto que contienen documentación, con el mismo diseño que serían utilizados por proyectos reales. El directorio de TestDocs contiene las pruebas unitarias de DocBook-Testdocs, desarrollado por Norm y Co. para las hojas de estilo Pan-Galactic DocBook. Un archivo README adicional está en ese directorio, dando instrucciones sobre la extensión o cambio de cualquiera de los archivos en GNOME-DOC-UTILS CVS.DOC / El directorio DOC contiene documentación para GNOME-DOC-UTLS. En la mayoría de los casos, se requiere Gnome-Doc-Utils para construir su documentación. Los mecanismos están en su lugar para el bootstrapping.xslt / el directorio XSLT contiene todos los XSLT en Gnome-Doc-Utils. En particular, el directorio XSLT / DocBook contiene el DocBook XSLT, y XSLT / GETTEXT contiene la utilidad XSLT GETTEXT para traducir el texto automático. Sandbox / El directorio de arena no se distinge, por lo que solo aparecerá si tiene un checkout CVS. Es un parque infantil para nuevas ideas.xml2po / el directorio XML2PO contiene la herramienta XML2PO desarrollada por Danilo Segan para la traducción de formatos XML arbitrarios. Es utilizada por Gnome-Doc-Utils para DocBook Translam.Testingunder El directorio de pruebas son una serie de pruebas para Gnome-Doc-Utils. Para probar el sistema de compilación (gnome-doc-utils.m4 y gnome-doc-utils.make), puede usar cualquiera de los directorios TestDocn (para n un entero positivo). Estos se configuran como árboles de fuente de esqueleto, comportándose exactamente como lo haría un proyecto real. Además, Gnome-Doc-Utils se usa para construir su propia documentación (bajo DOC), por lo que Gnome-Doc-Utils en sí misma es una prueba de las herramientas de construcción. Para probar las hojas de estilos de DocBook, use el directorio de prueba / testdocs. Estas pruebas unitarias son del paquete DocBook-TestDocs en DocBook.SourceForge.net, desarrollado por Norm y Co. Simplemente la tipificación de tipificación 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 generalmente prueba un pequeño número de elementos de DocBook relacionados. Muchas de las características de DocBook o del XSLT en Gnome-Doc-Utils podrían no ser probadas por estos. Se pueden agregar pruebas adicionales; Siga las instrucciones en la prueba / testdocs / lémetro para eso. También es útil para probar el XSLT es transformar algunos documentos grandes que lo usan. La Guía del usuario de GNOME y el manual gnumérico sirven, ambos sirven, como una excelente prueba de pruebas.hackingunlike la mayoría de la programación de C, trabajando en gran parte de Gnome-Doc-Utils realmente involucran mejoras incrementales aisladas. No hay forma de dar una breve lista de características amplias en una lista de TODO. Para trabajar en las herramientas de compilación (gnome-doc-utils.m4 y gnome-doc-utils.make), construir los documentos de prueba y ver qué no trabajo. Gnome-Doc-utils.Make tiene una lista de todos los objetivos de alto nivel que deben ser compatibles con plena. Para trabajar en el DocBook XSLT, encontrar un elemento que aún no se implementa y implementarlo. Si tiene instalado XML STARLET (XMLSTAR.SOURCEFORGE.NET), puede escribir 'hacer que haga informes.html' en el directorio XSLT / DocBook / HTML para obtener un informe HTML agradable sobre qué elementos se implementan. También hay un archivo de TODO en este directorio con una lista muy sucinta de coincidencias que deben realizarse que no pueden ser atrapadas por report.html.note que el XSLT se documenta en línea con XSLDOC, que es en sí misma una parte de Gnome- Doc-utils. Siéntase libre de trabajar en XSLDOC también. La documentación generada por XSLDOC se incluye en el manual bajo DOC / XSLT.

gnome-doc-utils Software relacionado