Rev 721 |
Blame |
Compare with Previous |
Last modification |
View Log
| RSS feed
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY scrollkeeper-download-http "&gnome-download-http;/scrollkeeper/0.3/scrollkeeper-&scrollkeeper-version;.tar.bz2">
<!ENTITY scrollkeeper-download-ftp "&gnome-download-ftp;/scrollkeeper/0.3/scrollkeeper-&scrollkeeper-version;.tar.bz2">
<!ENTITY scrollkeeper-md5sum "b175e582a6cec3e50a9de73a5bb7455a">
<!ENTITY scrollkeeper-size "546 Kio">
<!ENTITY scrollkeeper-buildsize "12 Mio">
<!ENTITY scrollkeeper-time "0.1 SBU">
]>
<sect1 id="scrollkeeper" xreflabel="ScrollKeeper-&scrollkeeper-version;">
<?dbhtml filename="scrollkeeper.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2007-08-09 01:09:31 +0200 (jeu, 09 aoû 2007) $</date>
</sect1info>
<title>ScrollKeeper-&scrollkeeper-version;</title>
<indexterm zone="scrollkeeper">
<primary sortas="a-ScrollKeeper">ScrollKeeper</primary>
</indexterm>
<sect2 role="package">
<title>Introduction à ScrollKeeper</title>
<para>Le paquet <application>ScrollKeeper</application> contient
un système de catalogage de documentation. Il est utile pour gérer
des méta-données de documentation et fournir une API pour aider
les navigateurs à trouver, trier et chercher le catalogue de documents.</para>
<bridgehead renderas="sect3">Informations sur le paquet</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Téléchargement (HTTP) : <ulink url="&scrollkeeper-download-http;"/></para>
</listitem>
<listitem>
<para>Téléchargement (FTP) : <ulink url="&scrollkeeper-download-ftp;"/></para>
</listitem>
<listitem>
<para>Somme de contrôle MD5 du téléchargement : &scrollkeeper-md5sum;</para>
</listitem>
<listitem>
<para>Taille du téléchargement : &scrollkeeper-size;</para>
</listitem>
<listitem>
<para>Estimation de l'espace disque requis : &scrollkeeper-buildsize;</para>
</listitem>
<listitem>
<para>Estimation du temps de construction : &scrollkeeper-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">ScrollKeeper Dependencies</bridgehead>
<bridgehead renderas="sect4">Requises</bridgehead>
<para role="required"><xref linkend="libxslt"/>,
<xref linkend="DocBook"/> et
<xref linkend="perl-xml-parser"/></para>
<bridgehead renderas="sect4">Facultatives</bridgehead>
<para role="optional"><xref linkend="intltool"/></para>
<para condition="html" role="usernotes">Notes utilisateur :
<ulink url="&blfs-wiki;/scrollkeeper"/></para>
</sect2>
<sect2 role="installation">
<title>Installation de ScrollKeeper</title>
<para>Installez <application>ScrollKeeper</application> en lançant les
commandes suivantes :</para>
<screen><userinput>./configure --prefix=/usr \
--sysconfdir=/etc \
--localstatedir=/var \
--disable-static \
--with-omfdirs=/usr/share/omf:\
/opt/kde-&kde-version;/share/omf:\
/opt/gnome-&gnome-version;&gnome-minor-version;/share/omf &&
make</userinput></screen>
<para>Ce paquet n'est pas fourni avec une suite de tests.</para>
<para>Maintenant, en tant qu'utilisateur <systemitem class="username">root</systemitem> :</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Explication des commandes</title>
<para><parameter>--sysconfdir=/etc</parameter> : Ce paramètre met
les fichiers de configuration dans <filename class="directory">/etc</filename>
plutôt que dans <filename class='directory'>/usr/etc</filename>.</para>
<para><parameter>--localstatedir=/var</parameter> : Co paramètre met
le répertoire de base de données de <application>ScrollKeeper</application> dans
<filename class="directory">/var/lib/scrollkeeper</filename>.</para>
<para><parameter>--disable-static</parameter> : Ce paramètre empêche
la bibliothèque statique de se construire.</para>
<para><parameter>--with-omfdirs=...</parameter> : Ce paramètre définit
les emplacements des fichiers
<filename>OMF</filename> pour
<application>ScrollKeeper</application>. Modifiez les emplacements
si vous avez installé <application>KDE</application> et/ou <application>GNOME</application>-2
dans un préfixe nommé différemment de ceux montrés. Ces
informations sont stockées
dans <filename>/etc/scrollkeeper.conf</filename> et peuvent être
mises à jour à la main Si nécessaire.</para>
</sect2>
<sect2 role="configuration">
<title>Configuration de ScrollKeeper</title>
<sect3 id="scrollkeeper-config">
<title>Fichiers de configuration</title>
<para><filename>/etc/scrollkeeper.conf</filename></para>
<indexterm zone="scrollkeeper scrollkeeper-config">
<primary sortas="e-etc-scrollkeeper.conf">/etc/scrollkeeper.conf</primary>
</indexterm>
</sect3>
<sect3>
<title>Informations de configuration</title>
<para>Le fichier de configuration règle la variable
<envar>OMF_DIR</envar> à l'endroit où se trouvent tous les répertoires
<filename class="directory">omf</filename> du système. Cela a été
réglé ainsi dans la commande
<command>configure</command>, donc aucune manipulation supplémentaire n'est
nécessaire jusqu'à ce qu'un autre répertoire
<filename>OMF</filename> soit créé.</para>
</sect3>
</sect2>
<sect2 role="content">
<title>Contenu</title>
<segmentedlist>
<segtitle>Programmes installés</segtitle>
<segtitle>Bibliothèque installée</segtitle>
<segtitle>Répertoires installés</segtitle>
<seglistitem>
<seg>scrollkeeper-config, scrollkeeper-extract, scrollkeeper-gen-seriesid,
scrollkeeper-get-cl, scrollkeeper-get-content-list,
scrollkeeper-get-extended-content-list, scrollkeeper-get-index-from-docpath,
scrollkeeper-get-toc-from-docpath, scrollkeeper-get-toc-from-id,
scrollkeeper-install, scrollkeeper-preinstall, scrollkeeper-rebuilddb,
scrollkeeper-uninstall, et scrollkeeper-update</seg>
<seg>libscrollkeeper.so</seg>
<seg>/usr/share/doc/scrollkeeper-&scrollkeeper-version;,
/usr/share/{omf, {,xml/}scrollkeeper}, et
/var/lib/scrollkeeper</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Descriptions courtes</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry>
<term><command>ScrollKeeper utility programs</command></term>
<listitem>
<para>Les programmes outils <application>ScrollKeeper</application>
et les scripts listés ci-dessus permettent d'installer, d'effectuer,
d'obtenir et de mettre à jour des fichiers de tables des matières.</para>
</listitem>
</varlistentry>
<varlistentry id="libscrollkeeper">
<term><filename class='libraryfile'>libscrollkeeper.so</filename></term>
<listitem>
<para>fournit l'API nécessaire pour aider les navigateurs à
interagir avec la documentation écrite pour utiliser
<application>ScrollKeeper</application>.</para>
<indexterm zone="scrollkeeper libscrollkeeper">
<primary sortas="c-libscrollkeeper">libscrollkeeper.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>