GTK-Doc bekommen

1.3.1. Erfordernisse

Perl v5 - Die Hauptskripte wurden in Perl geschrieben.

DocBook DTD v3.0 - Die DTD für DocBook SGML. http://www.ora.com/davenport

Jade v1.1 - Dies ist ein DSSSL-Prozessor zur Umwandlung von SGML in verschiedene Formate. http://www.jclark.com/jade

Modulare DocBook-Stilvorlagen Dies ist der DSSSL-Code zur Umwandlung von DocBook in HTML und einige andere Formate. Es wird zusammen mit Jade benutzt. Ich habe den DSSSL-Code in gtk-doc.dsl etwas angepasst, um die Programmcode-Listings und -Deklarationen einzufärben und um globale Cross-Reference-Indizes im erzeugten HTML zu unterstützen. http://nwalsh.com/docbook/dsssl

docbook-to-man - if you want to create man pages from the DocBook. I've customized the 'translation spec' slightly, to capitalise section headings and add the 'GTK Library' title at the top of the pages and the revision date at the bottom. There is a link to this on http://www.ora.com/davenport NOTE: This does not work yet.

1.3.2. Installation

Es gibt keinen Standardort, an welchem die Modularen DocBook-Stilvorlagen installiert werden.

Das Configure-Skript von GTK-Doc durchsucht folgende drei Ordner automatisch:

/usr/lib/sgml/stylesheets/nwalsh-modular (verwendet von RedHat)

/usr/lib/dsssl/stylesheets/docbook (verwendet von Debian)

/usr/share/sgml/docbkdsl (verwendet von SuSE)

Falls sie Stilvorlagen an anderen Orten installiert haben, müssen Sie GTK-Doc mit folgender Option konfigurieren: --with-dsssl-dir=<PFAD_ZUM_BASISORDNER_DER_STILVORLAGEN>