gnome-doc-utils

gnome-doc-utils pakkene inneholder en samling av dokumentasjon verktøy for Gnome-prosjektet. Spesielt, den inneholder verktøy for å bygge dokumentasjon og alle hjelpefiler i kildetreet, og den inneholder DocBook XSLT stilark som en gang ble distribuert med Yelp. Starter med Gnome 2.8, vil Yelp kreve gnome-doc-utils for XSLT.
ORGANISASJON
test /
Testen katalogen inneholder en rekke tester for gnome -doc-utils. Kataloger av skjemaet testdocn, der n er et positivt heltall, er skjelett kilde trær som inneholder dokumentasjon, med samme layout som ville bli brukt av aktuelle prosjekter. Den testdocs katalogen inneholder enheten testene fra DocBook-testdocs, utviklet av Norm og Co. for de pan-galaktiske DocBook stilark. En ekstra README filen er i den katalogen, og gir instruksjoner om å utvide eller endre noen av filene i gnome-doc-utils CVS.
Doc /
doc katalogen inneholder dokumentasjon for gnome-doc -utils. I de fleste tilfeller er gnome-doc-utils kreves for å bygge sin dokumentasjon. Mekanismer er på plass for bootstrapping.
Xslt /
XSLT katalogen inneholder alt av XSLT i gnome-doc-utils. Spesielt, inneholder XSLT / docbook katalogen den DocBook XSLT, og XSLT / gettext inneholder XSLT gettext verktøy for å oversette automatisk tekst.
Sandkasse /
Sandbox katalogen ikke er DISTed, så det vil bare vises hvis du har en CVS kassen. Det er en lekeplass for nye ideer.
Xml2po /
xml2po katalogen inneholder xml2po verktøy utviklet av Danilo Segan for oversettelse av vilkår XML-formater. Den brukes av gnome-doc-utils for DocBook oversettelse.
TESTING
Under testen katalogen finnes en rekke tester for gnome-doc-utils. Å teste bygge system (gnome-doc-utils.m4 og gnome-doc-utils.make), kan du bruke noe av testdocn (for na positivt heltall) kataloger. Disse er satt opp som skjelettet kilde trær, oppfører seg akkurat som et reelt prosjekt ville. Også, gnome-doc-utils bruker seg selv til å bygge sin egen dokumentasjon (under doc), så gnome-doc-utils seg selv er en test av bygge verktøy.
Å teste DocBook stilark, bruker test / testdocs katalogen. Disse enhet tester er fra DocBook-testdocs pakke på docbook.sourceforge.net, utviklet av Norm og Co. Bare å skrive gjøre i denne katalogen vil bygge hver test. Hvis navnet på testfilen er foo.001.xml, blir resultatet da html / foo.001 / foo.001.html. Hver test generelt tester et lite antall relaterte DocBook elementer. Mange av funksjonene i DocBook eller av XSLT i gnome-doc-utils kanskje ikke testet av disse. Ytterligere tester kan tilsettes; følg instruksjonene i test / testdocs / README for det.
Også nyttig for å teste XSLT er å forvandle noen store dokumenter ved hjelp av det. Gnome Brukerveiledning og Gnumeric Manual både tjene som gode test docs.
HACKING
motsetning til de fleste C-programmering, arbeider på mye av gnome-doc-utils egentlig innebærer isolert inkrementelle forbedringer. Det er ingen måte å gi en kort liste over brede funksjoner i en TODO-listen.
Å arbeide på bygge verktøy (gnome-doc-utils.m4 og gnome-doc-utils.make), bygge test docs og se hva som ikke fungerer. gnome-doc-utils.make har en liste over alle de høyt nivå mål som bør støttes fullt ut.
Å arbeide på DocBook XSLT, finne et element som ikke er implementert ennå, og gjennomføre det . Hvis du har XML Starlet (xmlstar.sourceforge.net) installert, kan du skrive 'gjøre report.html "i XSLT / docbook / html katalogen for å få
en fin HTML rapport om hva elementene er implementert. Det er også en TODO filen i denne katalogen med en svært kortfattet oversikt over kampene som må gjøres som kan ikke bli fanget opp av report.html.
Merk at XSLT er dokumentert inline med xsldoc, som selv er en del av gnome-doc-utils. Føl deg fri til å arbeide på xsldoc også. Dokumentasjonen som genereres av xsldoc er inkludert i håndboken under doc / XSLT

Hva er nytt i denne utgaven:.

• Fast problem med dist og installere med for mange filer
• Oppdaterte oversettelser:
• km (Morn Met)

Hva er nytt i versjon 0.20.9:

• Midlertidig legge RNG filene tilbake for kompatibilitet. Nå som RNG filer er ikke lenger kalles (som av 0.20.8), vil RNG filene bli fjernet igjen etter en overgangsperiode.

Hva er nytt i versjon 0.20.6:

• Oppdatert Mallard skjema
• Fast 'gjøre potten regelen for Mallard
• Oppdaterte oversettelser:
• ca (Jordi Serratosa)
• es (Jorge Gonzalez, Daniel Mustieles)
• ug (Abduxukur Abdurixit)

Hva er nytt i versjon 0.20.5:

• Oppdatert Mallard RNG filer
• Oppdaterte oversettelser:
• as (Amitakhya Phukan)
• bn_IN (Runa Bhattacharjee)
• eo (Kristjan SCHMIDT)
• es (Jorge Gonzalez)
• gu (Sweta Kothari)
• eller (Manoj Kumar Giri)

Hva er nytt i versjon 0.20.3:

• Fast nestet kommando substitusjon i gnome-doc-utils • Gjør (Chris Coleman)
• Oppdaterte oversettelser:
• 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)

Hva er nytt i versjon 0.20.2:

• Oppdaterte oversettelser:
• de (Mario Blattermann)
• no @ 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)