Subversion Repositories svn LFS-FR

Rev

Rev 7025 | Blame | Compare with Previous | Last modification | View Log | RSS feed

<?xml version="1.0" encoding="UTF-8"?>
<!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 DocBook-download-http "http://www.docbook.org/xml/&DocBook-version;/docbook-xml-&DocBook-version;.zip">
  <!--<!ENTITY DocBook-download-ftp  "&gentoo-ftp-repo;/docbook-xml-&DocBook-version;.zip">-->
  <!ENTITY DocBook-download-ftp  " ">
  <!ENTITY DocBook-md5sum        "03083e288e87a7e829e437358da7ef9e">
  <!ENTITY DocBook-size          "96 Ko">
  <!ENTITY DocBook-buildsize     "1.2 Mo">
  <!ENTITY DocBook-time          "moins de 0.1 SBU">
]>
<sect1 id="DocBook" xreflabel="DocBook XML-DTD-&DocBook-version;">
  <?dbhtml filename="DocBook.html"?>
  <sect1info>
    <othername>$LastChangedBy&nbsp;: bdubbs $</othername>
    <date>$Date&nbsp;: 2013-03-13 18:58:54 +0100 (Wed, 13 Mar 2013) $</date>
  </sect1info>
  <title>DocBook XML-DTD-&DocBook-version;</title>
  <indexterm zone="DocBook">
    <primary sortas="a-DocBook-XML-DTD">DocBook XML DTD</primary>
  </indexterm>
  <sect2 role="package">
    <title>Introduction à DocBook XML DTD</title>
    <para>Le paquet <application>DocBook XML DTD</application>-&DocBook-version;
    contient des définitions de types de document pour la vérification de
    données de fichiers XML vis-à-vis de la réglementation DocBook. Ils sont
    utiles pour structurer des livres et des documentations de logiciels selon
    un standard vous permettant d'utiliser des transformations déjà écrites
    pour ce standard.</para>
    &lfs78_checked;
    <bridgehead renderas="sect3">Informations sur le paquet</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Téléchargement (HTTP)&nbsp;: <ulink url="&DocBook-download-http;"/></para>
      </listitem>
      <listitem>
        <para>Téléchargement (FTP)&nbsp;: <ulink url="&DocBook-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>Somme de contrôle MD5 du téléchargement&nbsp;: &DocBook-md5sum;</para>
      </listitem>
      <listitem>
        <para>Taille du téléchargement&nbsp;: &DocBook-size;</para>
      </listitem>
      <listitem>
        <para>Estimation de l'espace disque requis&nbsp;: &DocBook-buildsize;</para>
      </listitem>
      <listitem>
        <para>Estimation du temps de construction&nbsp;: &DocBook-time;</para>
      </listitem>
    </itemizedlist>
    <bridgehead renderas="sect3">Dépendances de DocBook XML DTD</bridgehead>
    <bridgehead renderas="sect4">Requises</bridgehead>
    <para role="required"><xref linkend="libxml2"/>
    <xref linkend="sgml-common"/>, et
    <xref linkend="unzip"/></para>
    <para condition="html" role="usernotes">Notes utilisateur&nbsp;:
    <ulink url="&blfs-wiki;/docbook-xml"/></para>
  </sect2>
  <sect2 role="installation">
    <title>Installation de DocBook XML DTD</title>
    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
   href="../../xincludes/use-unzip.xml"/>
    <para>Installez <application>DocBook XML DTD</application> en lançant les
    commandes suivantes en tant qu'utilisateur <systemitem class="username">root</systemitem>&nbsp;:</para>
<screen role="root">
<userinput>install -v -d -m755 /usr/share/xml/docbook/xml-dtd-&DocBook-version; &amp;&amp;
install -v -d -m755 /etc/xml &amp;&amp;
chown -R root:root . &amp;&amp;
cp -v -af docbook.cat *.dtd ent/ *.mod     /usr/share/xml/docbook/xml-dtd-&DocBook-version;</userinput>
</screen>
    <para>Créez (ou mettez à jour) et peuplez un fichier catalogue
    <filename>/etc/xml/docbook</filename> en lançant les commandes suivantes
    en tant qu'utilisateur <systemitem class="username">root</systemitem>&nbsp;:</para>
<screen role="root">
<?dbfo keep-together="auto"?><userinput>if [ ! -e /etc/xml/docbook ]; then
    xmlcatalog --noout --create /etc/xml/docbook
fi &amp;&amp;
xmlcatalog --noout --add "public"     "-//OASIS//DTD DocBook XML V&DocBook-version;//EN"     "http://www.oasis-open.org/docbook/xml/&DocBook-version;/docbookx.dtd"     /etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "public"     "-//OASIS//DTD DocBook XML CALS Table Model V&DocBook-version;//EN"     "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/calstblx.dtd"     /etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "public"     "-//OASIS//DTD XML Exchange Table Model 19990315//EN"     "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/soextblx.dtd"     /etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "public"     "-//OASIS//ELEMENTS DocBook XML Information Pool V&DocBook-version;//EN"     "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/dbpoolx.mod"     /etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "public"     "-//OASIS//ELEMENTS DocBook XML Document Hierarchy V&DocBook-version;//EN"     "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/dbhierx.mod"     /etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "public"     "-//OASIS//ELEMENTS DocBook XML HTML Tables V&DocBook-version;//EN"     "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/htmltblx.mod"     /etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "public"     "-//OASIS//ENTITIES DocBook XML Notations V&DocBook-version;//EN"     "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/dbnotnx.mod"     /etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "public"     "-//OASIS//ENTITIES DocBook XML Character Entities V&DocBook-version;//EN"     "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/dbcentx.mod"     /etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "public"     "-//OASIS//ENTITIES DocBook XML Additional General Entities V&DocBook-version;//EN"     "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/dbgenent.mod"     /etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "rewriteSystem"     "http://www.oasis-open.org/docbook/xml/&DocBook-version;"     "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;"     /etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "rewriteURI"     "http://www.oasis-open.org/docbook/xml/&DocBook-version;"     "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;"     /etc/xml/docbook</userinput>
</screen>
    <para>Créez (ou mettez à jour) et peuplez un fichier catalogue
    <filename>/etc/xml/catalog</filename> en lançant les commandes suivantes
    en tant qu'utilisateur <systemitem class="username">root</systemitem>&nbsp;:</para>
<screen role="root">
<userinput>if [ ! -e /etc/xml/catalog ]; then
    xmlcatalog --noout --create /etc/xml/catalog
fi &amp;&amp;
xmlcatalog --noout --add "delegatePublic"     "-//OASIS//ENTITIES DocBook XML"     "file:///etc/xml/docbook"     /etc/xml/catalog &amp;&amp;
xmlcatalog --noout --add "delegatePublic"     "-//OASIS//DTD DocBook XML"     "file:///etc/xml/docbook"     /etc/xml/catalog &amp;&amp;
xmlcatalog --noout --add "delegateSystem"     "http://www.oasis-open.org/docbook/"     "file:///etc/xml/docbook"     /etc/xml/catalog &amp;&amp;
xmlcatalog --noout --add "delegateURI"     "http://www.oasis-open.org/docbook/"     "file:///etc/xml/docbook"     /etc/xml/catalog</userinput>
</screen>
  </sect2>
  <sect2 role="configuration">
    <title>Configuration de DocBook XML DTD</title>
    <sect3 id="docbook-config">
      <title>Fichiers de configuration</title>
      <para><filename>/etc/xml/catalog</filename>,
      <filename>/etc/xml/docbook</filename></para>
      <indexterm zone="DocBook docbook-config">
        <primary sortas="e-etc-xml-docbook">/etc/xml/docbook</primary>
      </indexterm>
      <indexterm zone="DocBook docbook-config">
        <primary sortas="e-etc-xml-catalog">/etc/xml/catalog</primary>
      </indexterm>
    </sect3>
    <sect3>
      <title>Informations de configuration</title>
      <para>L'installation ci-dessus crée les fichiers et met à jour les catalogues.
      Afin d'installer ou de mettre à jour <application>ScrollKeeper</application>,
      utilisez <application>DocBook XML DTD</application> V&DocBook-version;
      quand on vous demande la version 4.x dans l'identifiant système, vous
      devez ajouter des données supplémentaires aux fichiers catalogues. Si
      vous avez déjà installé sur votre système un des <application>DocBook XML DTD</application>
      référencé ci-dessous, supprimez ces entrées de la commande
      <command>for</command>  ci-dessous (effectuez les commandes en tant
      qu'utilisateur <systemitem class="username">root</systemitem>)&nbsp;:</para>
<screen role="root">
<userinput>for DTDVERSION in 4.1.2 4.2 4.3 4.4
do
  xmlcatalog --noout --add "public"     "-//OASIS//DTD DocBook XML V$DTDVERSION//EN"     "http://www.oasis-open.org/docbook/xml/$DTDVERSION/docbookx.dtd"     /etc/xml/docbook
  xmlcatalog --noout --add "rewriteSystem"     "http://www.oasis-open.org/docbook/xml/$DTDVERSION"     "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;"     /etc/xml/docbook
  xmlcatalog --noout --add "rewriteURI"     "http://www.oasis-open.org/docbook/xml/$DTDVERSION"     "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;"     /etc/xml/docbook
  xmlcatalog --noout --add "delegateSystem"     "http://www.oasis-open.org/docbook/xml/$DTDVERSION/"     "file:///etc/xml/docbook"     /etc/xml/catalog
  xmlcatalog --noout --add "delegateURI"     "http://www.oasis-open.org/docbook/xml/$DTDVERSION/"     "file:///etc/xml/docbook"     /etc/xml/catalog
done</userinput>
</screen>
    </sect3>
  </sect2>
  <sect2 role="content">
    <title>Contenu</title>
    <segmentedlist>
      <segtitle>Programmes installés</segtitle>
      <segtitle>Bibliothèques installées</segtitle>
      <segtitle>Installed Files</segtitle>
      <segtitle>Répertoires installés</segtitle>
      <seglistitem>
        <seg>Aucun</seg>
        <seg>Aucune</seg>
        <seg>Fichiers DTD, MOD et ENT</seg>
        <seg>/etc/xml et /usr/share/xml/docbook/xml-dtd-&DocBook-version;</seg>
      </seglistitem>
    </segmentedlist>
    <variablelist>
      <bridgehead renderas="sect3">Descriptions courtes</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>
      <varlistentry id="DTD-files">
        <term><filename>DTD files</filename></term>
        <listitem>
          <para>contient une définition de type de document qui définit les
          types d'élément et les listes d'attributs qu'on peut utiliser dans les
          fichiers <filename>XML</filename> correspondants.</para>
          <indexterm zone="DocBook DTD-files">
            <primary sortas="g-DTD-files">DTD Files</primary>
          </indexterm>
        </listitem>
      </varlistentry>
      <varlistentry id="MOD-files">
        <term><filename>MOD files</filename></term>
        <listitem>
          <para>ces fichiers contiennent les composants de la définition du
          type de document ayant pour source les fichiers
          <filename>DTD</filename>.</para>
          <indexterm zone="DocBook MOD-files">
            <primary sortas="g-MOD-files">MOD files</primary>
          </indexterm>
        </listitem>
      </varlistentry>
      <varlistentry id="ENT-files">
        <term><filename>ENT files</filename></term>
        <listitem>
          <para>fichiers contenant des listes d'entités de caractères nommés
          autorisées en HTML.</para>
          <indexterm zone="DocBook ENT-files">
            <primary sortas="g-ENT-files">ENT-files</primary>
          </indexterm>
        </listitem>
      </varlistentry>
    </variablelist>
  </sect2>
</sect1>