Subversion Repositories svn LFS-FR

<?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 libxml2-download-http "http://xmlsoft.org/sources/libxml2-&libxml2-version;.tar.gz">

  <!ENTITY libxml2-download-ftp  "ftp://xmlsoft.org/libxml2/libxml2-&libxml2-version;.tar.gz">

  <!ENTITY libxml2-md5sum        "daece17e045f1c107610e137ab50c179">

  <!ENTITY libxml2-size          "5.2 Mo">

  <!ENTITY libxml2-buildsize     "95 Mo (additional 20 Mo for tests)">

  <!ENTITY libxml2-time          "0.5 SBU (additional 0.2 SBU for tests)">

  <!ENTITY testsuite-version     "20130923">

]>

<sect1 id="libxml2" xreflabel="libxml2-&libxml2-version;">

  <?dbhtml filename="libxml2.html"?>

  <sect1info>

    <othername>$LastChangedBy : bdubbs $</othername>

    <date>$Date : 2013-03-04 19:52:20 +0100 (Mon, 04 Mar 2013) $</date>

  </sect1info>

  <title>libxml2-&libxml2-version;</title>

  <indexterm zone="libxml2">

    <primary sortas="a-Libxml2">Libxml2</primary>

  </indexterm>

  <sect2 role="package">

    <title>Introduction à libxml2</title>

    <para>Le paquet <application>libxml2</application> contient

    des bibliothèques et des utilitaires utilisés pour analyser des fichiers XML.</para>

    &lfs78_checked;

    <bridgehead renderas="sect3">Informations sur le paquet</bridgehead>

    <itemizedlist spacing="compact">

      <listitem>

        <para>Téléchargement (HTTP)&nbsp;: <ulink url="&libxml2-download-http;"/></para>

      </listitem>

      <listitem>

        <para>Téléchargement (FTP)&nbsp;: <ulink url="&libxml2-download-ftp;"/></para>

      </listitem>

      <listitem>

        <para>Somme de contrôle MD5 du téléchargement&nbsp;: &libxml2-md5sum;</para>

      </listitem>

      <listitem>

        <para>Taille du téléchargement&nbsp;: &libxml2-size;</para>

      </listitem>

      <listitem>

        <para>Estimation de l'espace disque requis&nbsp;: &libxml2-buildsize;</para>

      </listitem>

      <listitem>

        <para>Estimation du temps de construction&nbsp;: &libxml2-time;</para>

      </listitem>

    </itemizedlist>

    <bridgehead renderas="sect3">Téléchargements supplémentaires</bridgehead>

    <itemizedlist spacing="compact">

      <listitem>

        <para>Suite de tests facultative&nbsp;:

 <ulink url="http://www.w3.org/XML/Test/xmlts&testsuite-version;.tar.gz"/> - Ceci permet à

          <command>make check</command> de faire un test complet.</para>

      </listitem>

    </itemizedlist>

    <bridgehead renderas="sect3">Dépendances de libxml2</bridgehead>

    <bridgehead renderas="sect4">Recommandées</bridgehead>

    <para role="optional"><xref linkend="python2"/> ou <xref linkend="python3"/> (pour construire et installer un module de

    bibliothèque <application>Python</application>, au surplus elle est exigée pour lancer

    la suite de tests complète)</para>

    <note>

      <para>Certains paquets qui utilisent

      <application>libxml2</application> (tels que

      <application>GNOME Doc Utils</application>) ont besoin que le module

      <application>Python</application> soit installé pour fonctionner correctement et

      certains paquets ne se construiront pas correctement si

      le module <application>Python</application> n'est pas

      disponible.</para>

    </note>

    <para role="optional">

      <xref linkend="valgrind"/> (peut être utilisé dans les tests)

    </para>

    <para condition="html" role="usernotes">Notes utilisateur&nbsp;:

    <ulink url="&blfs-wiki;/libxml2"/></para>

  </sect2>

  <sect2 role="installation">

    <title>Installation de libxml2</title>

    <para>Installez <application>libxml2</application> en lançant les commandes

    suivantes&nbsp;:</para>

<screen>

<userinput>./configure --prefix=/usr --disable-static --with-history &amp;&amp;

make</userinput>

</screen>

    <para>Si vous avez téléchargé la suite de tests, exécutez la commande suivante&nbsp;:</para>

<screen>

<userinput>tar xf ../xmlts&testsuite-version;.tar.gz</userinput>

</screen>

    <para>Pour tester les résultats, lancez&nbsp;: <command>make check &gt; check.log</command>.

    Un résumé des résultats peut être obtenu avec  <command>grep -E '^Total|expected' ../check.log</command>.

    Si <xref linkend="valgrind"/> est installé et que vous voulez tester l'empreinte mémoire, remplacez

      <command>check</command> par <command>check-valgrind</command>.

    </para>

    <para>Maintenant, en tant qu'utilisateur <systemitem class="username">root</systemitem>&nbsp;:</para>

<screen role="root">

<userinput>make install</userinput>

</screen>

  </sect2>

  <sect2 role="commands">

    <title>Explication des commandes</title>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"

      href="../../xincludes/static-libraries.xml"/>

    <para>

      <parameter>--with-history</parameter>: Ce paramètre active le support de

      <application>Readline</application> quand

      <command>xmlcatalog</command> ou <command>xmllint</command> sont lancés en mode shell.

    </para>

    <para>

      <option>--with-python=/usr/bin/python3</option>: Ajoutez ce paramètre si vous voulez que

      libxml2 utilise Python3 au lieu de Python2.

    </para>

  </sect2>

  <sect2 role="content">

    <title>Contenu</title>

    <segmentedlist>

      <segtitle>Programmes installés</segtitle>

      <segtitle>Bibliothèques installées</segtitle>

      <segtitle>Répertoires installés</segtitle>

      <seglistitem>

        <seg>

          xml2-config,

          xmlcatalog et

          xmllint

        </seg>

        <seg>

          libxml2.so et facultativement le module <application>Python</application> libxml2mod.so

        </seg>

        <seg>

          /usr/include/libxml2,

          /usr/lib/cmake/libxml2,

          /usr/share/doc/libxml2-&libxml2-version;,

          /usr/share/doc/libxml2-python-&libxml2-version; et

          /usr/share/gtk-doc/html/libxml2

        </seg>

      </seglistitem>

    </segmentedlist>

    <variablelist>

      <bridgehead renderas="sect3">Descriptions courtes</bridgehead>

      <?dbfo list-presentation="list"?>

      <?dbhtml list-presentation="table"?>

      <varlistentry id="xml2-config">

        <term><command>xml2-config</command></term>

        <listitem>

          <para>détermine les drapeaux du compilateur et de l'éditeur de liens qui devraient être

          utilisés pour compiler et lier les programmes qui utilisent

          <filename class="libraryfile">libxml2</filename>.</para>

          <indexterm zone="libxml2 xml2-config">

            <primary sortas="b-xml2-config">xml2-config</primary>

          </indexterm>

        </listitem>

      </varlistentry>

      <varlistentry id="xmlcatalog">

        <term><command>xmlcatalog</command></term>

        <listitem>

          <para>est utilisé pour gérer et manipuler des catalogues

          XML et SGML.</para>

          <indexterm zone="libxml2 xmlcatalog">

            <primary sortas="b-xmlcatalog">xmlcatalog</primary>

          </indexterm>

        </listitem>

      </varlistentry>

      <varlistentry id="xmllint">

        <term><command>xmllint</command></term>

        <listitem>

          <para>analyse des fichiers XML et affiche les rapports

          (basés sur les options ci-dessus) pour détecter les erreurs dans le code

          XML.</para>

          <indexterm zone="libxml2 xmllint">

            <primary sortas="b-xmllint">xmllint</primary>

          </indexterm>

        </listitem>

      </varlistentry>

      <varlistentry id="libxml2-lib">

        <term><filename class='libraryfile'>libxml2.so</filename></term>

        <listitem>

          <para>fournit des fonctions aux programmes pour

          analyser des fichiers qui utilisent le format XML.</para>

          <indexterm zone="libxml2 libxml2-lib">

            <primary sortas="c-libxml2">libxml2.so</primary>

          </indexterm>

        </listitem>

      </varlistentry>

    </variablelist>

  </sect2>

</sect1>