gnome-doc-utils

gnome-doc-utils pakettien sisältää kokoelman asiakirjoja apuohjelmat Gnome projekti. Erityisesti se sisältää apuohjelmia rakentaa asiakirjat ja kaikki ylimääräiset tiedostot lähde puu, ja se sisältää DocBook XSLT tyylitaulukkoja jotka olivat kerran jakautunut Yelp. Alkaen Gnome 2.8, Yelp edellyttää gnome-doc-utils varten XSLT.
ORGANISAATIO
testi /
testi hakemisto sisältää useita testejä gnome -doc-utils. Hakemistot muotoa testdocn, missä n on positiivinen kokonaisluku, ovat luuranko raakapuustosta sisältävät asiakirjat, joilla on sama asettelu, joka käyttää todellista hankkeita. Testdocs hakemisto sisältää yksikön testit docbook-testdocs kehittämä Norm ja Co. yleiseurooppalaista galaksin DocBook stylesheets. Ylimääräinen README tiedosto on, että hakemistoon, jossa ohjeita laajentamaan tai muuttamaan minkä tahansa tiedostoja gnome-doc-utils CVS.
Doc /
doc hakemisto sisältää dokumentaation gnome-doc -utils. Useimmissa tapauksissa, gnome-doc-utils tarvitaan rakentaa sen dokumentointi. Mekanismit ovat olemassa bootstrapping.
Xslt /
xslt hakemisto sisältää kaikki XSLT gnome-doc-utils. Erityisesti XSLT / docbook hakemisto sisältää DocBook XSLT, ja XSLT / gettext sisältää XSLT gettext apuohjelma käännöksestä automaattista tekstiä.
Hiekkalaatikko /
hiekkalaatikko hakemistoa ei DISTed, joten se vain, jos sinulla on CVS kassalla. Se on leikkipaikka uusia ideoita.
Xml2po /
xml2po hakemisto sisältää xml2po kehittämä Danilo Segan kääntämiseen mielivaltaisen XML-muodoissa. Sitä käytetään gnome-doc-utils DocBook käännös.
TESTAUS
Under testi hakemisto on useita testejä gnome-doc-utils. Voit testata rakentaa järjestelmä (gnome-doc-utils.m4 ja gnome-doc-utils.make), voit käyttää mitä tahansa testdocn (NA positiivinen kokonaisluku) hakemistoja. Nämä ovat perustettu luuranko raakapuustosta, käyttäytyy juuri niin kuin todellinen hanke. Myös gnome-doc-utils käyttää itse rakentaa oman dokumentaation (alle doc), joten gnome-doc-utils itsessään on testi rakentaa työkaluja.
Testaa DocBook stylesheets, käytä testi / testdocs hakemistoon. Nämä Osatestit ovat docbook-testdocs paketin docbook.sourceforge.net kehittämä Norm ja Co. yksinkertaisesti kirjoittamalla tehdä kyseisessä hakemistossa rakentaa kunkin testin. Jos nimi testin tiedosto on foo.001.xml, tuotanto on html / foo.001 / foo.001.html. Jokainen testi yleensä testaa pieni määrä liittyvien DocBook elementtejä. Monet piirteet DocBook tai XSLT gnome-doc-utils ei ehkä testata näitä. Lisätutkimukset voivat lisätä; noudata testi / testdocs / README jatkua.
myös hyödyllistä testattaessa XSLT on muuttaa joitakin suuria asiakirjoja käyttää sitä. GNOME-käyttöopas ja Gnumeric käsikirjan sekä toimivat mainiosti testi docs.
HAKKEROINNILTA
Toisin kuin useimmat C ohjelmointi, työskentelee paljon gnome-doc-utils ei todellakaan liity eristetty inkrementaalinen parannuksia. Ei ole mitään keinoa antaa lyhyen luettelon laaja ominaisuuksia tehtävälistallamme.
Työstääkseen build työkalut (gnome-doc-utils.m4 ja gnome-doc-utils.make), rakentaa testi docs ja katso, mitä ei toimi. gnome-doc-utils.make on luettelo kaikista korkean tason tavoitteet, jotka tulee antaa täysi tuki.
Työstääkseen DocBook XSLT, löytää elementti, jota ei ole vielä toteutettu, ja toteuttaa sitä . Jos sinulla on XML Starlet (xmlstar.sourceforge.net) asennettu, voit kirjoittaa "tehdä report.html" XSLT / docbook / html hakemistoon saada
mukava HTML-raportti siitä, mitä elementtejä toteutetaan. On myös TODO tiedosto tähän hakemistoon hyvin ytimekkään sanaluettelossa jotka on tehnyt, ei kuulua report.html.
Huomaa, että XSLT on dokumentoitu sitoutuva xsldoc, joka on itsessään osa gnome-doc-utils. Voit vapaasti työskennellä xsldoc samoin. Asiakirjat tuottama xsldoc sisältyy käsikirja alle doc / XSLT.

Mitä uutta tässä julkaisussa: