gnome-doc-utils

gnome-doc-utils pakkette bevat 'n versameling van dokumentasie Nut vir die GNOME-projek. Veral, dit bevat programme vir die bou van dokumentasie en alle hulp lêers in jou bron boom, en dit bevat die DocBook XSLT style wat eens versprei met Yelp. Begin met Gnome 2.8, sal Yelp vereis gnome-doc-utils vir die XSLT.

Organisasie

toets /
Die toets gids bevat 'n aantal van toetse vir gnome -doc-utils. Dopgehou van die vorm testdocn, waar n 'n positiewe heelgetal is, is geraamte bron bome wat dokumentasie, met dieselfde uitleg wat deur werklike projekte gebruik sal word. Die testdocs gids bevat die eenheid toetse van DocBook-testdocs, wat ontwikkel is deur Norm en Co vir die pan-galaktiese DocBook style. 'N bykomende README lêer is in die gids weer maak, gee instruksies oor die uitbreiding of om enige van die lêers in gnome-doc-utils CVS.

Doc /
Die doc gids bevat dokumentasie vir gnome-doc -utils. In die meeste gevalle, is gnome-doc-utils nodig is om sy dokumentasie te bou. Meganismes is in plek vir Opstarten.

XSLT /
Die XSLT gids bevat al die XSLT in gnome-doc-utils. Veral, die XSLT / DocBook gids bevat die DocBook XSLT, en XSLT / gettext bevat die XSLT gettext nut vir die vertaling van outomatiese teks.

Sandbox /
Die sandbox gids is nie DISTed, so dit sal verskyn net as jy 'n CVS afhandeling. Dit is 'n speelgrond vir nuwe idees.

Xml2po /
Die xml2po gids bevat die xml2po instrument wat ontwikkel is deur Danilo Segan vir vertaling van arbitrêre XML-formaat. Dit word deur gnome-doc-utils vir DocBook vertaling.

TOETSING

Onder die toets gids is 'n aantal van toetse vir gnome-doc-utils. Die bou stelsel (gnome-doc-utils.m4 en gnome-doc-utils.make) te toets, kan jy enige van die testdocn (vir na positiewe heelgetal) dopgehou. Dit is gestig as geraamte bron bome, gedra presies soos 'n werklike projek sou. Ook, gnome-doc-utils gebruik self sy eie dokumentasie (onder doc) te bou, so gnome-doc-utils self is 'n toets van die gereedskap om te bou.

Die DocBook style te toets, gebruik die toets / testdocs gids. Hierdie eenheid toetse is uit die DocBook-testdocs pakket op docbook.sourceforge.net, wat ontwikkel is deur Norm en Co eenvoudig te tik maak in daardie gids sal elke toets bou. As die naam van die toets lêer is foo.001.xml, sal die uitset html / foo.001 / foo.001.html. Elke toets toets die algemeen 'n klein aantal verwante DocBook elemente. Baie van die eienskappe van DocBook of van die XSLT in gnome-doc-utils dalk nie deur hierdie getoets word. Bykomende toetse kan bygevoeg word; volg die instruksies in die toets / testdocs / README vir daardie.

Ook nuttig vir die toets van die XSLT is 'n paar groot dokumente wat dit gebruik om te transformeer. Die Gnome User Guide en die Gnumeric Handleiding beide dien as 'n uitstekende toets docs.

Inbraak

Anders as die meeste C programmering, werk op baie van gnome-doc-utils regtig behels geïsoleerde inkrementele verbeterings. Daar is geen manier om 'n kort lys van breë funksies te gee in 'n TODO lys.

Te werk op die bou tools (gnome-doc-utils.m4 en gnome-doc-utils.make), die bou van die toets dokumente en sien wat nie werk nie. gnome-doc-utils.make het 'n lys van al die hoë-vlak teikens wat ten volle ondersteun moet word.

te werk op die DocBook XSLT, vind 'n element wat is nog nie geïmplementeer en dit implementeer . As jy 'n XML Ster (xmlstar.sourceforge.net) geïnstalleer is, kan jy tik 'maak report.html' in die XSLT / DocBook / html gids
te kry 'n mooi HTML verslag oor watter elemente geïmplementeer word. Daar is ook 'n TODO lêer in hierdie gids met 'n baie bondige lys van wedstryde wat gedoen moet word wat nie deur report.html gevang moet word.

Let daarop dat die XSLT is gedokumenteer inline met xsldoc, wat self 'n deel van gnome-doc-utils. Voel vry om te werk op xsldoc as well. Die dokumentasie wat deur xsldoc is ingesluit in die handleiding onder doc / XSLT

Wat is nuut in hierdie release:.

• Vaste probleem met dist en installeer met te veel lêers
• Opdateer vertalings:
• km (Morn Met)

Wat is nuut in die weergawe 0.20.9:

• tydelik voeg RNG lêers terug vir verenigbaarheid. Nou dat die RNG lêers nie langer genoem (soos van 0.20.8), sal die RNG lêers weer na 'n oorgang tydperk verwyder word.

Wat is nuut in die weergawe 0.20.6:

• Opdateer Mallard skema
• Vaste 'maak pot 'n reël vir Mallard
• Opdateer vertalings:
• ca (Jordi Serratosa)
• es (Jorge Gonzalez, Daniel Mustieles)
• ug (Abduxukur Abdurixit)

Wat is nuut in die weergawe 0.20.5:

• Opdateer Mallard RNG lêers
• Opdateer vertalings:
• as (Amitakhya Phukan)
• bn_IN (Runa Bhattacharjee)
• wins (Kristjan SCHMIDT)
• es (Jorge Gonzalez)
• gu (Sweta Kothari)
• of (Manoj Kumar Giri)

Wat is nuut in die weergawe 0.20.3:

• Vaste geneste opdrag vervanging in gnome-doc-utils .make (Chris Coleman)
• Opdateer vertalings:
• ca @ valencia (Carles Ferrando)
• de (Christelike 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 nuut in die weergawe 0.20.2:

• Opdateer vertalings:
• de (Mario Blattermann)
• af @ Shaw (Thomas Thurman)
• es (Jorge Gonzalez)
• fr (Geode)
• gl (Fran Dieguez)
• Hy (Yaron Shahrabani)
• hu (Gabor Kelemen)
• id (Dirgita)
• JA (Takayuki KUSANO)
• lv (Rudols Mazurs)
• sl (Andrej Znidarsic)
• zh_CH (Aron Xu)