gnome-doc-utils

gnome-doc-utils balení obsahuje sbírku dokumentace utilit pro projekt GNOME. Zejména, obsahuje nástroje pro stavební dokumentace a všechny pomocné soubory ve zdrojovém stromu a obsahuje XSLT styly DocBook, které byly kdysi distribuované s Yelp. Počínaje Gnome 2.8, bude Yelp vyžadovat gnome-doc-utils pro XSLT.
Organizaci v pračce test /
Test adresář obsahuje řadu testů pro GNOME -doc-utils. Adresáře na formu testdocn, kde n je kladné celé číslo, je kostra zdrojové stromy, které obsahují dokumentaci, se stejným rozložením, který by byl používán konkrétních projektů. Adresář testdocs obsahuje jednotkové testy z docbook-testdocs, vyvinutý Norm a Co. pro pan-galaktických DocBook stylů. Další README soubor je v adresáři, což pokynů na rozšíření či změnu některý ze souborů v gnome-doc-utils CVS.
Doc /
Adresář doc obsahuje dokumentaci pro gnome-doc -utils. Ve většině případů je nutná gnome-doc-utils stavět jeho dokumentace. Mechanismy jsou na místě pro start instalace.
XSLT /
Adresář XSLT obsahuje všechny XSLT v gnome-doc-utils. Pozoruhodně, adresář XSLT / DocBook obsahuje DocBook XSLT, a XSLT / gettext obsahuje XSLT gettext nástroj pro překlad automatického textu.
Sandbox /
adresář pískoviště není DISTed, tak to bude se objeví pouze v případě, že máte CVS pokladně. Je to hřiště pro nové nápady.
Xml2po /
Adresář xml2po obsahuje xml2po nástroj vyvinutý Danilo Segan pro překlad libovolných formátech XML. To je používáno gnome-doc-utils pro DocBook překlad.
ZKOUŠKY pračce V rámci testovacího adresáře řada testů na gnome-doc-utils. Chcete-li vyzkoušet sestavení systému (gnome-doc-utils.m4 a gnome-doc-utils.make), můžete použít některý z testdocn (pro na pozitivní celé číslo) adresáře. Ty jsou nastaveny jako kostru zdroje stromy, se chová přesně tak, jak skutečný projekt bude. Také, gnome-doc-utils používá se vybudovat vlastní dokumentaci (v doc), tak gnome-doc-utils je sám o sobě test sestavení nástrojů. Pračce Pro testování styly DocBook, použijte test / testdocs adresář. Tyto jednotkové testy jsou z balíku docbook-testdocs na docbook.sourceforge.net, vyvinutý Norm a Co. jednoduše zadáním, aby v tomto adresáři budou stavět každé zkoušky. Je-li název souboru testu je foo.001.xml, bude výstup html / foo.001 / foo.001.html. Každý test obvykle testuje malé množství souvisejících DocBook prvků. Mnoho funkcí DocBook nebo XSLT v gnome-doc-utils nemusí být testovány tyto. Mohou být přidány další zkoušky; postupujte podle pokynů v testu / testdocs / README na to.
také užitečné pro testování XSLT je učinit z některých velkých dokumentů používat. Uživatelská příručka Gnome a Manual oba Gnumeric slouží jako vynikající testovací dokumenty.
HACKING v pračce Na rozdíl od většiny programování v jazyce C, pracuje na hodně z gnome-doc-utils opravdu zapojit izolovaný postupně vylepšovat. Neexistuje žádný způsob, jak dát krátký seznam hlavních funkcí v seznamu TODO. Pračce Chcete-li pracovat na vytváření nástrojů (gnome-doc-utils.m4 a gnome-doc-utils.make), stavět Zkušební dokumenty a vidět to, co nefunguje. gnome-doc-utils.make má seznam všech cílů na vysoké úrovni, které by měly být plně podporovány. pračce Chcete-li pracovat na DocBook XSLT, najít prvek, který ještě není implementována a provádět je , Pokud máte nainstalován XML Starlet (xmlstar.sourceforge.net), můžete zadat "udělat report.html 'v XSLT / docbook / html adresáře získat
pěkný zprávu ve formátu HTML na to, co jsou implementovány prvky. K dispozici je také soubor TODO v tomto adresáři s velmi výstižný seznam zápasů, které je třeba udělat, aby nemohly být zachyceny pomocí report.html.
Všimněte si, že XSLT je dokumentován inline s xsldoc, což je samo o sobě součástí gnome-doc-utils. Neváhejte a pracovat na xsldoc stejně. Dokumentace generované xsldoc je zahrnuta v manuálu pod doc / XSLT

Co je nového v této verzi:.

• Pevné Problém s dest a instalovat se příliš mnoho souborů
• Aktualizováno překlady:
• km (Morn Met)

Co je nového ve verzi 0.20.9:

• Dočasně přidání RNG soubory zpět na kompatibilitu. Nyní, že RNG soubory již nejsou nazývají (od 0.20.8), budou RNG soubory opět odstraněn po přechodném období.

Co je nového ve verzi 0.20.6:

• Aktualizováno Mallard schématu
• Pevná ', aby pot "pravidlo pro divoké
• Aktualizováno překlady:
• ca (Jordi Serratosa)
• es (Jorge González, Daniel Mustieles)
• ug (Abduxukur Abdurixit)

Co je nového ve verzi 0.20.5:

• Aktualizované soubory Mallard RNG
• Aktualizováno překlady:
• as (Amitakhya Phukan)
• bn_IN (Runa Bhattacharjee)
• EO (Kristjan SCHMIDT)
• es (Jorge Gonzalez)
• gu (Sweta Kothari)
• nebo (Manoj Kumar Giri)

Co je nového ve verzi 0.20.3:

• Pevné vnořené substituční příkaz gnome-doc-utils .make (Chris Coleman)
• Aktualizováno překlady:
• 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)

Co je nového ve verzi 0.20.2:

• Aktualizováno překlady:
• de (Mario Blattermann)
• en @ Shaw (Thomas Thurman)
• es (Jorge Gonzalez)
• fr (Geode)
• GL (Fran Dieguez)
• on (Yaron Shahrabani)
• hu (Gabor Kelemen)
• id (Dirgita)
• ja (Takayuki Kusano)
• lv (Rudols Mazurs)
• sl (Andrej Znidarsic)
• zh_CH (Aron Xu)