GNOME-DOC-UTILS GNOME-DOC-UTILS è una raccolta di utilità di documentazione per il progetto GNOME.
Scarica ora

GNOME-DOC-UTILS Classifica e riepilogo

GNOME-DOC-UTILS Tag

GNOMO Gnome Utilities. documentazione Strumenti documentazione Documentazione GNOME. gnome-doc-utils

GNOME-DOC-UTILS Descrizione

gnome-doc-utils è una raccolta di utility di documentazione per il progetto Gnome. gnome-doc-utils pacchetti contiene una raccolta di utility di documentazione per il progetto Gnome. In particolare, esso contiene utilità per la costruzione di documentazione e tutti i file ausiliari nel vostro albero dei sorgenti, e contiene i fogli di stile DocBook XSLT che un tempo erano distribuiti con Yelp. A partire con Gnome 2.8, Yelp richiederà gnome-doc-utils per la XSLT.ORGANIZATIONtest / La directory test contiene una serie di test per gnome-doc-utils. Elenchi della forma testdocn, dove n è un intero positivo, sono alberi di origine scheletro contenenti documentazione, con la stessa disposizione che verrebbe utilizzato dai progetti reali. La directory testdocs contiene i test di unità da docbook-testdocs, sviluppato da Norm e Co. per i fogli di stile DocBook pan-galattici. Un file README supplementare è in quella directory, dando istruzioni per estendere o modificare uno qualsiasi dei file in gnome-doc-utils CVS.doc / La directory doc contiene la documentazione per gnome-doc-utils. Nella maggior parte dei casi, gnome-doc-utils è necessario per costruire la sua documentazione. I meccanismi sono in atto per bootstrapping.xslt / La directory XSLT contiene tutte le XSLT in gnome-doc-utils. In particolare, la directory XSLT / docbook contiene il DocBook XSLT e XSLT / gettext contiene l'utilità gettext XSLT per la traduzione automatica del testo. sandbox / La directory sandbox non è DISTed, quindi verrà visualizzato solo se si dispone di un checkout CVS. E 'un parco giochi per nuova ideas.xml2po / La directory xml2po contiene lo strumento xml2po sviluppato da Danilo Segan per la traduzione dei formati XML arbitrari. E 'utilizzato da gnome-doc-utils per DocBook translation.TESTINGUnder directory test sono una serie di test per gnome-doc-utils. Per testare il sistema di compilazione (gnome-doc-utils.m4 e gnome-doc-utils.make), è possibile utilizzare una qualsiasi delle testdocn (per n un intero positivo) directory. Questi sono impostati come alberi di origine scheletro, comportandosi esattamente come un vero e proprio progetto sarebbe. Inoltre, gnome-doc-utils si utilizza per costruire la propria documentazione (sotto doc), in modo da gnome-doc-utils per sé è una prova del costruire tools.To testare i fogli di stile DocBook, usare la directory test / testdocs. Questi test di unità sono dal pacchetto docbook-testdocs su docbook.sourceforge.net, sviluppato da Norm e Co. È sufficiente digitare make nella directory costruirà ogni test. Se il nome del file di test è foo.001.xml, l'uscita sarà html / foo.001 / foo.001.html. Ciascun test verifica generalmente un piccolo numero di elementi DocBook correlati. Molte delle caratteristiche di DocBook o della XSLT in gnome-doc-utils potrebbero non essere testati da questi. possono essere aggiunti ulteriori test; seguire le istruzioni in test / testdocs / README per that.also utile per testare l'XSLT è di trasformare alcuni documenti di grandi dimensioni che lo utilizzano. La Guida per l'utente Gnome e il Gnumeric manuale sia servire come ottimo banco di prova docs.HACKINGUnlike maggior parte della programmazione C, lavorando su gran parte del gnome-doc-utils davvero non coinvolgere isolati miglioramenti incrementali. Non c'è modo di dare un breve elenco di ampie funzionalità di un'opera TODO list.To sugli strumenti di generazione (gnome-doc-utils.m4 e gnome-doc-utils.make), ricostruire la documentazione di prova e vedere ciò che non funziona opera. gnome-doc-utils.make ha un elenco di tutti gli obiettivi di alto livello che dovrebbe essere pienamente lavori supported.To sul DocBook XSLT, trovare un elemento che non è ancora implementato e attuarlo. Se si dispone di XML Starlet (xmlstar.sourceforge.net) installato, è possibile digitare 'make report.html' nella directory docbook XSLT / / html geta bel report HTML su quali elementi sono implementati. C'è anche un file TODO in questa directory con una lista molto succinta delle partite che devono essere fatte che non può essere catturato dal report.html.Note che l'XSLT è documentata in linea con xsldoc, che è di per sé una parte di GNOME doc-utils. Sentitevi liberi di lavorare su xsldoc pure. La documentazione generata da xsldoc è incluso nel manuale sotto doc / XSLT.

GNOME-DOC-UTILS Software correlato