gitweb rectification

[adesklets.git] / doc / adesklets_fr.texi

\input texinfo   @c -*-texinfo-*-
@comment %**start of header
@setfilename adesklets_fr.info
@documentlanguage fr
@include version_fr.texi
@settitle adesklets @value{VERSION}
@syncodeindex pg cp
@comment %**end of header
@copying
Ce manuel concerne adesklets (version @value{VERSION}, @value{UPDATED}).

Copyright @copyright{} 2004, 2005
S.Fourmanoit @email{syfou@@users.sourceforge.net}. 

Traduction française originale de Guillaume Boitel @email{g.boitel@@wanadoo.fr}.

[ Ce document n'est malheureusement pas à jour. 
Vous pouvez aider à la traduction? Faites-nous le savoir! ]

@quotation
Permission est accordée de copier, distribuer et/ou modifier ce document selon
les termes de la Licence de Documentation Libre GNU (GNU Free Documentation
License), version 1.1 ou toute version ultérieure publiée par la Free Software
Foundation ; sans Sections Invariables ; avec les Textes de Première de
Couverture qui sont "A GNU Manual". Une copie de la présente Licence est
incluse dans la section intitulée "GNU Free Documentation License".
@end quotation
@end copying

@c Define useful weblink macro
@macro weblink{link}
@html
<a href="
@end html
\link\
@html
">\link\</a>
@end html
@end macro

@c Define weblink2 macro: a variation on the previous one
@macro weblink2{desk,link}
@html
<a href="\link\">
@end html
\desk\
@html
</a>
@end html
@end macro

@dircategory Graphics
@direntry
* adesklets in french: (adesklets_fr).      Another desklets container (in French).
@end direntry

@titlepage
@title adesklets
@subtitle pour la version @value{VERSION}, @value{UPDATED}
@author Guillaume Boitel (@email{g.boitel@@wanado.fr})
@page
@vskip 0pt plus 1filll
@insertcopying
@end titlepage

@contents

@ifnottex
@node Top
@top adesklets

@ifnothtml
Suivez le lien pour la version originale
(@xref{Top,Version anglaise, Contents, adesklets,}.).
@end ifnothtml
@ifhtml
@weblink2{[Version anglaise],../en/index.html}
@end ifhtml

@insertcopying
@end ifnottex

@menu
* A propos d'adesklets::
* Nouveautés::
* Installation d'adesklets::
* Utilisation d'adesklets::
* Programmation d'adesklets::
* Extension d'adesklets::
* Recherche d'aide!::
* Questions fréquemment posées::
* Copier ce Manuel::
* Clé publique Open PGP::
* Index::
@end menu

@noindent Une version à jour de ce document peut être trouvée en ligne :
@weblink{http://adesklets.sf.net/}.

@noindent Captures d'écrans, codes sources, etc. peuvent aussi être trouvés
sur la page du projet : @weblink{http://sf.net/projects/adesklets/}.

@node A propos d'adesklets
@chapter Qu'est-ce qu'adesklets ?

@section Réponse courte

@command{adesklets} `adesklets' est une console interactive
d'@weblink2{Imlib2,http://www.enlightenment.org/pages/imlib2.html} pour le
système X Window. Il permet à des langages de script d'écrire de manière
propre et simple des applets graphiques intégrés au bureau (i.e. "desklets")
de belle apparence et légèrement interactif.

Il peut aussi être utilisé comme un éditeur graphique en ligne de commande,
un peu comme @weblink2{ImageMagick,http://www.imagemagick.org/}, mais avec
des fonctionnalités différentes.

@section Réponse longue

@command{adesklets} signifie "another desklets [container]". Il a été écrit
comme une alternative à d'autres programmes tels que :

@enumerate
@item
GNOME gDesklets (@weblink{http://gdesklets.gnomedesktop.org/})
@item
KDE SuperKaramba (@weblink{http://netdragon.sourceforge.net/}).
@item
GKrellM (@weblink{http://www.gkrellm.net/})
@end enumerate

Puisque ce projet s'appelle 'a'desklets, il est encore possible, pour
commencer des projets semblables, d'utiliser l'espace de 'b' à 'z' desklets,
à l'exception de 'g' desklets, qui est déjà pris.

Plus sérieusement, tous ces programmes sont bons. Néanmoins, les deux premiers
ont des pré-requis très lourds en termes de dépendances de bibliothèque
; de base les gDesklets requiert que le bureau GNOME soit entièrement
installé (plus quelques bibliothèques spécialisées telles que gnome-python),
tandis que SuperKaramba a besoin de toutes les bibliothèques de KDE ainsi
que de l'environnement base. Ceci se répercute sur l'exécution des autres
taches@footnote{Bien sur, c'est uniquement l'opinion de l'auteur - et ces
deux applications ont fait de gros progrès sur la gestion des ressources
de version en version.}. D'autre part, alors que GkrellM est plus léger
(bien qu'il dépend toujours de GTK+), il ne fournit pas la même qualité en
terme de "présentation" (selon les goûts de l'auteur, naturellement) ou de
" scriptabilité " par rapport aux deux autres.

De ce constat est né @command{adesklets}. Il fournit :

@itemize
@item
un cadre minimal pour des desklets X Window totalement intégré dans le bureau,
avec une facilité d'emploi pour gérer leur lancement, leur placement et
leur arrêt.
@item
une API de dessin générique, riche et facile d'emploi semblable à celle
de gDesklets et de SuperKaramba concernant sa qualité visuelle, grâce à la
bibliothèque Imlib2.
@item
une dépendance très limitée de bibliothèques : utilisation de la très bonne (et
rapide) bibliothèque Imlib2 pour toutes les opérations graphiques. Aucune boite
à outils de fenêtre n'est utilisé : le programme repose directement sur xlib.
@item
un léger, robuste et petit interpréteur potentiellement utilisable avec
toutes sortes de langages de scripts, grâce à une syntaxe propre, limitée et
homogène. Dans cette version @value{VERSION}, le support de Python a été fourni
séparément. Dans les futurs versions, le support de Perl et Ruby sont prévus :
n'hésitez pas à contribuer afin que votre langage préféré soit supporté !
@item
un usage minimal de l'espace disque, de la mémoire vive et du
processeur. Typiquement, avec la glibc-2.3.4 et le noyau Linux 2.6 sur
une architecture x86, l'unique exécutable représente moins de 120 Ko sur
le disque et prend moins de 3Mo de mémoire virtuelle par desklet, après
initialisation, et quasiment aucun cycle de processeur (y compris ceux du
script python interprété) lorsque le desklet est lancé.

@end itemize

Il ne fournit PAS :
@itemize
@item
une API de fenêtre sophistiquée, ni même un accès aux widgets en dehors de
menus gris nus et laids : vous ne pouvez clairement pas écrire une application
GUI avec ces seuls desklets.
@item
des mécanismes compliqués (ni même de mécanismes clairs, en la matière)
pour la configuration de script. Les développeurs de scripts sont libres (ou
condamné, selon la façon de voir les choses) de faire ce qu'il leur convient.
@item
un support pour tout ce qui n'est pas entièrement compatible avec un système
POSIX. Par exemple, ce serait vraiment surprenant qu'il puisse être possible
de le compiler sur cygwin.
@item
un gestionnaire avec de nombreuses fonctionnalités pour les événements
utilisateurs. @command{adesklets} vise une faible consommation de ressource
et une fiabilité ; seuls quelques événements - principalement ceux concernant
le pointeur - sont utilisables dans l'API.
@end itemize

@node Nouveautés
@chapter Nouveautés
@unnumberedsec Quoi de neuf pour la version 0.3.1 ?
Cette version corrige un oubli en implantant la gestion de l'interruption
des barrières temporelles (time gate) par des évènements X. Cette correction
est essentielle à la bonne marche de plusieurs effets dynamiques possibles.

@unnumberedsec Quoi de neuf pour la version 0.3.0 ?
Ceci est une nouvelle version mineure. Nous nous sommes beaucoup souciés de
la portabilité depuis les toutes premières versions de adesklets; avec cette
version, le packetage compile et tourne dans accro sur FreeBSD et NetBSD 
(@xref{Portabilité}.). La gestion des évènements a également été revue à l'interne,
et le packetage python étendu pour supporter la modification dynamique des 
évènements interceptés (voir @file{test/test_events.py}).

L'interpréteur répond maintenant aux désidérata de l'auteur, et ne devrait
pas être significativement étendu dans le futur; tout est relativement en
place pour écrire le plein spectre des desklets qu'il désirait couvrir, incluant
les animations.

@unnumberedsec Quoi de neuf pour la version 0.2.1 ?
Cette version corrige un bogue mineur quant à la compatibilité avec 
les versions de la librairie GNU history incluse avec GNU readline de version
plus ancienne que 5.0. Merci à Mike Prinat pour avoir rapporté cette erreur.

@unnumberedsec Quoi de neuf pour la version 0.2.0 ?
Ceci est une nouvelle version mineure. L'interpréteur supporte dorénavant
les variables textuelles (la substitution dynamique de chaînes, pour être précis),
ainsi que l'exécution de séquences préenregistrées de commandes sous des contraintes
précises de temps (un mode indirect d'exécution); cela donne aux desklets un moyen
de générer des animations fluides. Lancer le script de démonstration
@file{test/fading.py} du packetage de base pour voir ces nouvelles capacités
à l'oeuvre.

Les développeurs, quant à eux, ont maintenant accès à une plateforme complètement
réécrite d'enregistrement de rapports d'exécution de toutes session 
de l'interpréteur (à des fins de débogage).

@unnumberedsec Détails
Allez voir @file{ChangeLog} pour obtenir l'historique complète des changements 
apportés.

@ifplaintext
@c Sets up a marker for automated INSTALL_FR file generation
INSTALL_BEG
@node Installation d'adesklets
@unnumbered Installation d'adesklets
@end ifplaintext
@ifnotplaintext
@node Installation d'adesklets
@chapter Installation d'adesklets
@end ifnotplaintext

@section Pré-requis pour la compilation

Pour compiler adesklets à partir des sources, vous avez besoin de :

@itemize
@item
Un compilateur supportant le C ANSI ainsi que les macros variadiques (à peu
près toutes les versions de @weblink2{gcc,http://gcc.gnu.org} à partir de
la 2.7.0 devraient fonctionner, ou n'importe quel compilateur sorti ces dix
dernières années)
@item
Les entêtes@footnote{Excepté pour les compilations sans fichiers entêtes, utile
pour les environnements serveurs et équivalents - lire la suite pour de plus
amples informations.} et les bibliothèques @weblink2{X11,http://www.x.org/}.
@item
Imlib2 1.1.2 ou supérieure (la plus récente sera la meilleure : vous pouvez
la télécharger sur @weblink{http://sourceforge.net/projects/enlightenment/}).
@item
@weblink2{GNU readline,http://cnswww.cns.cwru.edu/php/chet/readline/rltop.html}
@item
un système raisonnablement compatible POSIX
@end itemize

@noindent Quand présents dans le système, les composantes suivantes peuvent 
également être utilisées:

@itemize
@item
@weblink2{fontconfig,http://www.fontconfig.org/}, pour la détections automatiques 
de l'ensemble des polices utilisables présentes dans le système
@item
@weblink2{GNU history,http://cnswww.cns.cwru.edu/php/chet/readline/rltop.html}, 
le complément fidèle de GNU readline permettant l'enregistrement d'historiques 
de commandes
@item
@weblink2{Python,http://www.python.org} 2.3 ou supérieure, si vous désirez
le support pour Python (vous en aurez probablement besoin à ce niveau :
c'est le seul langage de script supporté pour l'instant)

@end itemize
@section Note sur la portabilité
@anchor{Portabilité}
Ce paquetage est construit en gardant à l'esprit la portabilité - toutes les
extensions spécifiques ont été évitées, et les spécifications (ANSI, SVID
3, BSD 4.3, POSIX) sont suivies de façon scrupuleuse. Néanmoins, tous les
développement ont été fait sur un seul système Linux : il est très probable
qu'adesklets ne compilera pas ou ne fonctionnera pas comme prévu dans
plusieurs cas. Régler ces problèmes est important pour nous.

@strong{Mise à jour}: adesklets a été porté et testé avec succès par les développeurs sur plusieurs systèmes. Au moment rendre publique la version @value{VERSION}, le packetage a été compilé et utilisé avec succès sous:
@itemize
@item Linux 2.4 i386, glibc 2.1.3, gcc 2.95.2 (Debian woody)
@item Linux 2.6 i686, glibc 2.3.4, gcc 3.4.3 (Gentoo linux 2004.2)
@item Linux 2.6 amd64, glibc 2.3.3, gcc 3.4.2 (Fedora core release 3)
@item FreeBSD i386, gcc 2.95.4 (4.10-BETA)
@item NetBSD i386, gcc 2.95.3 (1.6.1)
@end itemize

Vous avez vous-même essayé de faire tourner adesklets sur une architecture 
non citée plus haut? Laissez-nous le savoir, surtout si ça n'a pas marché.

@section Téléchargement du logiciel

La version à jour du logiciel (en archive source bzipée) peut
être trouvée sur la page du projet située sur sourceforge :
@weblink{http://sf.net/projects/adesklets/}

Vous pouvez l'extraire à partir de la console avec @command{tar}. Avec la
version @value{VERSION}, la ligne de commande devrait être :
@example
tar xvjf adesklets-@value{VERSION}.tar.bz2
@end example
ou, si la version que vous avez installée de @command{tar} ne supporte pas
les filtres d'archives bzip2 :
@example
bzcat adesklets-@value{VERSION}.tar.bz2 | tar xv
@end example

@section Vérification optionelle de l'intégrité du logiciel

Pour adesklets @value{VERSION},  vous pouvez également télécharger de
@weblink2{sourceforge,http://sf.net/projects/adesklets/} une signature 
détachée sous forme ascii nommée @command{adesklets-@value{VERSION}.tar.bz2.asc},
que vous pourrez utiliser avec la clé publique de l'auteur 
(@pxref{Clé publique Open PGP}, en appendice) pour vous assurer de 
l'intégrité du paquetage. Par exemple, avec @command{GnuPG}
(@weblink{http://www.gnupg.org/}), vous utiliseriez la commande:

@example
gpg --verify adesklets-@value{VERSION}.tar.bz2.asc adesklets-@value{VERSION}.tar.bz2
@end example

Vous pouvez également obtenir la clé publique pour
l'adresse @email{syfou@@users.sourceforge.net}
de plusieurs serveurs de clés publics tel @weblink{http://www.keyserver.net/} ou
encore @weblink{http://pgp.mit.edu/}. N'hésitez pas à contacter l'auteur directement
si vous désirez vous assurer plus avant l'authenticité de cette clé.

@section Compilation et Installation :

adesklets fournit les scripts usuels autoconf/automake des paquetages GNU.

Donc, dans la plupart des cas, l'installation suit les trois étapes normales :

@enumerate
@item
`cd' dans le répertoire contenant le code source du paquetage et tapez
`./configure' pour configurer le paquetage pour votre système.  Si vous utilisez
`csh' sur une ancienne version de System V, vous devrez peut-être tapez
`sh ./configure' afin de prévenir la tentative de `csh' d'exécuter lui-même
`configure'.

L'exécution de `configure' peut prendre du temps.  Pendant qu'il s'exécute,
il écrit quelques messages qui vous informent des fonctionnalités qu'il est
en train de vérifier.
@item
Tapez `make' pour compiler le paquetage.
@item
Tapez `make install' pour installer les programmes, tous les fichiers de
données et la documentation.
@end enumerate

Vous pouvez enlever les programmes binaires et les fichiers objets du
répertoire qui contient le code source en tapant `make clean'.  Pour enlever
également les fichiers que `configure' a créé (ainsi vous pourrez compiler
le paquetage pour une autre type d'ordinateur), taper `make distclean'.

@section Compilateurs et Options :

Certains systèmes requièrent des options inhabituelles pour la compilation
ou l'édition des liens que le script `configure' ne connaît pas.  Vous pouvez
donner à `configure' des valeurs initiales pour des variables en les déclarant
dans l'environnement.  En utilisant un shell compatible Bourne, vous pouvez
faire cela en ligne de commande comme ceci :
@example
CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure
@end example
@noindent Ou dans les systèmes qui ont le programme `env', vous pouvez faire
comme cela :
@example
env CPPFLAGS=-I/usr/local/include LDFLAGS=-s ./configure
@end example

@section Fonctionnalités Optionnelles :

adesklets possède quelques fonctionnalités optionnelles que vous pouvez
sélectionnez ou non à partir du script de configuration. Tapez :

@example
./configure --help
@end example

@noindent pour une description courte et complète. En voici quelques une
intéressantes :

@itemize
@item
Vous pouvez choisir de compiler adesklets sans aucun support pour X
(@command{--without-x}).
Vous aurez une version qui n'est manifestement pas faite pour le rendu de
desklets, mais bonne pour de la manipulation d'image en ligne de commande.
@item
Vous pouvez enlever le support pour d'autres paquetages ainsi :
@command{--without-history}, @command{--without-fontconfig}
@end itemize

@node Utilisation d'adesklets

@chapter Utilisation d'adesklets

@ifplaintext 
INSTALL_END
@end ifplaintext

@section ... Comme un conteneur de desklets

Par lui-même, adesklets fait peu : il fournit seulement le nécessaire et
rien de plus ! Vous avez besoin soit de lui dire ce qu'il doit faire en
lui passant la commande (voir la section suivante) soit d'autres scripts
(les desklets) qui le piloteront pour vous.

@noindent Pour l'instant, il y a seulement qu'un petit nombre de desklets
disponible : vous pouvez les trouvez sur la page du projet sur sourceforge en
tant que téléchargements séparés:
@weblink{http://sf.net/projects/adesklets/} . Ils vous donneront un aperçu 
de ce dont @command{adesklets} est capable.

@subsection Ajouter un nouveau desklet à votre affichage X
Pour ajouter un nouveau script de desklet, il suffit simplement de :

@enumerate
@item
Télécharger sa tarball et la désarchiver quelque part dans votre répertoire
personnel
@item
Lire le fichier README ; les pré-requis ou instructions spécifiques y seront
donnés. Habituellement, tout ce dont vous avez besoin sont une installation
d'adesklets et un serveur X lancé, puis de lancer le script exécutable à
partir de votre répertoire de base.
@end enumerate

@noindent Notez bien que :

@itemize
@item
Lancer le même script plusieurs fois va lancer plusieurs desklets.
@item
Sur les ordinateurs disposant de plusieurs moniteurs, le script sera lancé
sur son écran hérité par défaut (pour l'instant, si vous ne faites rien
de spécial, appeler un script à partir d'un xterm sur l'écran 1 lancera le
desklet sur l'écran 1).
@end itemize

@noindent La plupart du temps, les scripts de desklets sont faits
pour fonctionner aussi longtemps que vous ne leur dites pas de
s'arrêter. L'utilisateur a un contrôle total sur le démarrage, l'arrêt,
le redémarrage (quand c'est possible) et le positionnement du desklet -
le desklet n'a aucun contrôle sur ces opérations.

@noindent Les quelques réglages de l'utilisateur sont stockés dans le fichier
@command{.adesklets} de votre répertoire personnel. Habituellement, vous
n'avez pas à éditer ce fichier vous-même. Si vous le faite, assurez-vous
qu'aucune instance de @command{adesklets} ne s'exécute en même temps.

@subsection Restaurer les précédents desklets sur une nouvelles session X
Invoquer @command{adesklets} sans argument :
@example
adesklets
@end example
@noindent est suffisant pour redémarrer tous les desklets qui tournaient la
dernière fois que vous avez tué le serveur X (dans ce mode, @command{adesklets}
sortira rapidement par lui-même : il n'est pas besoin de les lancer en
arrière-plan. adesklets n'utilise pas de démon : chaque applet va créer un
interpréteur @command{adesklets} indépendant comme un processus fils). 
Invoquer @command{adesklets} de cette façon quand des desklets sont déjà 
en fonction forcera leur arrêt avant leur redémarrage@footnote{Autant
les instances d'@command{adesklets} que leurs parents immédiats recevront
alors un signal SIGKILL.}.

@noindent Si vous pensez utilisez des desklets régulièrement, vous
devriez mettre la précédente commande @code{adesklets} quelque part dans
l'initialisation de votre session X. Je ne peux pas dire où avec précision,
puisque cela change énormément de système en système. Regardez sur :
@weblink{http://www.google.com/search?q=''x window''+startup}  pour une
aide générale.

@section ... Comme un éditeur graphique en ligne de commande

Vous pouvez aussi utiliser adesklets comme un éditeur graphique en ligne de
commande. Si vous tapez, dans une console :
@example
adesklets :
@end example
@noindent Vous obtiendrez quelque chose de similaire à ceci :
 @anchor{prompt}
@example
adesklets 0.1.0 (Fri Jan 28 19:09:13 EST 2005), on Linux 2.6.10
[gcc 3.4.3 20041125 (Gentoo Linux 3.4.3-r1, ssp-3.4.3-0, pie-8.7.7)]
Press TAB for hints.
0 >>> _
@end example

@noindent La dernière ligne est une invite. Elle vous dit que vous êtes prêt
à entrer la commande numéro 0. Dans adesklets @value{VERSION}, vous avez
environ 150 commandes au bout des doigts. Grâce à GNU readline, beaucoup
d'auto-complétements sont disponibles, ce qui vous donne une facilité
d'utilisation. Pressez TAB dans le nom d'une commande ou sur le premier
argument vous donne des informations utiles. @xref{primer,,une introduction
à adesklets}, pour plus d'information.

@node Programmation d'adesklets
@chapter Programmation d'adesklets
@section Une introduction à adesklets
@anchor{primer}

Comme expliqué ci-dessus (@xref{A propos d'adesklets}.), adesklets est
principalement une console interactive d'Imlib2, avec quelques fonctionnalités
supplémentaires :

@itemize
@item
Quand un affichage X est présent, gestion automatique d'une simple fenêtre.
@item
Support automatique pour la pseudo-transparence
@item
Gestion d'applets persistants entre sessions
@end itemize

@noindent Commençons un session interactive typique pour voir ce qui se
passe. Sous X, ouvrez un terminal et tapez :
@example
adesklets :
@end example

@noindent Comme dans la section précédente (@xref{prompt,, 'Utilisation
d'adesklets comme un éditeur graphique en ligne de commande' }.), vous obtenez
une invite. Maintenant entrez la commande '@code{images_info}'. Vous devriez
voir en réponse sur la sortie standard :
@example
2 images
id 0 width 1 height 1 alpha 1 filename (null)
id 1 width 1 height 1 alpha 1 filename (null)
command 0 ok: images_info
@end example

@noindent Cela signifie que vous avez deux images : image 0 et image 1,
et quelles ont une taille de 1x1 pixel. Ceux sont les seules images que
vous ne pouvez jamais détruire ni modifier comme vous le souhaitez (les
redimensionner indépendamment, les retourner diagonalement, etc. Lisez ce
qui suit pour savoir pourquoi.)

@itemize
@item
Image 0 est l'image d'avant-plan. Par défaut, elle est la seule image qui
est affichée dans une simple fenêtre gérée par @command{adesklets}.
@item
Image 1 est l'image d'arrière-plan. Par défaut, elle contient toujours le
contenu de la fenêtre racine (le bureau) directement sous cette fenêtre : sans
modification de notre part, elle est toujours mise à jour lorsque l'utilisateur
la déplace, lorsqu'il la redimensionne, lorsque le fond d'écran change, etc.
@end itemize

@noindent Mais ou sont ces fenêtres ? Pour l'instant ce sont seulement des
images de 1x1 pixel, et elles ne sont pas montrées@footnote{"Mappé" dans un
patois de X Window} à l'écran. Ainsi, redimensionnons les à 100x100 pixels :
tapez '@code{window_resize 100 100}'. Maintenant, si vous retapez la commande
'@code{images_info}', vous obtiendrez :
@example
2 images
id 0 width 100 height 100 alpha 1 filename (null)
id 1 width 100 height 100 alpha 1 filename (null)
command 2 ok: images_info
@end example

@noindent Vous voyez ? Les images d'avant-plan et d'arrière-plan ont été
redimensionées à 100x100 pixels : de plus, l'arrière-plan a été mis à jour
pour contenir la nouvelle image de fond. Maintenant, rendons cette fenêtre
visible. Tapez les deux commandes : '@code{window_reset managed}' et enfin
'@code{window_show}'.

@noindent La première commande demande à adesklets de laisser votre
gestionnaire de fenêtre "géré" votre fenêtre (ce qui n'est pas fait par défaut)
: cela signifie que la fenêtre va être décorée, et que  vous pourrez changer sa
visibilité@footnote{Une fenêtre "non-gérée" est très utile pour les desklets
: c'est comme si c'était une partie de la fenêtre racine puisqu'elle peut
être construite pour ne jamais être en avant-plan et pour rester affichée
lorsque l'on change d'espace de travail.} de façon interactive. La seconde
montre votre fenêtre de 100x100. Rien d'impressionnant : un carré noir de
100x100 avec une barre de titre et des bordures.

@noindent Comme dit plus haut, seule l'image 0 (avant-plan) est affichée par
défaut. Maintenant, tapons : '@code{window_set_transparency 1}'. Wouah! Nous
voyons la fenêtre racine en dessous ! Avec "window transparency"
activé, l'image 1 (arrière-plan) est d'abord copiée dans la fenêtre, puis
l'image 0 (avant-plan) qui est entièrement noire et transparente, est mise
par-dessus@footnote{Bien... Pas tout à fait : il y a un buffer qui est mise
en jeu pour la performance, mais l'opération est logiquement équivalente à
cette description.}.

@noindent Il est temps de parler des couleurs : souvenez-vous qu'adesklets
est une console d'Imlib2 : en conséquence, comme Imlib2@footnote{Gardez
votre documentation d'Imlib2 à proximité : c'est très utile -
@weblink{http://atmos.org/docs/imlib2/index.html} fournit une agréable
introduction, bien qu'un peu ancienne.}, les couleurs sont toujours de
véritables couleurs 32 bits codées en RVBA - huit bits par canal (de 0 à
255), incluant un canal alpha (transparence). La conversion de palette se
fait  automatiquement si la profondeur de votre écran est inférieure, vous
n'avez pas à vous en occuper. Si vous tapez : '@code{context_get_color}',
vous obtiendrez :
@example
command 0 ok: context color 255 255 255 255
@end example

@noindent Imlib2 est le roi de l'état de la machine ; ainsi, il vient avec un
"contexte" qui garde en mémoire une série d'attributs qui seront utilisés dans
des opérations futures. Par exemple, nous savons maintenant que la couleur
qui sera utilisée, aussi longtemps que nous ne la modifions pas, sera un
blanc opaque (rouge=255, bleue=255, vert=255, alpha=255). Si nous tapons :
'@code{context_get_image}', il nous retourne :
@example
command 0 ok: context image 0
@end example

@noindent Cela signifie que toute opération que nous effectuons sur une fenêtre
est directement fait sur l'image d'avant-plan. Dessinons un rectangle plein
semi-transparent de couleur magenta sur l'avant-plan. La commande pourra être :
'@code{context_set_color 255 0 0 200}' et '@code{image_fill_rectangle 25 25
50 50}'. Élégant, n'est-ce pas ?

@noindent Si vous avez l'habitude de programmer avec Imlib2, vous devriez
avoir remarqué que ces dernières commandes vous sont familières. C'est
normal : la plupart des fonctions C d'Imlib2 sont présentées de
la même façon dans les 'commandes' d'adesklets. Ainsi, la commande
d'adesklets  '@code{image_fill_rectangle}' suit la même sémantique que
la fonction '@code{imlib_image_fill_rectangle()}' d'Imlib2, la commande
'@code{context_set_color}' que la fonction '@code{imlib_context_set_color()}',
etc. Les deux seules différences significatives (et systématiques) sont que
partout où vous utiliserez un objet '@code{Imlib_Quelquechose}' en C, vous
utiliserez un entier ID avec adesklets, et dans la sémantique des fonctions
'@code{imlib_free_Quelquechose()}' on a besoin de donner un entier ID au
lieu d'un objet de ce type permettant de libérer le contexte sélectionné.

@noindent Illustrons cela. Chargeons la police "Vera" inclue dans adesklets
à la taille 20pt, mettons la en police par défaut, et écrivons dans un bloc
blanc opaque 'Hello' en diagonale sur l'image d'avant-plan du coin haut
gauche avant de décharger la police. Cela devrait ressembler à :

@example
6 >>> load_font Vera/20
command 6 ok: new font 0
7 >>> context_set_font 0
command 7 ok: context_set_font 0
8 >>> context_set_direction text_to_angle
command 8 ok: context_set_direction text_to_angle
9 >>> context_set_angle 45
command 9 ok: context_set_angle 45
10 >>> context_set_color 255 255 255 255
command 10 ok: context_set_color 255 255 255 255
11 >>> text_draw 0 0 Hello
command 11 ok: text_draw 0 0 Hello
12 >>> free_font 0
command 12 ok: free_font 0
@end example

@noindent Si vous regardez votre documentation d'Imlib2, vous remarquerez
immédiatement les deux différences que l'on vient de dire : toutes les
références à la police Vera/20 sont faites par un entier ID (0 ici), et
la commande '@code{free_font}', contrairement à la fonction correspondante
'@code{imlib_free_font()}', est appelée avec l'ID de la police comme argument
plutôt que le contexte de la police.

@noindent A partir de là, imaginons que vous voulez sauver l'image résultante
; ce n'est pas un problème - tapons : '@code{save_image out.png}', et
l'avant-plan est sauvé dans un fichier "out.png" dans le répertoire de
travail courant@footnote{Pour que ça marche, vous avez besoin d'avoir une
installation d'Imlib2 proprement configuré pour utiliser libpng, ou vous
risquez de recevoir une erreur "no loader for file format".}. Maintenant,
juste pour le plaisir, quittons adesklets, et lançons une autre session
interactive pour voir si nous pouvons recharger cette image. Tapez juste
la commande "@code{quit}" ou pressez ^D (Control D: fin de fichier), votre
nouvelle session devrait ressembler à ceci :

@example
0 >>> window_resize 100 100
command 0 ok: window_resize 100 100
1 >>> window_reset managed
command 1 ok: window_reset managed
2 >>> window_set_transparency 1
command 2 ok: window_set_transparency 1
3 >>> load_image out.png
command 3 ok: new image 2
4 >>> blend_image_onto_image 2 0 0 0 100 100 0 0 100 100
command 4 ok: blend_image_onto_image 2 0 0 0 100 100 0 0 100 100
5 >>> window_show
command 5 ok: window_show
6 >>> free_image 2
command 6 ok: free_image 2
@end example

@noindent Bien sur, nous voulons visualiser le résultat - c'est
pourquoi nous avons utilisez les commandes '@code{window_reset}',
'@code{window_set_transparency}' et '@code{window_show}' : elles n'ont
pas d'autres utilités. La commande '@code{blend_image_onto_image}' vient
droit de Imlib2 aussi ; elle prend la nouvelle image 2 que l'on vient de
crée lors de la troisième commande, et la met dans un contexte d'image
(image 0 - avant-plan par défaut), à partir de ces coordonnées (0,0) pour
une taille de 100x100 pixels, et la met dans un rectangle allant de (0,0)
et de taille 100x100 pixels de l'image 0. Il est finalement bon de noter
que, avec adesklets, il y a toujours une image dans le contexte d'Imlib2 :
dès que vous essayer de libérer l'image courante, le contexte d'image est
remis à l'image d'avant-plan.

@noindent D'accord, c'est presque la fin de cette introduction. A partir de
là vous pouvez jouer avec adesklets - il est vraiment facile de l'utiliser si
vous vous êtes déjà familiarisé avec Imlib2. Sinon, votre meilleure ressource
est certainement d'avoir la documentation d'Imlib2 pas trop loin. :-)

@noindent Quelques dernières astuces :
@itemize
@item
Si vous êtes fatigué de taper, et taper, n'oubliez pas l'auto-complémentation :
'TAB' vos problèmes au loin !
@item
Si vous voulez avoir de l'aide sur comment faire quelque chose, il existe
la commande '@code{help}'.
@item
Si vous exécutez une série de commandes, que ça ne marche pas et que tous
cet usage interactif vous fatigue :
@enumerate
@item
Utilisez la commande '@code{history}' pour afficher votre session courante
dans un fichier@footnote{Pour que ça marche, vous avez besoin d'avoir GNU
history lorsque vous compilez adesklets.}.
@item
Utilisez l'option '-f' avec adesklets pour prendre une commande à partir
d'un fichier plutôt que de la console tty.
@item
Si vous essayez de visualiser quelque chose, insérez une commande
'@code{pause}' à la fin du script pour geler l'interpréteur.
@item
Tous les caractères qui se trouve après le dièse '#' jusqu'à la fin de la
ligne seront enlevés (Cela est utile pour écrire des commentaires).
@end enumerate
@end itemize

@noindent Voici un exemple :

@example
#!/usr/bin/env adesklets -f

# Rendre la fenêtre 'géré'
#
window_reset managed

# Redimmensioner la fenêtre à 100x100 pixels
#
window_resize 100 100

# Montrer la fenêtre, puis la geler pendant 10 secondes avant de sortir
#
window_show
pause 10
@end example

@noindent Vous aurez juste besoin de rendre ce script exécutable et de le
lancer. Comme d'habitude, les sorties seront affichées sur la sortie standard.

@section Véritable programmation avec adesklets : écriture d'un script
de desklet

Lorsque vous serez prêt pour un véritable travail@footnote{:-)}, vous pourrez
vouloir utilisé un véritable langage de script  plutôt que le rudimentaire
interpréteur @command{adesklets} que nous avons utilisé dans l'introduction ;
vous ne savez jamais quand les variables sont accessibles.

Au moment ou j'écris ces lignes (@value{UPDATED}), seul le support pour
Python est complet@footnote{adesklets a été écrit pour être facile d'usage
pour différents langages interprétés ; le futur développement inclue des
encapsulations pour Perl et Ruby - n'hésitez pas à proposer votre aide si vous
voulez accélérer les choses.}. A partir de python, les choses ne sont pas très
différentes qu'à partir de l'interpréteur : les commandes ont été encapsulées
dans des fonctions python, et une classe publique @code{Events_handler} a été
construite pour manipuler les retours asynchrones de l'interpréteur. Jetez
un coup d'oeil sur le script @file{test/test.py} de l'archive source de la
version @value{VERSION} :

@verbatiminclude ../test/test_fr.py

Voilà ! 26 ligne de code python, et nous avons un desklet parfaitement
fonctionnel. Je pense que cela s'explique tout seul : jetez un coup d'oeil à
l'aide intégrée de python pour @code{adesklets}, @code{adesklets.functions}
et @code{adesklets.Events_handler} pour une bonne et complète explication. En
deux mots, tout ce que nous avons fait ici c'est :

@enumerate
@item
Importer le paquetage @code{adesklets} : cela instancie automatiquement un
processus fils @command{adesklets} et configure toutes les communications :
quand l'initialisation du paquetage ne retourne pas d'exception, cela signifie
que l'interpréteur tourne et est prêt à accepter des commandes.
@item
Faire une sous-classe d'@code{adesklets.Events_handler} et redéfinir des
méthodes invoquées pour les événements qui nous intéresse (tous les autres
événements ne sont pas simplement ignorés, ils ne sont pas générés).
@item
Instancier un objet de cette classe, et mettre en boucle infinie
@footnote{Cette dernière étape n'est pas obligatoire : le script peut
très bien continuer, mais il a été écrit ainsi pour supporter les signaux
d'interruptions. Regarder `@code{help(adesklets.Events_handler)}' pour de
plus amples informations.}.
@end enumerate

@noindent Enfin, mentionnons que vous pouvez regarder dans le code
source du desklet @file{weather} du @weblink2{site web du projet situé sur
sourceforge,http://sourceforge.net/projects/adesklets/} pour un script python
pour adesklets plus conséquent.

@node Extension d'adesklets
@chapter Utilisation d'adesklets à partir d'autres languages

[ Traduction en attente ]

@node Recherche d'aide!
@chapter Contribuer à adesklets

Votre aide est la bienvenue! Plusieurs avenue vous permettent de 
contribuer significativement à adesklets. Vous pourriez:
@itemize
@item
@strong{Aider à la traduction}. Ce manuel en français n'est malheureusement
plus à jour. Si vous êtes un locuteur francophone lisant bien l'anglais,
votre aide serait très appréciée pour maintenir ce document.
@item
@strong{Poster en ligne vos captures d'écran}. Vous êtes un utilisateur 
de adesklets et pensez avoir un bureau spécialement réussi? Partager-le 
avec le monde, et laissez-le nous savoir; vous en aiderez ainsi d'autres
à entendre parler du projet.
@item
@strong{Écrire de nouveau desklets}. adesklets  est encore en petite
enfance : nous sollicitons les talentueux compositeurs de desklets, et nous serions
plus qu'enchanté de poster ou de faire des liens vers leur travail en la matière.
Qu'il ne s'inquiète pas des changements d'interface : nous avons apassé 
beaucoup de temps à y réfléchir, et si on ne peut garantir la stabilité absolue 
de l'API, même pour une version si précoce, il devrait malgré tout rester
relativement fixe; nous nous attendons en fait bien davantage à résoudre 
des bogues et à apporter des changements internes relatifs à la portabilité 
qu'à toute autre chose.
@item @strong{Ajouter des interfaces pour de nouveau langages}. Contactez 
les développeurs avant de commencer question de ne pas perdre de temps si quelque
chose de déjà écrit: ils seront heureux de partager leur code avec vous. 
Inscrivez-vous à la @weblink2{liste d'envois
adesklets-devel,https://lists.sourceforge.net/lists/listinfo/adesklets-devel} sur sourceforge pour un accès direct à ceux-là.
@end itemize

@noindent Contactez-moi par email à @email{syfou@@users.sourceforge.net}.

@node Questions fréquemment posées
@appendix Questions fréquemment posées

[ Traduction en attente ]

@node Copier ce Manuel
@appendix Copier ce Manuel

@menu
* GNU Free Documentation License::  License for copying this manual.
@end menu

@include fdl.texi

@node Clé publique Open PGP
@appendix Clé publique Open PGP

@verbatiminclude syfou.asc

@noindent Vous pouvez également obtenir ce certificat d'un bon nombre de serveurs
publics de clés sur Internet, tels @weblink{http://www.keyserver.net/}, ou
@weblink{http://pgp.mit.edu/}. Contactez son auteur légitime, 
Sylvain Fourmanoit, par courier électronique à l'adresse
@email{syfou@@users.sourceforge.net} pour organiser une validation plus correcte
de la clé si vous en avez besoin.

@node Index
@unnumbered Index

@printindex cp

@bye