gnome-doc-utils

gnome-doc-utils-pakker indeholder en samling af dokumentation værktøjer til Gnome-projektet. Især indeholder hjælpeprogrammer til at opbygge dokumentation og alle ekstra filer i din kilde træ, og den indeholder DocBook XSLT stylesheets, som engang blev fordelt med Yelp. Startende med Gnome 2.8, vil Yelp kræve gnome-doc-utils til XSLT.
ORGANISATION
test /
Testen mappe indeholder en række tests for gnome -doc-utils. Mapper af formen testdocn, hvor n er et positivt heltal, er skelet trækilden indeholdende dokumentation med samme layout, der vil blive anvendt af andre projekter. Den testdocs mappe indeholder de unit tests fra DocBook-testdocs, udviklet af Norm og Co. for pan-galaktiske DocBook stylesheets. En yderligere README fil er i denne folder, der giver instruktioner om at udvide eller ændre nogen af ​​filerne i gnome-doc-utils CVS.
Doc /
Den doc mappe indeholder dokumentation for gnome-doc -utils. I de fleste tilfælde er gnome-doc-utils kræves for at opbygge sin dokumentation. Mekanismer er på plads til bootstrapping.
XSLT /
XSLT mappe indeholder alle de XSLT i gnome-doc-utils. Især XSLT / docbook mappe indeholder DocBook XSLT, og XSLT / gettext indeholder XSLT gettext værktøj til at oversætte automatisk tekst.
Sandkasse /
Sandkassen biblioteket ikke er DISTed, så det vil kun, hvis du har en CVS kassen. Det er en legeplads for nye ideer.
Xml2po /
Den xml2po mappe indeholder xml2po værktøj udviklet af Danilo Segan til oversættelse af vilkårlige XML-formater. Det bruges af gnome-doc-utils til DocBook oversættelse.
TEST
Under testen biblioteket er en række tests for gnome-doc-utils. For at teste byggesystemet (gnome-doc-utils.m4 og gnome-doc-utils.make), kan du bruge nogen af ​​testdocn (for na positivt heltal) mapper. Disse er oprettet som skelet kilde træer, opfører præcis som et egentligt projekt ville. Også gnome-doc-utils bruger selv at opbygge sin egen dokumentation (under doc), så gnome-doc-utils selv er en test af byggeværktøjerne.
At teste DocBook stylesheets, skal du bruge test / testdocs bibliotek. Disse unit test er fra DocBook-testdocs pakke på docbook.sourceforge.net, udviklet af Norm og Co. blot at skrive at i denne folder vil bygge hver test. Hvis navnet på den testfil er foo.001.xml, vil produktionen være html / foo.001 / foo.001.html. Hver test tester generelt et mindre antal relaterede DocBook elementer. Mange af funktionerne i DocBook eller XSLT i gnome-doc-utils muligvis ikke testet af disse. Yderligere tests kan tilføjes; følg instruktionerne i test / testdocs / README for.
Også nyttigt til test af XSLT er at omdanne nogle store dokumenter ved hjælp af det. Den Gnome brugervejledning og Gnumeric Manual både tjener som fremragende test docs.
HACKING
modsætning til de fleste C programmering, der arbejder på en stor del af gnome-doc-utils virkelig indebærer isoleret gradvise forbedringer. Der er ingen måde at give en kort liste over brede træk i en TODO liste.
At arbejde på byggeværktøjerne (gnome-doc-utils.m4 og gnome-doc-utils.make), bygge test-dokumentation og se, hvad der ikke virker. gnome-doc-utils.make har en liste over alle mål på højt niveau, der skal være fuldt understøttet.
At arbejde på DocBook XSLT, finde et element, der er ikke implementeret endnu, og gennemføre den . Hvis du har XML Starlet (xmlstar.sourceforge.net) installeret, kan du skrive 'gøre report.html "i XSLT / DocBook / html mappe for at få
en dejlig HTML rapport om, hvilke elementer gennemføres. Der er også en TODO fil i denne mappe med en meget kortfattet liste over kampe, der skal gøres, som ikke kan fanges af report.html.
Bemærk at XSLT er dokumenteret inline med xsldoc, som selv er en del af gnome-doc-utils. Du er velkommen til at arbejde på xsldoc så godt. Dokumentationen genereret af xsldoc er inkluderet i manualen under doc / XSLT

Hvad er nyt i denne udgivelse:.

• Fast problem med dist og installere med for mange filer
• Opdateret oversættelser:
• km (Morn Met)

Hvad er nyt i version 0.20.9:

• Midlertidigt tilføje RNG filer tilbage til kompatibilitet. Nu, at RNG filerne ikke længere kaldes (fra 0.20.8), vil RNG filerne fjernes igen efter en overgangsperiode.

Hvad er nyt i version 0.20.6:

• Opdateret Mallard schema
• Fast 'gøre puljen' regel for Mallard
• Opdateret oversættelser:
• Ca (Jordi Serratosa)
• es (Jorge Gonzalez, Daniel Mustieles)
• UG (Abduxukur Abdurixit)

Hvad er nyt i version 0.20.5:

• Opdateret Mallard RNG-filer
• Opdateret oversættelser:
• som (Amitakhya Phukan)
• bn_IN (Runa Bhattacharjee)
• eo (Kristjan SCHMIDT)
• es (Jorge Gonzalez)
• gu (Sweta Kothari)
• eller (Manoj Kumar Giri)

Hvad er nye i version 0.20.3:

• Fast indlejret kommando substitution i gnome-doc-utils .make (Chris Coleman)
• Opdateret oversættelser:
• 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)

Hvad er nyt i version 0.20.2:

• Opdateret oversættelser:
• de (Mario Blattermann)
• da @ 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 Znidarsic)
• zh_CH (Aron Xu)