gnome-doc-utils

pacchetti gnome-doc-utils 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 proprio albero dei sorgenti, e contiene i fogli di stile XSLT DocBook che una volta venivano distribuiti con Yelp. Partendo con Gnome 2.8, Yelp richiederà gnome-doc-utils per l'XSLT. Test

ORGANIZZAZIONE
/
La directory test contiene una serie di test per gnome -doc-utils. Elenchi di testdocn forma, dove n è un numero intero positivo, sono alberi di origine scheletro contenenti la documentazione, con lo stesso layout che sarebbe stato utilizzato per progetti concreti. La directory testdocs contiene i test di unità di docbook-testdocs, sviluppati da Norm e Co. per i pan-galattici DocBook fogli di stile. Un file README supplementare è in quella directory, dando istruzioni per estendere o cambiare qualsiasi dei file in gnome-doc-utils CVS.
Doc /
La directory doc contiene la documentazione per gnome-doc -utils. Nella maggior parte dei casi, è richiesta gnome-doc-utils per costruire la sua documentazione. I meccanismi sono in atto per l'avvio.
XSLT /
L'elenco XSLT contiene tutti i XSLT in gnome-doc-utils. In particolare, la directory XSLT / docbook contiene il DocBook XSLT e XSLT / gettext contiene l'utilità XSLT gettext per la traduzione automatica del testo.
Sandbox /
La directory sandbox non è DISTed, così lo farà appare solo se si dispone di un checkout CVS. E 'un parco giochi per nuove idee.
Xml2po /
L'elenco xml2po contiene lo strumento xml2po sviluppato da Danilo Segan per la traduzione dei formati XML arbitrari. E 'utilizzato da gnome-doc-utils per la traduzione DocBook.
TEST
Sotto la 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 qualsiasi delle testdocn (per na interi positivi) delle directory. Questi sono impostati alberi di origine come scheletro, comportandosi esattamente come un vero e proprio progetto sarebbe. Inoltre, gnome-doc-utils si usa per costruire la propria documentazione (sotto doc), in modo da gnome-doc-utils per sé è un test degli strumenti di compilazione.
Per testare i fogli di stile DocBook, utilizzare il test / directory testdocs. Questi test unitari sono dal pacchetto docbook-testdocs su docbook.sourceforge.net, sviluppato da Norm e Co. Basta 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 di XSLT in gnome-doc-utils non potrebbe essere testato da questi. Possono essere aggiunte le prove aggiuntive; seguire le istruzioni in test / testdocs / README per questo.
utile anche per testare l'XSLT è di trasformare alcuni documenti di grandi dimensioni che lo utilizzano. La guida utente Gnome e il Manuale di Gnumeric sia servire come ottimi documenti di prova.
HACKING
differenza della maggior parte di programmazione C, lavorando su più di gnome-doc-utils davvero non comporta isolato miglioramenti incrementali. Non c'è modo per dare un breve elenco di ampie funzioni in una lista TODO.
Per lavorare sugli strumenti di compilazione (gnome-doc-utils.m4 e gnome-doc-utils.make), costruire il Documenti di prova e vedere che cosa non funziona. gnome-doc-utils.make ha un elenco di tutti gli obiettivi di alto livello che dovrebbe essere pienamente supportati.
a lavorare sul DocBook XSLT, trovare un elemento che non è ancora implementata e la sua attuazione . Se si dispone di XML Starlet (xmlstar.sourceforge.net) installato, è possibile digitare 'make report.html' nel XSLT / docbook / html directory per ottenere
un report HTML bella su quali sono implementati elementi. C'è anche un file TODO in questa directory con una lista molto succinta partite che devono essere fatte, che non possono essere catturati da report.html.
Noti che il 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

Cosa c'è di nuovo in questa versione:.

• Fisso problema con dist e installare con troppi file
• traduzioni Aggiornato:
• km (Morn Met)

Cosa c'è di nuovo in versione 0.20.9:

• aggiungendo temporaneamente RNG nuovamente i file per la compatibilità. Ora che i file RNG non sono più chiamati (come di 0.20.8), i file RNG saranno rimossi dopo un periodo di transizione.

Cosa c'è di nuovo in versione 0.20.6:

• schema Mallard Aggiornato
• Fixed 'fare pot' regola per Mallard
• traduzioni Aggiornato:
• ca (Jordi Serratosa)
• es (Jorge González, Daniel Mustieles)
• ug (Abduxukur Abdurixit)

Cosa c'è di nuovo in versione 0.20.5:

• Aggiornato file Mallard RNG
• traduzioni Aggiornato:
• come (Amitakhya Phukan)
• bn_IN (Runa Bhattacharjee)
• eo (Kristjan SCHMIDT)
• es (Jorge Gonzalez)
• gu (Sweta Kothari)
• o (Manoj Kumar Giri)

Cosa c'è di nuovo in versione 0.20.3:

• Risolto sostituzione comando annidato in gnome-doc-utils .make (Chris Coleman)
• traduzioni Aggiornato:
• ca @ valencia (Carles Ferrando)
• de (Christian Kirbach)
• de (Mario Blättermann)
• el (Michael Kotsarinis)
• es (Jorge Gonzalez)
• et (Ivar Smolin)
• fa (Mahyar Moghimi)
• fr (Bruno Brouard)
• GL (Fran Dieguez)
• sl (Matej Urbancic)
• ug (Gheyret T.Kenji)

Cosa c'è di nuovo in versione 0.20.2:

• traduzioni Aggiornato:
• de (Mario Blättermann)
• it @ Shaw (Thomas Thurman)
• es (Jorge Gonzalez)
• fr (Geode)
• GL (Fran Dieguez)
• che (Yaron Shahrabani)
• hu (Gabor Kelemen)
• id (Dirgita)
• ja (Takayuki Kusano)
• lv (Rudols Mazurs)
• sl (Andrej Znidarsic)
• zh_CH (Aron Xu)