gnome-doc-utils

gnome-doc-utils-Pakete enthält eine Sammlung von Dokumentation Dienstprogramme für das Gnome-Projekt. Vor allem enthält es Versorgungsunternehmen für den Bau von Dokumentation und alle Hilfsdateien in Ihrem Quellbaum, und es ist die DocBook XSLT-Stylesheets, die einst mit Yelp verteilt wurden enthält. Beginnend mit Gnome 2.8 wird Yelp gnome-doc-utils für die XSLT benötigen.
ORGANISATION
test /
Das Testverzeichnis enthält eine Reihe von Tests für gnome -doc-utils. Die Verzeichnisse der Form testdocn, wobei n eine positive ganze Zahl sind Skelett Quelle Bäume Dokumentation enthalten, mit dem gleichen Layout, das durch konkrete Projekte verwendet werden würde. Die testdocs Verzeichnis enthält die Unit-Tests von docbook-testdocs, von Norm und Co. für die pan-galaktischen DocBook Stylesheets entwickelt. Eine zusätzliche Readme-Datei ist in dem Verzeichnis, geben Anweisungen über die Verlängerung oder Änderung eine der Dateien in gnome-doc-utils CVS.
Doc /
Der doc enthält die Dokumentation für gnome-doc -utils. In den meisten Fällen ist gnome-doc-utils benötigt, um ihre Dokumentation zu bauen. Mechanismen, die für das Bootstrapping.
Xslt /
Die XSLT-Verzeichnis enthält alle XSLT in gnome-doc-utils. Vor allem enthält die XSLT / docbook Verzeichnis der DocBook XSLT und XSLT / gettext enthält die XSLT-gettext-Werkzeug für die Übersetzung automatische text.
Sandbox /
Die Sandbox-Verzeichnis ist nicht DISTed, so wird es nur, wenn Sie ein CVS-Checkout haben. Es ist ein Kinderspielplatz für neue Ideen.
Xml2po /
Die xml2po Verzeichnis enthält die xml2po Tool von Danilo Segan für die Übersetzung beliebiger XML-Formate entwickelt. Es wird von gnome-doc-utils für DocBook Übersetzung verwendet.
PRÜFUNG
Unter dem Testverzeichnis
gibt eine Reihe von Tests für gnome-doc-utils. Um die Build-System (gnome-doc-utils.m4 und gnome-doc-utils.make) testen, können Sie eine der testdocn (für n eine positive ganze Zahl) Verzeichnisse verwendet werden. Diese werden als Skelett Quelle Bäumen, genau so verhält, wie ein reales Projekt würde. Auch gnome-doc-utils nutzt sich eigene Dokumentation (unter doc) zu bauen, so gnome-doc-utils selbst ist ein Test für die Build-Tools.
Um die DocBook-Stylesheets zu testen, verwenden Sie die test / Verzeichnisses testdocs. Diese Unit-Tests sind aus den docbook-testdocs Paket auf docbook.sourceforge.net, von Norm und Co. Geben Sie einfach machen in diesem Verzeichnis wird jeden Test zu bauen entwickelt. Wenn der Name der Testdatei ist foo.001.xml wird die auszugebenden html / foo.001 / foo.001.html. Jeder Test prüft in der Regel eine kleine Anzahl von verwandten DocBook-Elemente. Viele der Funktionen von DocBook oder des XSLT in gnome-doc-utils möglicherweise nicht von diesen geprüft werden. Zusätzliche Tests zugesetzt werden darf; folgen Sie den Anweisungen in test / testdocs / README dafür.
Auch nützlich für die Prüfung der XSLT ist es, einige große Dokumente mit ihm zu verwandeln. Die Gnome-Benutzerhandbuch und die Gnumeric Hand beide als hervorragende Test docs.
HACKING
Anders als die meisten C-Programmierung, arbeitet an viel von gnome-doc-utils wirklich einzubeziehen isoliert inkrementelle Verbesserungen. Es gibt keine Möglichkeit, eine kurze Liste der Features in einem breiten TODO-Liste zu geben.
Um auf die Build-Tools (gnome-doc-utils.m4 und gnome-doc-utils.make) arbeiten, bauen die Test docs und sehen, was nicht funktioniert. gnome-doc-utils.make hat eine Liste mit allen High-Level-Ziele, die vollständig unterstützt werden sollen.
Um auf der DocBook XSLT arbeiten, finden Sie ein Element, das noch nicht implementiert ist und umzusetzen . Wenn Sie XML-Starlet (xmlstar.sourceforge.net) installiert ist, können Sie "machen report.html" im XSLT / docbook / html zu
bekommen ein schönes HTML Bericht über welche Elemente implementiert sind. Außerdem gibt es eine TODO Datei in diesem Verzeichnis mit einem sehr knappen Liste der Spiele, die getan, dass nicht durch report.html gefangen werden müssen.
Beachten Sie, dass der XSLT ist inline mit xsldoc dokumentiert, die selbst ein Teil des gnome-doc-utils. Fühlen Sie sich frei, um auf xsldoc Arbeit als gut. Die durch xsldoc generierte Dokumentation im Handbuch unter doc / xslt enthalten

Was ist neu in dieser Pressemitteilung:.

• Fest Problem mit dist und installieren Sie mit zu vielen Dateien
• Aktualisiert Übersetzungen:
• km (Morn Met)

Was ist neu in der Version 0.20.9:

• Vorübergehend Zugabe RNG-Dateien zurück auf Kompatibilität. Nun, da die RNG-Dateien werden nicht mehr aufgerufen (ab 0.20.8) werden die RNG-Dateien wieder nach einer Übergangsphase entfernt werden.

Was ist neu in der Version 0.20.6:

• Aktualisiert Mallard Schema
• Feste 'machen Topf' Regel für Mallard
• Aktualisiert Übersetzungen:
• ca (Jordi Serratosa)
• n (Jorge Gonzalez, Daniel Mustieles)
• ug (Abduxukur Abdurixit)

Was ist neu in der Version 0.20.5:

• Aktualisiert Mallard RNG-Dateien
• Aktualisiert Übersetzungen:
• als (Amitakhya Phukan)
• bn_IN (Runa Bhattacharjee)
• eo (Kristjan SCHMIDT)
• n (Jorge Gonzalez)
• gu (Sweta Kothari)
• oder (Manoj Kumar Giri)

Was ist neu in der Version 0.20.3:

• Fest verschachtelten Befehlsersetzung in gnome-doc-utils .make (Chris Coleman)
• Aktualisiert Übersetzungen:
• ca @ Valencia (Carles Ferrando)
• de (Christian Kirbach)
• de (Mario Blättermann)
• el (Michael Kotsarinis)
• n (Jorge Gonzalez)
• et (Ivar Smolin)
• fa (Mahyar Moghimi)
• fr (Bruno Brouard)
• gl (Fran Dieguez)
• sl (Matej Urbancic)
• ug (Gheyret T.Kenji)

Was ist neu in der Version 0.20.2:

• Aktualisiert Übersetzungen:
• de (Mario Blättermann)
• en @ Shaw (Thomas Thurman)
• n (Jorge Gonzalez)
• fr (Geode)
• gl (Fran Dieguez)
• er (Yaron Shahrabani)
• hu (Gabor Kelemen)
• ID (Dirgita)
• ja (Takayuki Kusano)
• lv (Rudols Masuren)
• sl (Andrej Znidarsic)
• zh_CH (Aron Xu)