gnome-doc-utils

gnome-doc-utils paket innehåller en samling av dokumentverktyg för Gnome-projektet. Noterbart innehåller verktyg för att bygga dokumentation och alla tilläggsfiler i källträdet, och det innehåller DocBook XSLT som en gång delades ut med Yelp. Från och med Gnome 2.8, kommer Yelp kräva gnome-doc-utils för XSLT.

ORGANISATION

test /
Test katalogen innehåller ett antal tester för gnome -doc-utils. Kataloger av formen testdocn, där n är ett positivt heltal, är skelett källträd som innehåller dokumentation, med samma layout som skulle användas av konkreta projekt. Den testdocs katalogen innehåller enhetstester från DocBook-testdocs, som utvecklats av Norm och Co. för pan-galaktiska DocBook mallar. En ytterligare README fil i den katalogen, ge instruktioner om att förlänga eller ändra någon av filerna i gnome-doc-utils CVS.

Doc /
doc katalogen innehåller dokumentation för gnome-doc -utils. I de flesta fall är gnome-doc-utils krävs för att bygga sin dokumentation. Mekanismer finns på plats för bootstrapping.

XSLT /
XSLT katalogen innehåller alla XSLT i gnome-doc-utils. Noterbart XSLT / docbook katalogen innehåller DocBook XSLT, och XSLT / gettext innehåller XSLT gettext verktyg för att översätta automatisk text.

Sandlåda /
sandlådan katalogen inte DISTed, så det kommer bara om du har en CVS kassan. Det är en lekplats för nya idéer.

Xml2po /
xml2po katalogen innehåller xml2po verktyg utvecklat av Danilo Segan för översättning av godtyckliga XML-format. Det används av gnome-doc-utils för DocBook översättning.

TESTNING

Enligt test katalogen finns ett antal tester för gnome-doc-utils. För att testa byggsystem (gnome-doc-utils.m4 och gnome-doc-utils.make), kan du använda någon av testdocn (för na positivt heltal) kataloger. Dessa har inrättats som skelett källträd, beter precis som ett verkligt projekt skulle. Även gnome-doc-utils använder sig för att bygga sin egen dokumentation (under doc), så gnome-doc-utils i sig är ett test av byggverktygen.

Att testa DocBook mallar, använd test / testdocs katalogen. Dessa enhetstester är från DocBook-testdocs paketet på docbook.sourceforge.net, utvecklad av Norm och Co. Enkelt skriva gör i den katalogen kommer att bygga varje test. Om namnet på testfilen är foo.001.xml kommer produktionen att vara html / foo.001 / foo.001.html. Varje test testar allmänhet ett litet antal relaterade DocBook element. Många av funktionerna i DocBook eller XSLT i gnome-doc-utils kanske inte testas av dessa. Ytterligare tester kan läggas; följ instruktionerna i testet / testdocs / README för det.

Också användbart för att testa XSLT är att omvandla några stora dokument med det. Gnome användarhandboken och Gnumeric Manual både tjänar som goda test docs.

HACKING

skillnad från de flesta C-programmering, arbetar på en stor del av gnome-doc-utils verkligen innebär isolerade inkrementella förbättringar. Det finns inget sätt att ge en kort lista med breda drag i en TODO lista.

Att arbeta på byggverktyg (gnome-doc-utils.m4 och gnome-doc-utils.make), bygga Test docs och se vad som inte fungerar. gnome-doc-utils.make har en lista med alla på hög nivå mål som bör fullt stöd.

Att arbeta på DocBook XSLT, hitta ett element som inte genomförs ännu och genomföra den . Om du har XML Starlet (xmlstar.sourceforge.net) installerad, kan du skriva "gör report.html" i XSLT / docbook / html katalogen för att få
en trevlig HTML-rapport om vilka element förs. Det finns också en TODO-fil i den här katalogen med en mycket kortfattad lista med matcher som måste göras som inte kan fångas av report.html.

Observera att XSLT dokumenteras inline med xsldoc, som själv är en del av gnome-doc-utils. Känn dig fri att arbeta på xsldoc också. Dokumentationen som genereras av xsldoc ingår i manualen i doc / XSLT

Vad är nytt i den här versionen:.

• Fast problem med dist och installera med för många filer
• Uppdaterade översättningar:
• km (Morn Met)

Vad är nytt i version 0.20.9:

• Tillfälligt lägga RNG filer tillbaka för kompatibilitet. Nu när de RNG filerna inte längre kallas (som av 0.20.8), kommer RNG filerna tas bort igen efter en övergångsperiod.

Vad är nytt i version 0.20.6:

• Uppdaterad Gräsand schema
• Fast 'gör pot "regel för gräsand
• Uppdaterade översättningar:
• ca (Jordi Serratosa)
• es (Jorge Gonzalez, Daniel Mustieles)
• ug (Abduxukur Abdurixit)

Vad är nytt i version 0.20.5:

• Uppdaterade Gräsand RNG-filer
• Uppdaterade översättningar:
• som (Amitakhya Phukan)
• bn_IN (Runa Bhattacharjee)
• eo (Kristjan SCHMIDT)
• es (Jorge Gonzalez)
• gu (Sweta Kothari)
• eller (Manoj Kumar Giri)

Vad är nytt i version 0.20.3:

• Fast kapslade kommandosubstitutions i gnome-doc-utils .Gör (Chris Coleman)
• Uppdaterade översättningar:
• ca @ valencia (Carles Ferrando)
• de (Christian 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)

Vad är nytt i version 0.20.2:

• Uppdaterade översättningar:
• de (Mario Blattermann)
• sv @ Shaw (Thomas Thurman)
• es (Jorge Gonzalez)
• fr (Geode)
• gl (Fran Dieguez)
• han (Yaron Shahrabani)
• hu (Gabor Kelemen)
• id (Dirgita)
• ja (Takayuki Kusano)
• lv (Rudols Mazurs)
• sl (Andrej ŽNIDARŠIČ)
• zh_CH (Aron Xu)