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 gtk3-download-http "&gnome-download-http;/gtk+/&gnome-minor-18;/gtk+-&gtk3-version;.tar.xz">

  <!ENTITY gtk3-download-ftp  "&gnome-download-ftp;/gtk+/&gnome-minor-18;/gtk+-&gtk3-version;.tar.xz">

  <!ENTITY gtk3-md5sum        "8c31990af6b966fe42238be63690921a">

  <!ENTITY gtk3-size          "17 Mo">

  <!ENTITY gtk3-buildsize     "502 Mo (avec les tests)">

  <!ENTITY gtk3-time          "6.6 SBU (avec les tests)">

]>

<sect1 id="gtk3" xreflabel="GTK+-&gtk3-version;">

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

  <sect1info>

    <othername>$LastChangedBy&nbsp;: bdubbs $</othername>

    <date>$Date&nbsp;: 2013-03-15 17:26:39 +0100 (Fri, 15 Mar 2013) $</date>

  </sect1info>

  <title>GTK+-&gtk3-version;</title>

  <indexterm zone="gtk3">

    <primary sortas="a-GTK+3">gtk3</primary>

  </indexterm>

  <sect2 role="package">

    <title>Introduction à GTK+ 3</title>

    <para>

      Le paquet <application>GTK+ 3</application> contient les bibliothèques

      utilisées pour les interfaces graphiques des

      applications.

    </para>

    &lfs78_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>

    <itemizedlist spacing="compact">

      <listitem>

        <para>

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

        </para>

      </listitem>

      <listitem>

        <para>

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

        </para>

      </listitem>

      <listitem>

        <para>

          Somme de contrôle MD5 du téléchargement : &gtk3-md5sum;

        </para>

      </listitem>

      <listitem>

        <para>

          Taille du téléchargement : &gtk3-size;

        </para>

      </listitem>

      <listitem>

        <para>

          Estimation de l'espace disque requis : &gtk3-buildsize;

        </para>

      </listitem>

      <listitem>

        <para>

          Estimation du temps de construction : &gtk3-time;

        </para>

      </listitem>

    </itemizedlist>

    <bridgehead renderas="sect3">Dépendances de GTK+ 3</bridgehead>

    <bridgehead renderas="sect4">Requises</bridgehead>

    <para role="required">

      <xref linkend="at-spi2-atk"/>,

       <xref linkend="gdk-pixbuf"/>,

      <xref linkend="libepoxy"/>,    et

      <xref linkend="pango"/>

    </para>

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

    <para role="recommended">

      <xref linkend="hicolor-icon-theme"/> (aussi nécessaire pour les tests) et

      <xref linkend="adwaita-icon-theme6"/> (par défaut pour certains paramètres par défaut de gtk+3, aussi nécessaire pour les tests).

    </para>

    <bridgehead renderas="sect4">Recommandées (nécessaires si vous construisez GNOME)</bridgehead>

    <para role="recommended">

      <xref linkend="gobject-introspection"/>

    </para>

    <bridgehead renderas="sect4">Facultatives</bridgehead>

    <para role="optional">

      <xref linkend="colord"/>,

      <xref linkend="cups"/>,

      <xref linkend="docbook-utils"/>,

      <xref linkend="gtk-doc"/>,

      <xref linkend="json-glib"/>,

      <xref linkend="libxkbcommon"/>,

      <ulink url="http://ftp.acc.umu.se/pub/gnome/sources/rest/">rest</ulink>, et

      <ulink url="http://wayland.freedesktop.org/">Wayland</ulink>

    </para>

    <para condition="html" role="usernotes">

      Notes utilisateur&nbsp;: <ulink url="&blfs-wiki;/gtk3"/>

    </para>

  </sect2>

  <sect2 role="installation">

    <title>Installation de GTK+ 3</title>

    <note>

      <para>

        <application>GTK+ 3</application> va écraser

        <command>gtk-update-icon-cache</command> de

        <xref linkend="gtk2"/> s'il est installé. Il n'est pas faux de considérer

        que les deux programmes fournissent les mêmes fonctions. Si vous

        souhaitez en garder celui de

        <application>GTK+ 2</application>, vous pouvez ajouter

        <option>--enable-gtk2-dependency</option> à la commande

        <command>configure</command>.

      </para>

    </note>

    <para>

      Installez <application>GTK+ 3</application> en lançant les commandes

      suivantes :

    </para>

<screen>

<userinput>./configure --prefix=/usr                         --sysconfdir=/etc                     --enable-broadway-backend             --enable-x11-backend                  --disable-wayland-backend &amp;&amp;

make</userinput>

</screen>

     <para>

      Quelques tests échouent si

      <filename>/usr/share/glib-2.0/schemas/gschemas.compiled</filename> n'est pas trouvé.

      Si vous souhaitez lancer la suite de tests, créez (ou mettez à jour) le fichier en utilisant

      la commande suivante en tant qu'utilisateur

      <systemitem class="username">root</systemitem> :

      <command>glib-compile-schemas /usr/share/glib-2.0/schemas</command>.

    </para>

     <para>

      Si le test <filename>flipping-icons.ui</filename> échoue, supprimez le avec

       <command>rm -v testsuite/reftests/flipping-icons.ui</command>.

    </para>

    <para>

      Pour tester les résultats vous avez besoin d'une session graphique, ensuite tapez

     <command>make check</command>.</para>

    <para>

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

    </para>

<screen role="root">

<userinput>make install</userinput>

</screen>

    <note>

      <para>

        Si vous avez installé le paquet sur votre système en utilisant

        une méthode <quote>DESTDIR</quote>, un fichier important n'a pas été

        installé et il faut le copier et/ou le générer. Générez-le en utilisant

        la commande suivante en tant qu'utilisateur

        <systemitem class="username">root</systemitem>&nbsp;:

      </para>

<screen role="root">

<userinput>gtk-query-immodules-3.0 --update-cache</userinput>

</screen>

    </note>

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

      href="../../xincludes/gsettings-destdir.xml"/>

   </sect2>

  <sect2 role="commands">

    <title>Explication des commandes</title>

    <para>

      <parameter>--enable-broadway-backend</parameter>: paramètre qui active le moteur HTML5 de gdk.

    </para>

    <para>

      <parameter>--enable-x11-backend</parameter>: paramètre qui active

      le moteur GDK de X11.

    </para>

    <para>

      <parameter>--disable-wayland-backend</parameter>: paramètre pour désactiver les tests pour

      Wayland qui n'est pas disponible dans BLFS.

    </para>

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

      href="../../xincludes/gtk-doc-rebuild.xml"/>

       </sect2>

  <sect2 role="configuration">

    <title>Configurer GTK+ 3</title>

    <sect3 id="gtk3-config">

      <title>Fichiers de Configuration</title>

      <para>

        <filename>~/.config/gtk-3.0/settings.ini</filename> et

        <filename>/etc/gtk-3.0/settings.ini</filename>

      </para>

      <indexterm zone="gtk3 gtk3-config">

        <primary sortas="e-AA.home-settings.ini">~/.config/gtk-3.0/settings.ini</primary>

      </indexterm>

      <indexterm zone="gtk3 gtk3-config">

        <primary sortas="e-etc-path-settings.ini">/etc/gtk-3.0/settings.ini</primary>

      </indexterm>

    </sect3>

    <sect3><title>Informations de configuration</title>

      <para>

        Les thèmes <application>GTK+ 3</application> modifient la manière dont

        est affichée une application <application>GTK+ 3</application>.

        Un thème d'icône peut être utilisé pour modifier les icônes apparaissant

        sur la barre d'outils de l'application. Si vous avez installé un thème

        <application>GTK+ 3</application> (comme

        <xref linkend="gnome-themes-standard"/>)

        <xref linkend="gnome-themes-standard"/>), un thème d'icones (comme <xref

        linkend="oxygen-icons"/>) et/ou une police (comme

        <ulink url="http://dejavu.sourceforge.net/">DejaVu fonts</ulink>),

        vous pouvez initialiser vous préférences dans

        <filename>~/.config/gtk-3.0/settings.ini</filename> ou le fichier de configuration système par défaut

        (en tant qu'utilisateur <systemitem class="username">root</systemitem>),

        dans <filename>/etc/gtk-3.0/settings.ini</filename>. Pour l'utilisateur local, un exemple est:

      </para>

<screen>

<userinput>mkdir -p ~/.config/gtk-3.0 &amp;&amp;

cat > ~/.config/gtk-3.0/settings.ini << "EOF"

[Settings]

gtk-theme-name = <replaceable>Adwaita</replaceable>

gtk-fallback-icon-theme = <replaceable>gnome</replaceable>

EOF</userinput>

</screen>

      <para>

        Il y a beaucoup de paramètres, certains avec des valeurs par défaut. Vous pouvez les trouver à l'adresse

        <ulink

        url="https://developer.gnome.org/gtk3/stable/GtkSettings.html">Settings:

        GTK+ 3 Reference Manual</ulink>. Il y a plus de thèmes disponible sur

         <ulink url="http://gnome-look.org/"/> et ailleurs.

    </sect3>

  </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>

          broadwayd,

          gtk3-demo,

          gtk3-demo-application,

          gtk3-icon-browser,

          gtk3-widget-factory,

          gtk-builder-tool,

          gtk-encode-symbolic-svg,

          gtk-launch,

          gtk-query-immodules-3.0, et

          gtk-update-icon-cache

        </seg>

        <seg>

          libgailutil-3.so, libgdk-3.so, and libgtk-3.so, et plusieurs dans

          /usr/lib/gtk-3.0/3.0.0/{immodules,printbackends}

          </seg>

        <seg>

           /etc/gtk-3.0,

           /usr/include/{gail,gtk}-3.0,

          /usr/{lib,share}/gtk-3.0,

          /usr/share/gtk-doc/html/{gail-libgail-util,gdk,gtk}3, et

          /usr/share/themes/{Default,Emacs}/gtk-3.0

        </seg>

      </seglistitem>

    </segmentedlist>

    <variablelist>

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

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

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

      <varlistentry id="broadwayd">

        <term><command>broadwayd</command></term>

        <listitem>

          <para>

            fournit le support pour l'affichage

            des applications <application>GTK+ 3</application> dans un navigateur

            web utilisant HTML5 et les sockets web.

          </para>

          <indexterm zone="gtk3 broadwayd">

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

          </indexterm>

        </listitem>

      </varlistentry>

      <varlistentry id="gtk-encode-symbolic-svg">

        <term><command>gtk-encode-symbolic-svg</command></term>

        <listitem>

          <para>

            convertit des icônes svg symboliques dans un fichier

            spécialement préparé png.

            <application>GTK+ 3</application> peut charger et recolorer ces pngs comme ceux

            d'origine en svgs, mais les charges est plus rapide.

          </para>

          <indexterm zone="gtk3 gtk-encode-symbolic-svg">

            <primary sortas="b-gtk-encode-symbolic-svg">gtk-encode-symbolic-svg</primary>

          </indexterm>

        </listitem>

      </varlistentry>

      <varlistentry id="gtk-launch">

        <term><command>gtk-launch</command></term>

        <listitem>

          <para>

            lance une application utilisée pour donner le nom. Le nom doit correspondre à des nom de fichier d'application de bureau, qui sont dans

            <filename class="directory">/usr/share/application</filename>, avec ou sans l'extension '.desktop'.

          </para>

          <indexterm zone="gtk3 gtk-launch">

            <primary sortas="b-gtk-launch">gtk-launch</primary>

          </indexterm>

        </listitem>

      </varlistentry>

      <varlistentry id="gtk-query-immodules-3.0">

        <term><command>gtk-query-immodules-3.0</command></term>

        <listitem>

          <para>

            rassemble des informations sur les modules de méthode d'entrée

            chargeables pour

            <application>GTK+ 3</application> et il les écrit à l'emplacement du

            fichier cache par défaut ou sur la sortie standard.

          </para>

          <indexterm zone="gtk3 gtk-query-immodules-3.0">

            <primary sortas="b-gtk-query-immodules-3.0">gtk-query-immodules-3.0</primary>

          </indexterm>

        </listitem>

      </varlistentry>

      <varlistentry id="gtk-update-icon-cache3">

        <term><command>gtk-update-icon-cache</command></term>

        <listitem>

          <para>

            est un outil de mise en cache de thème d'icône qui crée des fichiers

            de cache mmap()able pour les thèmes d'icônes.

          </para>

          <indexterm zone="gtk3 gtk-update-icon-cache3">

            <primary sortas="b-gtk-update-icon-cache3">gtk-update-icon-cache</primary>

          </indexterm>

        </listitem>

      </varlistentry>

      <varlistentry id="gtk3-demo">

        <term><command>gtk3-demo</command></term>

        <listitem>

          <para>

            est un programme simple de démonstration de ce qu'on peut faire avec

            <application>GTK+ 3</application>

          </para>

          <indexterm zone="gtk3 gtk3-demo">

            <primary sortas="b-gtk3-demo">gtk3-demo</primary>

          </indexterm>

        </listitem>

      </varlistentry>

      <varlistentry id="gtk3-demo-application">

        <term><command>gtk3-demo-application</command></term>

        <listitem>

          <para>

            est une simple application <application>GTK+ 3</application>.

          </para>

          <indexterm zone="gtk3 gtk3-demo-application">

            <primary sortas="b-gtk3-demo-application">gtk3-demo-application</primary>

          </indexterm>

        </listitem>

      </varlistentry>

      <varlistentry id="gtk3-icon-browser">

        <term><command>gtk3-icon-browser</command></term>

        <listitem>

          <para>

            est un utilitaire pour explorer les icônes dans le thême d'icône courante. Il montre les icônes

            dans des tailles différentes, leurs différences symboliques quand elles sont disponibles, aussi

            bien que la description des icônes et leur contexte.

          </para>

          <indexterm zone="gtk3 gtk3-icon-browser">

            <primary sortas="b-gtk3-icon-browser">gtk3-icon-browser</primary>

          </indexterm>

        </listitem>

      </varlistentry>

      <varlistentry id="gtk3-widget-factory">

        <term><command>gtk3-widget-factory</command></term>

        <listitem>

          <para>

            est un programme pour voir les thèmes et les gadgets <application>GTK+ 3</application>.

          </para>

          <indexterm zone="gtk3 gtk3-widget-factory">

            <primary sortas="b-gtk3-widget-factory">gtk3-widget-factory</primary>

          </indexterm>

        </listitem>

      </varlistentry>

      <varlistentry id="gtk-builder-tool">

        <term><command>gtk-builder-tool</command></term>

        <listitem>

          <para>

            peut réaliser différentes opérations sur les fichiers GtkBuilder .ui.

          </para>

          <indexterm zone="gtk3 gtk-builder-tool">

            <primary sortas="b-gtk-builder-tool">gtk-builder-tool</primary>

          </indexterm>

        </listitem>

      </varlistentry>

      <varlistentry id="libgailutil-3">

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

        <listitem>

          <para>

            contient les fonctions qui implémentent les interfaces

            d'accessibilité définies par le <application>GNOME</application> Accessibility Toolkit.

          </para>

          <indexterm zone="gtk3 libgailutil-3">

            <primary sortas="c-libgailutil-3">libgailutil.so</primary>

          </indexterm>

        </listitem>

      </varlistentry>

      <varlistentry id="libgdk-3">

        <term><filename class="libraryfile">libgdk-3.so</filename></term>

        <listitem>

          <para>

            contient les fonctions agissant comme une enveloppe autour des

            fonctions de dessin et de mise en fenêtres de bas niveau qu'offrent

            les lgraphics sous-jacenteslgraphics

          </para>

          <indexterm zone="gtk3 libgdk-3">

            <primary sortas="c-libgdk-3">libgdk-3.so</primary>

          </indexterm>

        </listitem>

      </varlistentry>

      <varlistentry id="libgtk-3">

        <term><filename class="libraryfile">libgtk-3.so</filename></term>

        <listitem>

          <para>

            contient les fonctions offrant une API pour implémenter des

            interfaces graphiques.

          </para>

          <indexterm zone="gtk3 libgtk-3">

            <primary sortas="c-libgtk-3">libgtk-3.so</primary>

          </indexterm>

        </listitem>

      </varlistentry>

    </variablelist>

  </sect2>

</sect1>