Système de catalogue ScrollKeeper

ScrollKeeper est un système de catalogue pour la documentation. Sa fonction principale est de gérer les informations des fichiers OMF pour le navigateur d'aide. Lorsque vous installez une application, le fichier OMF est copié dans le répertoire $préfixe/share/omf/<nom_application>.

ScrollKeeper construit une table des matières à partir de la collection de fichiers OMF dans les répertoires spécifiés par le fichier $préfixe/etc/scrollkeeper.conf. Ce fichier consiste généralement en une seule ligne contenant la définition de OMF_DIR sous forme d'une liste de répertoires à parcourir récursivement, séparés par une virgule.

OMF_DIR=/usr/share/omf:/usr/local/share/omf:/opt/gnome2/share/omf:/opt/kde/omf

ScrollKeeper contient une hiérarchie de catégories thématiques pouvant s'appliquer à des documents d'aide. La catégorie thématique du document dans son fichier OMF détermine l'emplacement du document dans la table des matières présentée par le navigateur d'aide.

La hiérarchie des catégories thématiques est définie dans le fichier $préfixe/scrollkeeper/Templates/<langue>/scrollkeeper_cl.xml. La catégorie thématique d'un document doit correspondre à une catégorie définie dans ce fichier.

Pour plus d'informations sur le système Scrollkeeper, consultez le site Web http://scrollkeeper.sourceforge.net/.

Si le document d'aide XML est déplacé à un nouvel emplacement, il s'agit également de mettre à jour l'emplacement indiqué dans le fichier OMF.