gnome-doc-utils pakket bevat een verzameling van documentatie hulpprogramma's voor het Gnome project. Met name bevat het hulpprogramma voor het bouwen van documentatie en alle ondersteunende bestanden in je source tree, en het bevat de DocBook XSLT stylesheets die ooit werden uitgedeeld met Yelp. Beginnend met Gnome 2.8, zal Yelp gnome-doc-utils nodig hebben voor de XSLT.
ORGANISATIE
test /
De test directory bevat een aantal tests voor gnome -doc-utils. Directories van de vorm testdocn, waarbij n een positief geheel getal zijn skelet broncode met documentatie, met dezelfde indeling die worden gebruikt door de werkelijke projecten. De testdocs directory bevat de unit tests uit docbook-testdocs, ontwikkeld door Norm en Co voor de pan-galactische DocBook stylesheets. Een extra README bestand in die map, het geven van instructies over het verlengen of wijzigen van een van de bestanden in gnome-doc-utils CVS.
Doc /
De doc directory bevat documentatie voor gnome-doc -utils. In de meeste gevallen wordt gnome-doc-utils die nodig is om de documentatie te bouwen. Mechanismen zijn ingesteld voor bootstrap.
XSLT /
De XSLT directory bevat alle XSLT in gnome-doc-utils. Met name de XSLT / docbook directory bevat de DocBook XSLT en XSLT / gettext bevat de XSLT gettext hulpprogramma voor automatische tekst te vertalen.
Zandbak /
De zandbak map niet wordt DISTed, dus het zal alleen weergegeven als u een CVS checkout. Het is een speeltuin voor nieuwe ideeën.
Xml2po /
De xml2po directory bevat de xml2po tool ontwikkeld door Danilo Segan voor de vertaling van willekeurige XML formaten. Het wordt gebruikt door gnome-doc-utils voor de vertaling DocBook.
TESTEN
Onder de test directory zijn een aantal tests voor gnome-doc-utils. Om het bouwsysteem (gnome-doc-utils.m4 en gnome-doc-utils.make) te testen, kunt u een van de testdocn (voor na positief geheel getal) directories gebruiken. Deze zijn opgezet als skelet bron bomen, gedraagt zich precies zoals een echte project zou doen. Ook gnome-doc-utils zelf gebruikt om zijn eigen documentatie (onder doc) te bouwen, zodat gnome-doc-utils zelf is een test van de hulpmiddelen om te bouwen.
Om de DocBook stylesheets te testen, gebruik maken van de test / testdocs directory. Deze unit tests zijn uit de docbook-testdocs pakket op docbook.sourceforge.net, ontwikkeld door Norm en Co. Gewoon typen maken in die map zal elke test te bouwen. Als de naam van het testbestand is foo.001.xml, zal de output zijn html / foo.001 / foo.001.html. Elke test test over het algemeen een klein aantal gerelateerde DocBook elementen. Veel van de functies van DocBook of van de XSLT in gnome-doc-utils misschien niet getest worden door deze. Aanvullende tests kunnen worden toegevoegd; Volg de instructies in test / testdocs / README voor.
Ook handig voor het testen van de XSLT is om een aantal grote documenten met behulp van het transformeren. De gebruikershandleiding van Gnome en de Gnumeric Manual zowel dienen als uitstekende test docs.
HACKING
tegenstelling tot de meeste C-programmeertaal, het werken aan een groot deel van gnome-doc-utils echt betrekken geïsoleerde incrementele verbeteringen. Er is geen manier om een korte lijst van brede functies te geven in een TODO lijst.
Werken aan de bouwprogramma's (gnome-doc-utils.m4 en gnome-doc-utils.make), bouwen de testen docs en zie wat niet werkt. gnome-doc-utils.make heeft een lijst van alle high-level targets die volledig moeten worden ondersteund.
Werken aan de DocBook XSLT, het vinden van een element dat nog niet is geïmplementeerd en uit te voeren . Als u XML-Starlet (xmlstar.sourceforge.net) geïnstalleerd, kunt u typt 'maken report.html' in de XSLT / docbook / html directory te
krijgt een mooie HTML-rapport op welke elementen worden toegepast. Er is ook een TODO bestand in deze map met een zeer beknopt overzicht van de wedstrijden die moeten worden gedaan die niet kunnen worden gevangen door report.html.
Merk op dat de XSLT wordt gedocumenteerd inline met xsldoc, die zelf een onderdeel van gnome-doc-utils. Voel je vrij om te werken aan xsldoc ook. De documentatie gegenereerd door xsldoc is opgenomen in de handleiding onder doc / XSLT
Wat is nieuw in deze release:.
- Vaste probleem met dist en installeren met te veel bestanden
- Bijgewerkt vertalingen:
- km (Morn Met)
Wat is nieuw in versie 0.20.9:
- Tijdelijk toevoegen van RNG-bestanden terug voor compatibiliteit. Nu dat de RNG-bestanden niet meer worden genoemd (zoals van 0.20.8), de RNG bestanden worden opnieuw na een overgangsperiode verwijderd.
Wat is nieuw in versie 0.20.6:
- Bijgewerkt Mallard schema
- Fixed 'maken pot' regel voor de wilde eend
- Bijgewerkt vertalingen:
- ca (Jordi Serratosa)
- es (Jorge Gonzalez, Daniel Mustieles)
- ug (Abduxukur Abdurixit)
Wat is nieuw in versie 0.20.5:
- Bijgewerkt Mallard RNG bestanden
- Bijgewerkt vertalingen:
- als (Amitakhya Phukan)
- bn_IN (Runa Bhattacharjee)
- eo (Kristjan SCHMIDT)
- es (Jorge Gonzalez)
- gu (Sweta Kothari)
- of (Manoj Kumar Giri)
Wat is nieuw in versie 0.20.3:
- Vaste geneste commando substitutie in gnome-doc-utils .make (Chris Coleman)
- Bijgewerkt vertalingen:
- ca @ valencia (Carles Ferrando)
- de (christelijke Kirbach)
- de (Mario Blattermann)
- 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)
Wat is nieuw in versie 0.20.2:
- Bijgewerkt vertalingen:
- de (Mario Blattermann)
- nl @ Shaw (Thomas Thurman)
- es (Jorge Gonzalez)
- fr (Geode)
- GL (Fran Dieguez)
- hij (Yaron Shahrabani)
- hu (Gabor Kelemen)
- id (Dirgita)
- ja (Takayuki Kusano)
- lv (Rudols Mazurs)
- sl (Andrej Žnidaršič)
- zh_CH (Aron Xu)
Reacties niet gevonden