Obtention de GTK-Doc

I.III.I. Pré-requis

Perl v5 - les principaux scripts sont écrits en Perl.

DocBook DTD v3.0 - ce sont les DTD DocBook SGML. http://www.ora.com/davenport

Jade v1.1 - c'est un moteur DSSSL pour convertir le SGML en divers formats. http://www.jclark.com/jade

Modular DocBook Stylesheets - c'est le code DSSSL utilisé pour convertir de DocBook vers HTML (ainsi que quelques autres formats). Il est utilisé conjointement avec Jade. J'ai légèrement personnalisé le code DSSSL, dans gtk-doc.dsl, pour coloriser les listings de code du programme et les déclarations ainsi que pour prendre en charge les indices globaux des références croisées dans le HTML généré. http://nwalsh.com/docbook/dsssl

docbook-to-man - si vous souhaitez créer des pages de manuel depuis DocBook. J'ai légèrement adapté les « spécifications de traduction » pour mettre en majuscule les en-têtes de section et pour ajouter le titre « GTK Library » en haut des pages et la date de révision en bas. Il y a un lien sur cela ici http://www.ora.com/davenport. Note : cela ne fonctionne pas encore.

I.III.II. Installation

Il n'y a pas d'emplacement standard pour l'installation des feuilles de styles modulaires de DocBook.

Les scripts d'installation de GTK-Doc cherchent dans ces trois répertoires automatiquement :

/usr/lib/sgml/stylesheets/nwalsh-modular (utilisé par Red Hat)

/usr/lib/dsssl/stylesheets/docbook (utilisé par Debian)

/usr/share/sgml/docbkdsl (utilisé par SuSE)

Si les feuilles de styles sont installées autre part, vous devez configurer GTK-Doc en utilisant l'option : --with-dsssl-dir=<CHEMIN_VERS_REPERTOIRE_RACINE_FEUILLES2STYLEs>.