Please note that this translation is outdated!

1 - Pour commencer

1.1 - Démenti

Enlightenment dr17, les Enlightenment Foundation Libraries (EFL) et les différentes applications dont il est question dans ce guide sont basées sur les EFL ne sont pas encore sorties officiellement. Les versions CVS actuelles n'ont rien à voir avec les versions finales et sont loin d' être complètes et stables. La totalité est toujours en développement intensif et aucun de ces logiciels/librairies n'est supporté pour le moment. Les applications et librairies CVS peuvent être cassées de temps à autre. En d'autres termes, ne soyez pas surpris si vous rencontrez des bugs ou si certaines choses ne fonctionnent pas encore correctement. Ce guide est aussi en développement et nous essayons de le maintenir à jour pour refléter les versions CVS actuelles. Les auteurs de ce guide et les développeurs de e17 ne pourront être tenus responsables en cas de dommages causés en suivant ce guide ou par l' utilisation des applications et librairies dont il est question dans ce guide. Les applications basées sur E17 et les EFL sont pour l'instant uniquement destinées aux développeurs, bien sur chacun est libre de les utiliser s'il le désire.

Nous essayons de maintenir ce guide sans erreurs mais il peut en subsister que nous n'aurions pas relevées. Si vous apercevez quoi que ce soit qui devrait être changé, veuillez nous le faire savoir. E17 est en évolution constante comme en développement intensif, en conséquence ce guide n'est pas toujours à jour, même si la dernière mise à jour est actuelle certains détails peuvent manquer. Dans le fond la pluspart des choses devraient être correctes et à jour. De manière générale si vous vous questionnez sur le support d'une fonctionnalité qui n'est pas mentionnée dans le guide, c'est simplement qu'elle n'existe pas encore dans E17.Notez que ce guide est fait pour être lu du début à la fin, si vous passez des étapes vous risquez de manquer des choses importantes qui auraient été expliquées plus tôt (eventuellement dans une section qui ne correspond pas). Sachant qu'il est un peu tôt pour une documentation, puisque la plupart des choses changeront avant les releases, les premiers utilisateurs et testeurs pourraient tout de même trouver ce guide utile :-)

1.2 - Crédits

• Thomas Kuther (gimpel) pour l'aspect technique du site et les corrections qu'il a apportées au guide.
  
• toute l'équipe d'Enlightenment pour avoir développer E17, des EFL et des applications basées sur les EFL
• Lude pour avoir hébergé ce site 6 mois avant qu'il ne soit transféré ici
• tous les gens qui nous ont donné du feedback sur ce site, et bien sur vous qui le lisez

1.3 - Status actuel

Ce guide a été mis a jour le 05.08.2005.

2 - Installation

2.1 - Ordre de compilation et Informations sur les CVS

E17 n'est pas encore sortis officiellement et en conséquence vous devrez ou obtenir une version en cours de développement des CVS ou utiliser les snapshots disponibles sur http://enlightenment.freedesktop.org. Si vous ne savez pas ce que veut dire CVS, allez voir http://www.gnu.org/software/cvs.

Enlightenment DR 17 est basé sur les Enlightenment Foundation Libraries (EFL). Pour être à même de compiler le gestionnaire de bureau E17 et les autres logiciels EFL, vous devrez installer certaines (tout dépend de quelles applications vous désirez installer) librairies EFL. Pour les informations de compilation (dépendances et ordre),voir http://www.rasterman.com/files/efl.png et http://enlightenment.freedesktop.org.

Vous devez suivre le diagramme EFL pour voir les dépendances et l'ordre de compilation des différentes libraries. Si vous désirez installer toutes les EFL et pouvoir alors compiler n'importe quel programme basé EFL, vous pouvez utiliser cet ordre de compilation :

1. e17/libs/eet
2. e17/libs/edb
3. e17/libs/evas
4. e17/libs/ecore
5. e17/libs/embryo
6. e17/libs/imlib2
7. e17/libs/edje
8. e17/libs/epeg
9. e17/libs/epsilon
10. e17/libs/esmart
11. e17/libs/emotion (depends de xine-lib)
12. e17/libs/engrave (utile uniquement pour e_utils)
13. e17/libs/ewl
14. e17/libs/etox (utile seulement si vous désirez installer etox)

Le chiffre correspond à l'ordre dans lequel vous devez installer les libraries, le chemin est le répértoire ou se situe la librairie. Vous devez utiliser ce chemin pour télécharger les libraries/programmes des CVS. Cet ordre est valable pour ceux désirant compiler toutes les EFL et pouvoir compiler tous les programmes basés EFL. Les dépendances de chaque application EFL peuvent varier. Peu importe dans quel ordre vous installez vos programmes basés sur les EFL mais e17/apps/e_utils et e17/apps/e_modules doivent être installés après e17/apps/e car ils dépendent de celui-ci.

Les applications suivantes devraient compiler sans problème avec les librairies ci-dessus:

• e17/apps/entice (visualiseur d'images)
• e17/apps/entrance (gestionnaire de login)
• e17/apps/eclair (player audio/video)
• e17/apps/elicit (utilitaire graphique)
• e17/apps/e (le gestionnaire de fenêtres E17)
• misc/engage (barre de lancement d'applications et module E17)
• misc/erss (RSS feed application)
• e17/apps/e_utils (user-friendly utilities for the E17 WM)
• e17/apps/e_modules (additional modules for the E17 WM)

$ cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/enlightenment login
 $ cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/enlightenment co e17/apps/e

D'abord installez les EFL dans le bon ordre. alors vous pourrez installer le gestionnaire de fenêtres E17, qui se situe dans e17/apps/e dans l'arbre CVS. Vous devriez être familiers de ces étapes de base:

$ ./autogen.sh
 $ ./configure --help
 # Regardez si vous désirez ajouter des paramètres de configuration,  par exemple si vous
 # désirez installer dans un répertoire autre que /usr/local, vous devrez lancer
 # configure avec le bon paramètre.
 $ make
 # puis en root:
 $ make install

Sans options spécifiques dans le configure l'installation par défaut des EFL et du gestionnaire de fenêtres E17 se fait dans le répertoire /usr/local. Si vous avez déjà E16 d'installé vous devez installer E17 à un autre endroit pour éviter les conflits. Il y a tout de même une exception; E16.8 peut coexister avec E17 sans problèmes dans le même répertoire cible.

Verifiez que vous avez les bons paths configurés dans /etc/ld.so.conf. Par exemple si vous installez les EFL dans /usr/local vous devriez ajouter ce répertoire à /etc/ld.so.conf et lancer ldconfig en root afin de créer les liens nécessaires et avoir vos librairies prises en compte.

Maintenant que vous avez installé les Enlightenment Foundation Libraries et le gestionnaire de fenêtres E17, vous voulez probablement installer d'autres applications qui ne sont pas directement incluses dans le gestionnaire de fenêtres.

Les répertoires CVS correspondants aux applications traitées dans ce guide sont:

• e17/apps/entice
• e17/apps/entrance
• e17/apps/elicit
• misc/erss
• misc/engage
• e17/apps/e_modules
• e17/apps/e_utils
• e17/apps/eclair

Pour télécharger Entice par exemple vous devriez utiliser ces commandes:

$ cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/enlightenment login
 $ cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/enlightenment co e17/apps/entice

Pour installer l'application vous devrez effectuer ces opérations:

# loggé en tant qu'utilisateur
 $ ./autogen.sh
 $ ./configure --help
 # voyez les options de compilation que vous avez besoin, pour les utiliser lancez
 # configure avec les bonnes options.
 $ make 
 # loggé en root
 $ make install

Vérifiez que les bon paths sont dans /etc/ld.so.conf.

Si vous voulez installer e17 dans un prefix autre que les répertoires usuels (par exemple dans votre répertoire /opt) Vous devrez configurer vos CPPFLAGS and LDFLAGS avant de lancer le configure. Vous pouvez par exemple les exporter:

export CPPFLAGS="$CPPFLAGS -I/opt/e17/include"
 export LDFLAGS="$LDFLAGS -L/opt/e17/lib"

2.2 - Informations spécifiques aux distributions

Il n'y a pas de packages officiels puisque E17/les EFL/les applications basées EFL dont il est question dans ce guide n'ont pas encore été publiés. Cette section contient des informations relatives à diverses distributions et des liens vers les sites connus ou trouver les packages non officiels.

Debian:

Un package repository non officiel E17/EFL est maintenu par Blake Barnett (shadoi) pour Debian Sid (unstable). Voir http://shadoi.soulmachine.net pour plus de details. Shadoi est un membre de l'équipe d'Enlightenment, son rôle principal est de gérer les packages Debian. Si vous avez des questions à ce propos contactez le directement sur shadoi@soulmachine.net.

Crux Linux:

Vous pourrez trouver les ports non officiels des E17/EFL maintenus par Tilman Sauerbeck (dévelopeur E17) pour Crux sur http://code-monkey.de/efl-cvs-ports/efl-cvs.httpup. Ces ports sont générés chaque nuit en fichiers CVS compressés. Pour toute question concernant ces ports, contactez le directement sur : tilman AT code-monkey DOT de.

Fedora Core:

Un package repository non officiel des E17/EFL RPMs existe, maintenu par Didier F.B. Casse (Prodigy) sur http://sps.nus.edu.sg/~didierbe. Prodigy est un membre de l'équipe Enlightenment où il est responsable des packages Fedora Core. Contactez le directement pour toute question concernant ces packages. Son adresse mail est didierbe@sps.nus.edu.sg.

Foresight Linux:

La communauté Foresight Linux a crée un wiki avec des informations sur Enlightenment spécifiques à cette distribution. Voyez  http://wiki.foresightlinux.com/index.php/Enlightenment pour des informations en anglais. Il existe aussi une page en allemand:  http://wiki.foresightlinux.com/index.php/Enlightenment_Deutsch. Ceci n'a aucun rapport avec nous, en aucun cas nous n'avons de contrôle sur le contenu de ces pages. Si vous avez des commentaires veuillez contacter directement l'equipe de Foresight Linux.

Gentoo:

Portage contient des ebuils pour toutes les EFL et la majorité des applications qui les utilisent. En plus des snapshots mis à jour toutes les une à deux semaines, des live CVS ebuilds sont disponibles. Ceci peut changer de temps à autre, à savoir qu'il se peut que certaines librairies ou applications ne soient disponibles qu'en ebuilds CVS. Voyez les bases de données de packages Gentoo pour en connaître l'état actuel. Tous les ebuilds CVS dépendent de sudo, donc il sera installé si vous utilisez les ebuilds CVS. Ce peut être considéré comme un risque niveau sécurité. La configuration de sudo par défaut ne devrait toute fois pas être trop permissive, donc tant que vous ne l'éditez pas en y abaissant la securité il ne devrait pas y avoir de problèmes sur les stations de travail non critiques. C'est une question d'avis personnel donc vous devrez vous même décider si vous considerez ceci comme un risque. A savoir aussi que les ebuilds CVS ne vérifient pas les md5sums. Les ebuilds CVS utilisent directement les sources à la racine, et peuvent fonctionner ou non selon l'état actuel du CVS. Les snapshot ebuilds sont seulement mis à jour si rien n'est cassé.

Les ebuilds CVS sont marqués -* et les snapshots sont marqués ~arch. Evidemment ni les ebuilds CVS ni les snapshots ne sont marqués stables. Ces ebuilds sont maintenus par Mike Frysinger (vapier@gentoo.org). Si votre système est en ACCEPT_KEYWORDS="~arch", vous n'aurez pas à utiliser /etc/portage/package.keywords si vous désirez utiliser les snapshots. Seulement à les installer dans le bon ordre grâce à emerge.

Lisez la documentation officielle Gentoo pour toute information supplémentaire sur le gestionnaire de packages Gentoo et surtout le système de keywords. Voici un exemple de fichier de configuration /etc/portage/package.keywords, qui inclu les keywords CVS pour les EFL et la plupart des applications qui sont basées dessus :

  x11-wm/e -*
  x11-misc/engage -*
  x11-plugins/e_modules -*
  x11-libs/ewl -*
  x11-libs/evas -*
  media-libs/imlib2 -*
  media-libs/imlib2_loaders -*
  dev-libs/eet -*
  dev-db/edb -*
  x11-libs/ecore -*
  media-libs/etox -*
  media-libs/edje -*
  dev-libs/embryo -*
  x11-libs/esmart -*
  media-libs/epsilon -*
  media-libs/epeg -*
  app-misc/examine -*
  net-news/erss -*
  x11-misc/entrance -*
  app-misc/evidence -*
  media-libs/emotion -*
  media-gfx/elicit -*
  media-gfx/entice -*
  dev-util/e_utils -*
  dev-libs/engrave -*
  media-video/eclair -* 

Si vous désirez plutôt utiliser les snapshots, et que vous êtes en architecture stable, remplacez -* par ~arch. Soit ~x86 pour la majorité (qui utilise des processeurs 32bits x86 compatibles Intel). Notez que vous ne devriez pas mélanger les ebuilds -* et ~x86. Une autre chose importante: vous devez spécifier l'ordre correct manuellement pour les ebuilds a installer lorsque vous utilisez emerge. Car si vous avez déjà installé E17, lancer un "emerge e" mettra a jour uniquement le gestionnaire de fenêtres E17, et pas les EFL - ce qui peut provoquer des erreurs de compilation. L'autre raison est que même si E17 n'est pas installé sur votre système, Portage n'installera pas les librairies dans l'ordre correct avec un simple "emerge e". L'ordre correct de compilation est indiqué en section "Ordre de compilation et informations sur les CVS" (2.1) de ce guide.

Si vous désirez installer la totalité des programmes et librairies qui sont abordés dans ce guide vous pouvez utiliser cette commande d'emerge (ceci installe ou met a jour dans le bon ordre):

emerge eet edb imlib2 evas ecore epeg embryo edje epsilon esmart emotion ewl e engrave e_utils e_modules \
entice engage entrance evidence eclair etox erss elicit

Il se peut que tous les ebuilds ne soient pas disponibles en versions ~arch (snapshot). Les ebuilds CVS sont toujours disponibles. Pour ceux qui n'utilisent pas d'ebuilds, vous devez spécifier la version d'AUTOMAKE et de AUTOCONF. Vous pouvez l'ajouter à l'autogen.sh par exemple:

  #!/bin/sh
  export WANT_AUTOCONF=2.5
  export WANT_AUTOMAKE=1.7

SourceMage:

Si les spells ne sont pas dans votre grimoire, ils sont surement dans le grimoire test, dans ce cas executez la commande:

scribe add test

  -enlightenment
  -ecore
  -enotes
  -eclips
  -entice
  -envision 
  -euphoria
  -ewl
  -imlib2
  -edj
  -evas
  -esmart
  -emotion
  -engrave
  -imlib2_loaders
  -edb
  -epsilon
  -elapse
  -elicit
  -embrace
  -eplayer
  -equate
  -erss
  -etox
  -evidence
  -e_utils
  -eclair
  -enterminus  

man cast

root@smglhost ~ # cast -r -c enlightenment 

enlightenment preparing environment...
Do you want to try DR17 aka E 0.17 aka E17 version? [n] y   

3 - Configuration et Usage

3.1 - Introduction

exec /usr/local/bin/enlightenment

Cela peut varier selon votre distribution ou votre répértoire d'installation. Par exemple si vous utilisez Gentoo l'executable est:/usr/bin/enlightenment-0.17. Si vous utilisez un login manager,veillez à consulter sa documentation pour les spécifications ou comment ajouter une session pour un nouveau gestionnaire de fenêtres. Une fois Enlightenment lancé, la première chose que vous devriez voir est le logo Enlightenment animé. C'est une petite démonstation de ce que les EFL sont capables. Cette séquence de démarrage est artificiellement ralentie. Si vous désirez la passer cliquez la checkbox pendant la sequence de démarrage. A chaque mise a jour de e17 vous aurez peut être a reconfigurer certaines choses car les fichiers de configuration peuvent changer.

Par défaut tous les modules fournis avec E17 sont chargés excépté un. Il s'agit de l'IBox - qui est encore en début de développement. E17 utilise quatre bureaux virtuels par défaut et la pluspart des fonctionnalités présentes dans les autres window managers sont déjà implémentées. Ceci inclus différent types de focus, de niveaux de fenêtres et autres. Pour découvrir ce qui fonctionne pour l'instant le plus simple est de tester l'interface - les fonctionnalités que vous ne trouverez pas sont très probablement manquantes. Voyez la page Status de ce guide et le TODO inclus dans la source de E17 pour voir quelles sont les fonctionnalitées en prévision. La pluspart de la configuration peut s'effectuer directement du menu de E17, qui peut être ouvert en cliquant nimporte où sur le bureau.

Un support limité du drag and drop est également présent. Par exemple vous pouvez glisser une icône du bord haut-gauche d'une fenêtre vers le pager pour envoyer la fenêtre dans le bureau virtuel désiré. Il est aussi possible d'arranger l'ordre des icônes de l'IBar en les manipulant avec la souris. Les raccourcis clavier sont également implémentés mais il n'existe pas encore d'interface pour les configurer. La seule manière de les changer est d'éditer le code source ou d'utiliser l'utilitaire enlightenment_remote. Les raccourcis par défaut sont listés plus bas. En plus de la gestion basique des états des fenêtres, le alt+tab est implémenté et ressemble a ceci:

Notez également que la fausse transparence (celle qu'utilisent Eterm/Aterm/Gkrellm) n'est pas supportée par E17, mais il est possible de le forcer en choisissant un fond d'écran avec l'utilitaire Esetroot (inclus avec Eterm, qui ne fait pas partie de E17) ou e17setroot (inclus dans e_utils, qui a besoin de Esetroot pour forcer la fausse transparence). Quand on force l'utilisation de la fausse transparence avec un de ces utilitaires, le fond d'écran de E17 ne change pas; seules les applications qui utilisent la fausse transparence le verront. Notez que ce n'est pas une bonne manière de procéder et que des applications ne le supporterons pas forcement correctement.

Beaucoup de choses peuvent être paramétrées a l'aide de enlightenment_remote:

$ enlightenment_remote --help
  OPTIONS:
    -h This help
    -help This help
    --help This help
    --h This help
    -display OPT1 Connect to E running on display 'OPT1'
    -module-load OPT1 Loads the module named 'OPT1' into memory
    -module-unload OPT1 Unloads the module named 'OPT1' from memory
    -module-enable OPT1 Enable the module named 'OPT1'
    -module-disable OPT1 Disable the module named 'OPT1'
    -module-list List all loaded modules
    -default-bg-set OPT1 Set the default background edje to the desktop background in the file 'OPT1' (must be a full path)
    -default-bg-get Get the default background edje file path
    -font-available-list List all available fonts
    -font-apply Apply font settings changes
    -font-fallback-append OPT1 Append OPT1 to the fontset
    -font-fallback-prepend OPT1 Prepend OPT1 to the fontset
    -font-fallback-list List the fallback fonts in order
    -font-fallback-remove OPT1 Remove OPT1 from the fontset
    -font-default-set OPT1 OPT2 OPT3 Set textclass (OPT1) font (OPT2) and size (OPT3)
    -font-default-get OPT1 List the default font associated with OPT1
    -font-default-remove OPT1 Remove the default text class OPT1
    -font-default-list List all configured text classes
    -font-fallback-clear Clear list of fallback fonts
    -restart Restart Enlightenment
    -shutdown Shutdown (exit) Enlightenment
    -lang-list List all available languages
    -lang-set OPT1 Set the current language to 'OPT1'
    -lang-get Get the current language
    -dirs-list OPT1 List the directory of type specified by 'OPT1', try 'themes'
    -dirs-list-append OPT1 Append the directory of type specified by 'OPT2 to the list in 'OPT1'
    -dirs-list-prepend OPT1 Prepend the directory of type specified by 'OPT2 to the list in 'OPT1'
    -dirs-list-remove OPT1 Remove the directory of type specified by 'OPT2 to the list in 'OPT1'
    -framerate-set OPT1 Set the animation framerate (fps)
    -framerate-get Get the animation framerate (fps)
    -menus-scroll-speed-set OPT1 Set the scroll speed of menus (pixels/sec)
    -menus-scroll-speed-get Get the scroll speed of menus (pixels/sec)
    -focus-policy-set OPT1 Set the focus policy. OPT1 = CLICK, MOUSE or SLOPPY
    -focus-policy-get Get focus policy
    -edge-flip-set OPT1 Set the edge flip flag (0/1)
    -edge-flip-get Get the edge flip flag
    -edge-flip-timeout-set OPT1 Set the edge flip timeout (sec)
    -edge-flip-timeout-get Get the edge flip timeout
    -font-cache-set OPT1 Set the font cache size (Kb)
    -font-cache-get Get the speculative font cache size (Kb)
    -image-cache-set OPT1 Set the image cache size (Kb)
    -image-cache-get Get the speculative image cache size (Kb)
    -menus-fast-move-threshold-set OPT1 Set the mouse speed (pixels/second) that is considered a 'fast move'
    -menus-fast-move-threshold-get Get the mouse speed (pixels/second) that is considered a 'fast move'
    -menus-click-drag-timeout-set OPT1 Set the time (in sec) between a mouse press and release that will keep the menu up anyway
    -menus-click-drag-timeout-get Get the time (in sec) between a mouse press and release that will keep the menu up anyway
    -border-shade-animate-set OPT1 Set the shading animation flag (0/1)
    -border-shade-animate-get Get the shading animation flag (0/1)
    -border-shade-transition-set OPT1 Set the shading animation algorithm (0, 1, 2 or 3)
    -border-shade-transition-get Get the shading animation algorithm (0, 1, 2 or 3)
    -border-shade-speed-set OPT1 Set the shading speed (pixels/sec)
    -border-shade-speed-get Get the shading speed (pixels/sec)
    -desks-set OPT1 Set the number of virtual desktops (X x Y. OPT1 = X, OPT2 = Y)
    -desks-get Get the number of virtual desktops
    -maximize-policy-set OPT1 Set the maximize policy. OPT1 = FULLSCREEN, SMART, EXPAND or FILL
    -maximize-policy-get Get maximize policy
    -binding-mouse-list List all mouse bindings
    -binding-mouse-add OPT1 OPT2 OPT3 OPT4 OPT5 OPT6 Add an existing mouse binding.
    -binding-mouse-del OPT1 OPT2 OPT3 OPT4 OPT5 OPT6 Delete an existing mouse binding.
    -binding-key-list List all key bindings
    -binding-key-add OPT1 OPT2 OPT3 OPT4 OPT5 OPT6 Add an existing key binding.
    -binding-key-del OPT1 OPT2 OPT3 OPT4 OPT5 OPT6 Delete an existing key binding.
    -always-click-to-raise-set OPT1 Set the always click to raise policy, 1 for enabled 0 for disabled
    -always-click-to-raise-get Get the always click to raise policy, 1 for enabled 0 for disabled
    -use-auto-raise-set OPT1 Set use auto raise policy, 1 for enabled 0 for disabled
    -use-auto-raise-get Get use auto raise policy, 1 for enabled 0 for disabled
    -pass-click-on-set OPT1 Set pass click on policy, 1 for enabled 0 for disabled
    -pass-click-on-get Get pass click on policy, 1 for enabled 0 for disabled
    -auto-raise-delay-set OPT1 Set the auto raise delay (Seconds)
    -auto-raise-delay-get Get the auto raise delay  (Seconds)
    -use-resist-set OPT1 Set resist policy, 1 for enabled 0 for disabled
    -use-resist-get Get use resist policy, 1 for enabled 0 for disabled
    -drag-resist-set OPT1 Set drag resist threshold (0-100)
    -drag-resist-get Get drag resist threshold
    -desk-resist-set OPT1 Set desktop resist threshold (0-100)
    -desk-resist-get Get desktop resist threshold
    -window-resist-set OPT1 Set window resist threshold (0-100)
    -window-resist-get Get window resist threshold
    -gadget-resist-set OPT1 Set gadget resist threshold (0-100)
    -gadget-resist-get Get gadget resist threshold
    -desktop-bg-add OPT1 OPT2 OPT3 OPT4 OPT5 Add a desktop bg definition. OPT1 = container no. OPT2 = zone no. OPT3 = desk_x. OPT4 = desk_y. OPT5 = bg file path
    -desktop-bg-del OPT1 OPT2 OPT3 OPT4 Delete a desktop bg definition. OPT1 = container no. OPT2 = zone no. OPT3 = desk_x. OPT4 = desk_y.
    -desktop-bg-list List all current desktop bg definitions
    -winlist-warp-while-selecting-set OPT1 Set winlist (alt+tab) warp while selecting policy
    -winlist-warp-while-selecting-get Get winlist (alt+tab) warp while selecting policy
    -winlist-warp-at-end-set OPT1 Set winlist (alt+tab) warp at end policy
    -winlist-warp-at-end-get Get winlist (alt+tab) warp at end policy
    -winlist-warp-speed-set OPT1 Set winlist warp speed (0.0-1.0)
    -winlist-warp-speed-get Get winlist warp speed
    -winlist-scroll-animate-set OPT1 Set winlist (alt+tab) scroll animate policy
    -winlist-scroll-animate-get Get winlist (alt+tab) scroll animate policy
    -winlist-scroll-speed-set OPT1 Set winlist scroll speed (0.0-1.0)
    -winlist-scroll-speed-get Get winlist scroll speed
    -winlist-list-show-iconified-set OPT1 Set whether winlist (alt+tab) will show iconfied windows
    -winlist-list-show-iconified-get Get whether winlist (alt+tab) will show iconfied windows
    -winlist-list-show-other-desk-windows-set OPT1 Set whether winlist (alt+tab) will show other desk windows
    -winlist-list-show-other-desk-windows-get Get winlist (alt+tab) show other desk windows
    -winlist-list-show-other-screen-windows-set OPT1 Set winlist (alt+tab) show other screen windows policy
    -winlist-list-show-other-screen-windows-get Get winlist (alt+tab) show other screen windows policy
    -winlist-list-uncover-while-selecting-set OPT1 Set whether winlist (alt+tab) will show iconified windows while selecting
    -winlist-list-uncover-while-selecting-get Get whether winlist (alt+tab) will show iconified windows while selecting
    -winlist-list-jump-desk-while-selecting-set OPT1 Set winlist (alt+tab) jump desk while selecting policy
    -winlist-list-jump-desk-while-selecting-get Get winlist (alt+tab) jump desk while selecting policy
    -winlist-pos-align-x-set OPT1 Set winlist position align for x axis (0.0-1.0)
    -winlist-pos-align-x-get Get winlist position align for x axis
    -winlist-pos-align-y-set OPT1 Set winlist position align for y axis (0.0-1.0)
    -winlist-pos-align-y-get Get winlist position align for y axis
    -winlist-pos-size-w-set OPT1 Set winlist position size width (0.0-1.0)
    -winlist-pos-size-w-get Get winlist position size width
    -winlist-pos-size-h-set OPT1 Set winlist position size height (0.0-1.0)
    -winlist-pos-size-h-get Get winlist position size height
    -winlist-pos-min-w-set OPT1 Set winlist (alt+tab) minimum width
    -winlist-pos-min-w-get Get winlist (alt+tab) minimum width
    -winlist-pos-min-h-set OPT1 Set winlist (alt+tab) minimum height
    -winlist-pos-min-h-get Get winlist (alt+tab) minimum height
    -winlist-pos-max-w-set OPT1 Set winlist (alt+tab) maximum width
    -winlist-pos-max-w-get Get winlist (alt+tab) maximum width
    -winlist-pos-max-h-set OPT1 Set winlist (alt+tab) maximum height
    -winlist-pos-max-h-get Get winlist (alt+tab) maximum height
    -kill-if-close-not-possible-set OPT1 Set whether E should kill an application if it can not close
    -kill-if-close-not-possible-get Get whether E should kill an application if it can not close
    -kill-process-set OPT1 Set whether E should kill the process directly or through x
    -kill-process-get Get whether E should kill the process directly or through x
    -kill-timer-wait-set OPT1 Set interval to wait before killing client (0.0-120.0)
    -kill-timer-wait-get Get interval to wait before killing client
    -ping-clients-set OPT1 Set whether E should ping clients
    -ping-clients-get Get whether E should ping clients
    -ping-clients-wait-set OPT1 Set client ping interval (0.0-120.0)
    -ping-clients-wait-get Get client ping interval
    -transition-start-set OPT1 Get the background transition used when E starts
    -transition-start-get Get the background transition used when E starts
    -transition-desk-set OPT1 Set the transition used when switching desktops
    -transition-desk-get Get the transition used when switching desktops
    -transition-change-set OPT1 Set the transition used when changing backgrounds
    -transition-change-get Get the transition used when changing backgrounds

Raccourcis par default de E17:

Il n'existe pas encore d'outils pour les paramétrer, vous devrez utiliser ceux disponibles par défaut à moins d'éditer la source de e_bindings.c avant de compiler e17. 

Avec la souris:

bouton 1 --> Ouvre le menu principal de E17
bouton 2 --> Ouvre le menu de vos applications favorites
bouton 3 --> Montre les applications actuellement ouvertes. Vous pouvez restaurer en cliquant sur l'icône correspondante. Sur la plupart des systèmes le bouton 3 est représenté par le clique de molette

bouton 1 sur l'icône de la barre de titre --> Ouvre le menu de le fenêtre
bouton 2 sur la barre de titre --> Ouvre le menu de la fenêtre
bouton 3 sur la barre de titre --> Envoie une application en arrière plan

alt + bouton 1 + bouge fenêtre --> Déplace ou met la fenêtre au premier plan
alt + bouton 2 + clique fenêtre --> Ouvre le menu de la fenêtre
alt + bouton 3 + bouge fenêtre --> Redimensionne la fenêtre

alt + tab --> Ouvre la fenêtre de e17 pour basculer entre les applications
alt + F1-F12 --> Aller au bureau 1-12
ctrl + alt + gauche/droite --> Change de bureau vers la direction
shift + alt + flêches de direction --> Change de bureau vers la direction

ctrl + alt + x sur une fenêtre --> Ferme la fenêtre
ctrl + alt + k sur une fenêtre --> Tue la fenêtre
ctrl + alt + w sur une fenêtre --> Ouvre le menu de la fenêtre
ctrl + alt + haut/bas sur une fenêtre --> Met la fenêtre devant/derrière
ctrl + alt + s sur une fenêtre --> Active le mode "sticky"
ctrl + alt + f sur une fenêtre --> Maximise la fenêtre
ctrl + alt + i sur une fenêtre --> Iconifie la fenêtre
ctrl + alt + r sur une fenêtre --> Enroule la fenêtre

ctrl + alt + m --> Ouvre le menu d'E17
ctrl + alt + a --> Ouvre le menu des favoris d'E17

Les raccourcis clavier peuvent être configurés via la commande "enlightenment_remote". Eventuellement une interface sera disponible dans l'avenir. Pour voir ceux disponibles par défaut vous pouvez utiliser cette commande:

enlightenment_remote -binding-key-list

Par défaut (en concidérant que vous ne les avez pas modifiés):

REPLY <- BEGIN
  REPLY: BINDING CONTEXT=ANY KEY="Left" MODIFIERS=SHIFT|ALT ANY_MOD=0 ACTION="desk_flip_by" PARAMS="-1 0"
  REPLY: BINDING CONTEXT=ANY KEY="Right" MODIFIERS=SHIFT|ALT ANY_MOD=0 ACTION="desk_flip_by" PARAMS="1 0"
  REPLY: BINDING CONTEXT=ANY KEY="Up" MODIFIERS=SHIFT|ALT ANY_MOD=0 ACTION="desk_flip_by" PARAMS="0 -1"
  REPLY: BINDING CONTEXT=ANY KEY="Down" MODIFIERS=SHIFT|ALT ANY_MOD=0 ACTION="desk_flip_by" PARAMS="0 1"
  REPLY: BINDING CONTEXT=ANY KEY="Up" MODIFIERS=CTRL|ALT ANY_MOD=0 ACTION="window_raise" PARAMS=""
  REPLY: BINDING CONTEXT=ANY KEY="Down" MODIFIERS=CTRL|ALT ANY_MOD=0 ACTION="window_lower" PARAMS=""
  REPLY: BINDING CONTEXT=ANY KEY="x" MODIFIERS=CTRL|ALT ANY_MOD=0 ACTION="window_close" PARAMS=""
  REPLY: BINDING CONTEXT=ANY KEY="k" MODIFIERS=CTRL|ALT ANY_MOD=0 ACTION="window_kill" PARAMS=""
  REPLY: BINDING CONTEXT=ANY KEY="w" MODIFIERS=CTRL|ALT ANY_MOD=0 ACTION="window_menu" PARAMS=""
  REPLY: BINDING CONTEXT=ANY KEY="s" MODIFIERS=CTRL|ALT ANY_MOD=0 ACTION="window_sticky_toggle" PARAMS=""
  REPLY: BINDING CONTEXT=ANY KEY="i" MODIFIERS=CTRL|ALT ANY_MOD=0 ACTION="window_iconic_toggle" PARAMS=""
  REPLY: BINDING CONTEXT=ANY KEY="f" MODIFIERS=CTRL|ALT ANY_MOD=0 ACTION="window_maximized_toggle" PARAMS=""
  REPLY: BINDING CONTEXT=ANY KEY="r" MODIFIERS=CTRL|ALT ANY_MOD=0 ACTION="window_shaded_toggle" PARAMS=""
  REPLY: BINDING CONTEXT=ANY KEY="Left" MODIFIERS=CTRL|ALT ANY_MOD=0 ACTION="desk_linear_flip_by" PARAMS="-1"
  REPLY: BINDING CONTEXT=ANY KEY="Right" MODIFIERS=CTRL|ALT ANY_MOD=0 ACTION="desk_linear_flip_by" PARAMS="1"
  REPLY: BINDING CONTEXT=ANY KEY="F1" MODIFIERS=ALT ANY_MOD=0 ACTION="desk_linear_flip_to" PARAMS="0"
  REPLY: BINDING CONTEXT=ANY KEY="F2" MODIFIERS=ALT ANY_MOD=0 ACTION="desk_linear_flip_to" PARAMS="1"
  REPLY: BINDING CONTEXT=ANY KEY="F3" MODIFIERS=ALT ANY_MOD=0 ACTION="desk_linear_flip_to" PARAMS="2"
  REPLY: BINDING CONTEXT=ANY KEY="F4" MODIFIERS=ALT ANY_MOD=0 ACTION="desk_linear_flip_to" PARAMS="3"
  REPLY: BINDING CONTEXT=ANY KEY="F5" MODIFIERS=ALT ANY_MOD=0 ACTION="desk_linear_flip_to" PARAMS="4"
  REPLY: BINDING CONTEXT=ANY KEY="F6" MODIFIERS=ALT ANY_MOD=0 ACTION="desk_linear_flip_to" PARAMS="5"
  REPLY: BINDING CONTEXT=ANY KEY="F7" MODIFIERS=ALT ANY_MOD=0 ACTION="desk_linear_flip_to" PARAMS="6"
  REPLY: BINDING CONTEXT=ANY KEY="F8" MODIFIERS=ALT ANY_MOD=0 ACTION="desk_linear_flip_to" PARAMS="7"
  REPLY: BINDING CONTEXT=ANY KEY="F9" MODIFIERS=ALT ANY_MOD=0 ACTION="desk_linear_flip_to" PARAMS="8"
  REPLY: BINDING CONTEXT=ANY KEY="F10" MODIFIERS=ALT ANY_MOD=0 ACTION="desk_linear_flip_to" PARAMS="9"
  REPLY: BINDING CONTEXT=ANY KEY="F11" MODIFIERS=ALT ANY_MOD=0 ACTION="desk_linear_flip_to" PARAMS="10"
  REPLY: BINDING CONTEXT=ANY KEY="F12" MODIFIERS=ALT ANY_MOD=0 ACTION="desk_linear_flip_to" PARAMS="11"
  REPLY: BINDING CONTEXT=ANY KEY="m" MODIFIERS=CTRL|ALT ANY_MOD=0 ACTION="menu_show" PARAMS="main"
  REPLY: BINDING CONTEXT=ANY KEY="a" MODIFIERS=CTRL|ALT ANY_MOD=0 ACTION="menu_show" PARAMS="favorites"
  REPLY: BINDING CONTEXT=ANY KEY="Menu" MODIFIERS=NONE ANY_MOD=0 ACTION="menu_show" PARAMS="main"
  REPLY: BINDING CONTEXT=ANY KEY="Menu" MODIFIERS=CTRL ANY_MOD=0 ACTION="menu_show" PARAMS="clients"
  REPLY: BINDING CONTEXT=ANY KEY="Menu" MODIFIERS=ALT ANY_MOD=0 ACTION="menu_show" PARAMS="favorites"
  REPLY: BINDING CONTEXT=ANY KEY="Insert" MODIFIERS=CTRL|ALT ANY_MOD=0 ACTION="exec" PARAMS="Eterm"
  REPLY: BINDING CONTEXT=ANY KEY="Tab" MODIFIERS=ALT ANY_MOD=0 ACTION="winlist" PARAMS="next"
  REPLY: BINDING CONTEXT=ANY KEY="Tab" MODIFIERS=SHIFT|ALT ANY_MOD=0 ACTION="winlist" PARAMS="prev"
  REPLY <- END

Pour voir les raccourcis par défaut pour la souris:

enlightenment_remote -binding-mouse-list

Ce qui affichera par défaut:

REPLY <- BEGIN
  REPLY: BINDING CONTEXT=BORDER BUTTON=1 MODIFIERS=ALT ANY_MOD=0 ACTION="window_move" PARAMS=""
  REPLY: BINDING CONTEXT=BORDER BUTTON=2 MODIFIERS=ALT ANY_MOD=0 ACTION="window_resize" PARAMS=""
  REPLY: BINDING CONTEXT=BORDER BUTTON=3 MODIFIERS=ALT ANY_MOD=0 ACTION="window_menu" PARAMS=""
  REPLY: BINDING CONTEXT=ZONE BUTTON=1 MODIFIERS=NONE ANY_MOD=0 ACTION="menu_show" PARAMS="main"
  REPLY: BINDING CONTEXT=ZONE BUTTON=2 MODIFIERS=NONE ANY_MOD=0 ACTION="menu_show" PARAMS="clients"
  REPLY: BINDING CONTEXT=ZONE BUTTON=3 MODIFIERS=NONE ANY_MOD=0 ACTION="menu_show" PARAMS="favorites"
  REPLY <- END

A la fois les raccourcis clavier et souris peuvent être paramétrés avec les commandes suivantes  (ceci est inclus dans "enlightenment_remote --help"):

-binding-mouse-list List all mouse bindings
  -binding-mouse-add OPT1 OPT2 OPT3 OPT4 OPT5 OPT6
  -binding-mouse-del OPT1 OPT2 OPT3 OPT4 OPT5 OPT6
  -binding-key-list List all key bindings
  -binding-key-add OPT1 OPT2 OPT3 OPT4 OPT5 OPT6 
  -binding-key-del OPT1 OPT2 OPT3 OPT4 OPT5 OPT6

Les commandes -binding-mouse-add et -binding-mouse-del requièrent les arguments suivants:

OPT1 = Context, OPT2 = button, OPT3 = modifiers, OPT4 = any modifier ok, OPT5 = action, OPT6 = action parameters

Les commandes -binding-key-add et -binding-mouse-del requièrent ces arguments:

OPT1 = Context, OPT2 = key, OPT3 = modifiers, OPT4 = any modifier ok, OPT5 = action, OPT6 = action parameters 

Malheureusement autant que nous sachions, il n'y a pas de liste compréhensible des modifiers qui sont accéptés, ce qui est un peu maladroit pour les utilisateurs. Eventuellement une interface à ceci sera disponible dans le futur.

Menu principal de E17:

Voici le menu principal de E17 ainsi que la fenêtre affichée en cliquant sur "Executer une commande". L'option "Applications favorites" est le menu standard pour vos icônes de lancement d'applications. Ce menu peut être paramétré, par exemple vous pouvez y mettre des nouveaux répértoires ou icônes de votre choix. Dans le sous menu "Modules" vous pouvez activer/désactiver les modules chargés en mémoire mais également configurer ceux qui sont actuellement activés. Il est possible de décharger les modules de la mémoire pour économiser les ressources. E17 peut être aussi léger ou aussi gourmand que vous le désirez grâce aux modules - composants qui ajoutent certaines fonctionnalités au gestionnaire de fenêtres E17. Par defaut les modules suivants sont chargés: Ombre portée, IBar, Temperature, Batterie, Horloge, FréquenceProc et MenuE. Assurez vous d'avoir vu les sections "A Propos" de chaque module. Des modules supplémentaires sont disponibles - voyez la section "Modules" de ce guide pour plus d'informations. Notez que si un module plante, le géstionnaire de fenêtre a de fortes chances de planter également, comme les modules une fois chargés font partie intégrante de E17.

Dans "Bureaux" vous pouvez paramétrer les bureaux virtuels. Par defaut E17 en utilise quatre. Vous pouvez en ajouter/supprimer grâce a ce menu. Le sous menu "Fenêtres" vous montre toutes les fenêtres qui sont actives. Vous pouvez aller chercher des fenêtres minimisées par ce menu ou recuperer le focus des fenêtres. Il y a aussi une option pour "Re-arranger les fenêtres", qui peut être utile si vous avez de nombreuses fenêtres ouvertes et que vous voulez avoir un oeil sur toutes les fenêtres. Le sous menu "Thèmes" affiche les thèmes que vous avez rangé dans ~/.e/e/themes. Vous pouvez alors changer de thème à la volée. Notez que le thème par defaut n'est pas présent dans ce menu, vous devrez vous même le copier. Il est situé dans /usr/share/enlightenment/data/themes/default.edj avec une installation par défaut. Voyez la section "Thèmes" de ce guide pour plus d'informations.

"A Propos d'enlightenment" affiche une popup avec des informations, "Executer une commande" lance une application nomée Exige, qui est une application EFL pour lancer vos programmes en ligne de commande. Vous aurez besoin de e_utils sur votre système pour disposer de cet outil - Exige n'est pas inclus dans E17 par défaut. Il en est de même pour les applications optionnelles : "Background selector" et "Menu editor" dans le sous menu "Configuration", ces applications sont aussi fournies grâce à e_utils. Il y aura plus d'options au fur et à mesure du developpement.

Les bordures: 

Vous pouvez redimensionner une fenêtre en déplaçant les bordures. En haut à droite vous trouverez les boutons classiques pour minimiser, maximiser, fermer la fenêtre. Si vous avez créé une icône pour l'application courante elle devrait s'afficher dans le coin haut à gauche. Sinon il n'y aura qu'un espace vide. Si vous cliquez à cet endroit vous aurez accès au menu de la fenêtre. De la vous pouvez activer le mode sticky par exemple. Vous pouvez egalement créer une icône si elle n'existe pas déjà en cliquant sur "Create Icon" ou la changer "Edit Icon". Ceci ouvre l'application e_utils_eapp_edit, qui est une applications permettant de créer et éditer les icônes binaires que E17 utilise. Cet utilitaire n'est pas inclus dans E17 par défaut - vous devez installer e_utils pour l'obtenir. Voyez la section "icônes et menus" pour plus d'informations. Selon les thèmes vous avez accés a ce menu avec le clique droit sur toute la barre, et en permanence grâce à la combinaison Alt+clique droit.

Les localisations: 

E17 inclus différentes localisations. Elles peuvent être changées en utilisant l'outil enlightenment_remote. Cette commande affiche quelles langues sont disponibles:

$ enlightenment_remote -lang-list
    REPLY: BEGIN
    REPLY: LANG=""
    REPLY: LANG="en_US.UTF-8"
    REPLY: LANG="ja_JP.UTF-8"
    REPLY: LANG="fr_FR.UTF-8"
    REPLY: LANG="es_AR.UTF-8"
    REPLY: LANG="pt_BR.UTF-8"
    REPLY: LANG="fi_FI.UTF-8"
    REPLY: LANG="ru_RU.UTF-8"
    REPLY: LANG="bg_BG.UTF-8"
    REPLY: LANG="de_DE.UTF-8"
    REPLY: LANG="pl_PL.UTF-8"
    REPLY: LANG="zh_CN.UTF-8"
    REPLY: LANG="hu_HU.UTF-8"
    REPLY: LANG="sl_SI.UTF-8"
    REPLY: LANG="it_IT.UTF-8"
    REPLY: END
    

Pour changer la localisation vous pouvez utiliser cette commande par example:

$ enlightenment_remote -lang-set fi_FI.UTF-8

Ce qui changerait la langue en finlandais - E17 devrait instantanément utiliser la nouvelle langue sans avoir besoin de redémarrer.

Les polices:

Il est possible de changer les polices, grâce à la commande enlightenment_remote, comme il n'existe pas encore d'interface de configuration. Il y a tout d'abord quelques choses a savoir. Premièrement, ça ne fonctionne qu'avec le thème par défaut pour l'instant, comme cette fonctionnalité n'est pas encore implémentée dans les thèmes customizés (en ma conaissance). Une autre chose importante à savoir est que les polices des menus ne peuvent pas encore être changées de cette manière - la seule façon de changer les polices des menus est de créer un thème customizé. Voyez la section "Thèmes" (3.5) pour plus de details sur comment compiler des thèmes. Les polices utilisée pour la barre de titre et les boites de dialogues peuvent être facilement changées sans devoir compiler un nouveau thème. Notez que E17 ne "voit" que les polices incluses dans le thème par défaut. Autrement dit si vous désirez utiliser une police qui n'est pas dans ce thème, vous devrez en créer un qui la contiendra. Voyons quelles polices sont disponibles par défaut:

$ enlightenment_remote -font-available-list
REPLY <- BEGIN
REPLY: "Vera-Bold-Italic"
REPLY: "Vera-Normal"
REPLY: "Vera-Bold"
REPLY: "Vera-Italic"
REPLY: "Vera-Mono-Bold-Italic"
REPLY: "Vera-Mono-Bold"
REPLY: "Vera-Mono-Italic"
REPLY: "Vera-Mono"
REPLY: "Vera-Serif"
REPLY: "Vera-Serif-Bold"
REPLY: "Vera"
REPLY: "Baekmuk-Dotum"
REPLY: "Kochi-Gothic"
REPLY: "New-Sung"
REPLY <- END

Tiré de enlightenment_remote --help:

-font-default-set      OPT1 OPT2 OPT3 - Set textclass (OPT1) font (OPT2) and size (OPT3)

Il y a deux textclasses différentes: title_bar et default. Default est la police utilisée dans les boites de dialogues, par example dans la fenêtre "A Propos de Enlightenment". La textclass title_bar est la police utilisée pour la barre de titre. Le nom de la police (OPT2) est celui affiché grâce à enlightenment_remote -font-available-list. Vous pouvez vérifier quelles polices sont actuellement utilisées:

$ enlightenment_remote -font-default-list
REPLY: BEGIN
REPLY: DEFAULT TEXT_CLASS="default" NAME="Vera-Bold-Italic" SIZE=10
REPLY: DEFAULT TEXT_CLASS="title_bar" NAME="Vera" SIZE=10
REPLY: END

Ce sont les polices par défaut. Vous pouvez maintenant facilement les changer en utilisant enlightenment_remote -font-default-set. Par example si vous désirez utiliser une police de taille 12 Vera-Bold pour la barre de titre, vous utiliserez:

$ enlightenment_remote -font-default-set default Vera-Bold 12

Et si vous voulez utiliser cette même font pour les boites de dialogues:

$ enlightenment_remote -font-default-set title_bar Vera-Bold 12

Les changement appliqués pour les fenêtres de dialogues sont immédiatement visibles, par contre pour le reste (par example la barre de titre) vous devrez appliquer les changements grâce a la commande:

$ enlightenment_remote -font-apply

Maintenant que vous avez changé les polices, enlightenment_remote -font-default-list devrait indiquer les nouveaux paramètres:

$ enlightenment_remote -font-default-list
REPLY: BEGIN
REPLY: DEFAULT TEXT_CLASS="default" NAME="Vera-Bold" SIZE=12
REPLY: DEFAULT TEXT_CLASS="title_bar" NAME="Vera-Bold" SIZE=12
REPLY: END

Les changements de polices sont automatiquement sauvegardés. Si vous désirez revenir aux paramètres par défaut lancez ces commandes et redémarrez E17: 

$ enlightenment_remote -font-default-set default Vera 10
$ enlightenment_remote -font-default-set title_bar Vera 10

La police du menu de E17 ne peut pas être modifiée de cette manière. Pour y parvenir vous devrez créer un thème par défaut customizé - voyez la section "Thèmes" pour plus de détails.

Si vous disposez d'une grande quantité de RAM, et que vous pouvez si vous le désirez augmenter la cache des images/polices pour E17.  Pour voir les valeurs actuelles utilisez ces commandes:

$ enlightenment_remote -font-cache-get
 REPLY <- BEGIN
 REPLY: 512
 REPLY <- END

$ enlightenment_remote -image-cache-get
 REPLY <- BEGIN
 REPLY: 4096
 REPLY <- END

Le nombre est en kilobytes, par défaut E17 utilise donc 0.5 MB pour la cache des polices et approximativement 4 MB pour la cache des images. Ces valeurs sont prévues pour économie et pérmettent à E17 de fonctionner sur des systèmes disposant de peu de mémoire. Les valeurs par défaut sont parfaites pour une utilisation normale, ces paramètres sont disponibles tout de même si vous avez de la mémoire en extra qui n'est utilisée par aucun programmes. Vous pouvez alors utiliser ces paramétres pour accélérer les chargements des images EDJ etc.. .Pour changer les paramétres de cache utilisez ces commandes:

enlightenment_remote -font-cache-set [insert number in kilobytes]

enlightenment_remote -image-cache-set [insert number in kilobytes] 

3.2 - Modules

E17 peut être aussi léger ou lourd que vous le souhaitez. Les modules peuvent être chargés ou déchargés en temps réel sans besoin de redémarrer le gestionnaire de fenêtres. Les modules peuvent ajouter toutes sortes de fonctionnalités et de dispositifs. Les modules suivants sont chargés par défaut : iBar, pager, menu E, DesktopName, FrequenceProc, ombre portée, horloge, temperature et batterie. Les modules supplementaires sont dans le package e_modules. Il contient les modules snow, flame, monitor(reseaux, memory et  cpu) et notes. Engage a aussi une version module, mais elle n'est pas non plus incluse dans E17 ni dans e_modules, vous devrez l'installer des CVS. Si vous avez E17 installé et que vous installez Engage, il le détectera et compilera le module pour E17 en plus de la version standalone qui peut se lancer dans n'importe quel gestionnaire de fenêtres.

Vous pouvez charger ou décharger, activer ou désactiver les modules avec l'utilitaire enlightenment_remote. Notez que si vos modules sont chargés même désactivés ils sont en mémoire, donc pour minimiser l'utilisation mémoire déchargez ceux dont vous n'avez pas besoin. Les modules sont controlés en utilisant le "Mode édition" dans la partie gadgets du menu E17 et configurés via les options "Configuration" de la partie "Modules" du même menu. Notez que l'option "Configuration" des modules n'apparait que quand le module correspondant est activé. Notez egalement que la commande "enlightenment_remote --help" dispose de nombreuses options qui ne seront pas notées ici car elles ne concernent pas les modules:

$ enlightenment_remote --help
 OPTIONS:
 -module-load    OPT1  - Load module OPT1 into memory
 -module-unload  OPT1  - Unload (and disable) module OPT1 from memory
 -module-enable  OPT1  - Enable module OPT1 if not enabled
 -module-disable OPT1  - Disable module OPT1 if not disabled
 -module-list          - List all loaded modules and their states
 -bg-set         OPT1  - Set the background edje file to be OPT1
 -restart              - Restart E17
 

Pour voir quels modules sont chargés, utilisez la commande suivante:

$ enlightenment_remote -module-list

Qui affichera quelque chose comme:

WARNING: not a utf8 locale!
 REPLY: BEGIN
 REPLY: MODULE NAME="ibar" ENABLED=0
 REPLY: MODULE NAME="dropshadow" ENABLED=1
 REPLY: MODULE NAME="clock" ENABLED=1
 REPLY: MODULE NAME="pager" ENABLED=1
 

Maintenant pour charger ou décharger les modules, procédez de la manière suivante:

$ enlightenment_remote -module-load nomdumodule
$ enlightenment_remote -module-unload nomdumodule

3.3 - Formats binaires, Icônes et menus

E17 utilise le format binaire EAP pour les icônes. Il existe aussi un autre format binaire appelé EDJ, qui est utilisé pour les fonds d'écran et les thèmes. Les fichiers EDJ et EAP sont en fait des archives EET.

Voici un extrait de http://www.enlightenment.sourceforge.net:

"EET is a tiny library designed to write an arbitary set of chunks of data to a file and optionally compress each chunk (very much like a zip file) and allow fast random-access reading of the file later on. It does not do zip as a zip itself has more complexity than is needed, and it was much simpler to impliment this once here.

Eet is extremely fast, small and simple. Eet files can be very small and highly compressed, making them very optimal for just sending across the internet without having to archive, compress or decompress and install them. They allow for lightning-fast random-acess reads once created, making them perfect for storing data that is written once (or rarely) and read many times, but the program does not want to have to read it all in at once.

It also can encode and decode data structures in memory, as well as image data for saving to Eet files or sending across the network to other machines, or just writing to arbitary files on the system. All data is encoded in a platform independant way and can be written and read by any architecture."

En d'autres mots il est inadapté de dire que les formats EAP et EDJE sont différents - ils portent ces noms pour qu'il soit plus facile pour l'utilisateur d'en comprendre l'utilité. Les fichiers EAP and EDJ sont juste des archives EET avec un nom différent qui, dans la plupart des cas, contiennent des données différentes. Les fichiers EAP contiennent (habituellement) juste une image et d'autres données, comme le nom de l'application, le nom de l'exécutable de l'application etc.. Ce qui ne veut pas dire que les fichiers EAP peuvent seulement contenir des données limitées aux icônes. Un fichier EAP peut contenir et exécuter par exemple un script malicieux, donc n'utilisez de fichiers EAP que de sources dignes de confiance. Dans un soucis de clarté, les EDJ et EAP sont considérés comme des formats différents dans ce guide.

EDJ vient de Edje, qui est une des librairies parmi les Enlightenment Foundation Libraries(EFL). Voici un extrait de http://www.enlightenment.sourceforge.net:

"Edje is one of the more unique parts of EFL, combining many things that Shockwave / FLASH can do with some things it can't, but instead of being designed as a player, it is designed as a slave library to be used by an application to enhance the applications content and display via external compressed data files. It is being expanded continuously, and thanks to its clean design is easy to improve. This is the theme engine behind Enlightenment 0.17 and beyond and at last formalizes Enlightenment themes in a simple and consistent manner."

Vous avez peut être remarqué qu'il a été dit plus haut que les thèmes et les fonds d'écran utilisent ce format dans E17. Ce qui veut également dire que les fonds d'écran en fichier binaire EDJ peuvent, tout comme les thèmes, contenir toute sorte d'animations et d'effets (ou bien un simple fond fixe redimensionné à l'écran).

E17 utilise le format binaire EAP pour les icônes. Les mêmes fichiers sont utilisés pour l'iBar, le menu et Engage. Ces fichiers doivent se situer dans ~/.e/e/applications/all. Il y a plusieurs manières de créer ces fichiers. Si vous ne voulez pas les créer vous même des packs d'icônes sont disponibles dans le menu de ce site. La manière la plus facile d'en créer est d'utiliser le package e_utils. Nous allons d'abord aborder la manière la plus facile et ensuite nous verrons une façon manuelle en utilisant uniquement les utilitaires disponibles avec E17. Il est possible d'éditer les fichiers EAP en utilisant uniquement des outils en ligne de commande - ceci est expliqué a la fin de cette section. Notez que le package e_utils n'est pas inclus dans E17. Si vous désirez utiliser e_utils, vous devrez en installer les dépendances des CVS: examine et engrave (une librairie pour éditer les fichiers binaires EAP). Après avoir créé les icônes EAP, il est possible d'editer les menus (l'IBar etc..) avec un utilitaire graphique (Entangle) ou alors en editant les fichiers de configuration a la main. Cette configuration, contrairement a la plupart des autres fichiers de configuration de E17, n'est pas au format binaire. E_utils inclus les utilitaires suivants:

• e17setroot - Pour configurer le fond d'écran. Sera remplacé dans le futur
• e_util_eapp_edit - Un éditeur graphique pour les EAP
• emblem - Une interface graphique pour les fonds d'écran
• entangle - editeur graphique pour les menus, l'IBar et les restart/startup

Creation de fichiers EAP par les outils graphiques:

Dans cette section nous allons utiliser e_util_eapp_edit. Au premier lancement d'E17 vous devriez apercevoir quelques icônes par défaut dans le menu et l'iBar. Ouvrez un terminal et commencez par démarrer les applications que vous désirez utiliser de ce terminal. Une fois chaque application ouverte vous pouvez en haut à gauche cliquer sur l'espace vide (pas la bordure!) avec le bouton gauche de la souris et selectionnez "Create Icon". Ceci démarre e_util_eapp_edit, donc vous devrez avoir e_utils installé ainsi que toutes ses dépendances pour que ça fonctionne.

Ajoutez les informations nécessaires mais ignorez la section "Window name". Elle doit rester vide. Selectionnez une icône. Elle peut être de n'importe quelle taille - elle sera redimensionnée grâce à la librarie Imlib2. Plus le fichier sera gros, plus la quantité de mémoire utilisée sera élevée. L'interface de sélection des icônes est encore un peu instable et est toujours en développement. Elle devrait tout de même fonctionner même s'il se peut que de temps à autre elle ignore les frappes clavier. Lorsque l'icône a été créée, l'icône originale n'est plus nécessaire. L'icône ainsi créée se retrouvera automatiquement dans le répertoire ~/.e/e/applications/all.

Edition du menu, IBar et Engage à l'aide d'Entangle:

Maintenant que vous avez créé les fichiers EAP, vous pouvez utiliser l'editeur de menu de E17 (Entangle) du package e_utils ou créer les répértoires des menus en utilisant les fichiers textes de configuration. Nous allons aborder la manière graphique puis nous verrons comment faire la même chose avec les fichiers de configuration. Entangle est toujours en développement intensif donc il peut subsister des bugs important - le démenti s'applique egalement a ce programme, utilisez le à vos risques et péril. Entangle affiche les EAP qui se situent dans ~/.e/e/applications/all dans la barre de gauche. Lorsque vous survolez une icône avec la souris, le nom de l'application ainsi que la classe de la fenêtre s'affichent dans le coin inférieur gauche. Vous pouvez changer la cible que vous désirez editer en cliquant une option sur la section se trouvant en haut de la fenêtre. Entangle peut editer pour l'instant le menu des favoris, l'IBar, Engage, le démarrage d'applications  d'E17 (autostart), et les applications lancées au redémarrage d'E17. Entangle peut être lancé directement du menu d'E17 par l'option "Menu editor" de la section configuration.

Vous pouvez glisser les icônes de la barre gauche vers le menu pour les ajouter. Vous pouvez egalement changer l'ordre des icônes du menu en les glissant à l'aide du clique droit de la souris. Le clique du milieu efface les icônes du menu. Notez que Entangle supporte les sous répértoires mais il n'y a pas encore de boutons pour naviguer dans ceux-ci. Prenez garde au fait que lorsque vous utilisez le clique du milieu sur un répértoire (ou l'icône qui le représente) la totalité du répértoire sera effacé! Vous pouvez ajouter des répértoires avec Entangle grâce au bouton "Add Dir" situé en bas. Si vous cliquez dessus vous pouvez laisser le champ vide si vous ne voulez finalement pas ajouter de répértoire. Les changements ne sont appliqués que lorsque vous cliquerez sur le bouton "Save", donc il est possible de quitter l'application sans sauvegarder.

Entangle accepte deux options: -theme and -display. Vous devez spécifier le chemin complet du thème EDJ. Pour l'instant le seule thème disponible est le thème par defaut,  d'autres seront ajoutés, pour les utiliser, ou utiliser le votre si vous en créez un, vous pouvez utiliser cette commande:

entangle -theme /chemin/vers/le/theme.edj 

Edition du menu, IBar et Engage manuellement:

Voyons maintenant la manière traditionnelle c'est a dire le paramétrage des menus etc.. grâce aux fichiers de configuration. Pour créer vos menus vous devrez simplement faire un fichier texte appelé ".order" dans certains répertoires. Ces répertoires sont:

• Pour le menu E17 --> ~/.e/e/applications/favourite
• Pour l'iBar --> ~/.e/e/applications/bar
• Pour Engage --> ~/.e/e/applications/engage

Si vous désirez lancer des applications au démarrage d' E17 placez un fichier texte .order dans ~/.e/e/applications/startup. Le fichier en soi n'est qu'un bête fichier texte avec le nom des fichiers EAP dans l'ordre où vous voulez qu'ils apparaissent (si le fichier est utilisé pour lancer des applications au démarrage, il s' agit de l' ordre dans lequel elles démarrent ). Voici un exemple:

firefox.eap
mozilla.eap
xmms.eap
bmp.eap
evidence.eap
entice.eap

Pour ce qui est du menu, vous pouvez créer des sous menus. Pour cela vous devez créer les répertoires dans ~/.e/e/applications/favourite et ensuite créer un fichier ".order" dans chacun de ces répértoires. On garde la même logique que les icônes si ce n'est que l'on peut ajouter des répértoires. Par exemple si vous créez un répértoire appelé
~/.e/e/applications/favourite/multimedia vous pourriez avoir un fichier ".order" dans
~/.e/e/applications/favourite qui ressemblerait a:

firefox.eap
mozilla.eap
irc.eap
multimedia

Ceci crée alors un menu avec les 3 icônes ainsi qu'un sous menu appelé multimedia. Pour spécifier quelles icônes apparaissent dans le sous menu, créez un fichier ".order" dans répertoire correspondant. Il est possible de créer des sous menu de sous menu.... Les répértoires dans les menus n'ont pas d'icône par défaut. Vous pouvez en ajouter en plaçant un fichier ".directory.eap" dans le répértoire en question. Le fichier ".directory.eap" ne doit contenir que l'icône désirée ainsi qu'un nom d'application (celui que vous voulez) - le nom de l'application sera le nom affiché dans le menu et de même pour l'icône.

Par exemple, si nous reprenons l'exemple précédent; si vous désirez créer une icône pour le menu "multimedia", vous placeriez ".directory.eap" dans ~/.e/e/applications/favourite/multimedia. Dans ce cas le nom de l'application de cette icône serait "multimedia". Vous pouvez utiliser le nom que vous désirez; par exemple un nom différent du répértoire réel.Pour plus d'exemples, vous pouvez télécharger le pack de HandyAndE's ( dévelopeur E17 et créateur d'Engage ) et le décompresser dans ~/.e/e/applications/ http://aje.codewordt.co.uk/Files_files/applications.tar.gz.

Creation et edition de fichiers EAP manuellement:

Il est également possible de créer des icônes sans utiliser e_utils. Ceci est cependant plus long et plus compliqué. Décompressez icon_example.tar.gz qui se trouve dans /usr/share/enlightenment/data/other (dépend de votre installation d'E17) et allez dans le répertoire ainsi créé. Vous y verrez 3 fichiers: build.sh, icon.edc et icon.png.

Editez icon.edc et changez la valeur "max:" par ce que vous désirez. Si vos icônes sont en 128x128 PNG, "128 128" serait évidemment un bon choix. Ensuite copiez une image png à la place de icon.png, celle fournie dans le package icon_example.tar.gz. Votre icône doit s'intituler icon.png. Si vous voulez utiliser un nom différent, éditez icon.edc et build.sh et changez les lignes qui mentionnent icon.png.

Editez build.sh. Vous devez paramétrer ces valeurs:

-set-name "Nom de l'application" \
-set-generic "Nom générique de l'application" \
-set-comment "Commentaire" \
-set-exe "chemin vers l'exécutable" \
-set-win-name "Nom de la fenêtre" \
-set-win-class "classe de la fenêtre"

Notez que vous ne devriez pas paramétrer le Nom de la fenêtre. La classe de la fenêtre doit être correcte ou bien l'icône n'apparaitra pas dans le coin haut gauche de la fenêtre. Vous pourrez obtenir la classe de la fenêtre à l'aide de ces commandes dans un terminal: "xprop WM_CLASS|cut -d \, -f 2" et en cliquant sur une fenêtre. Ceci ne fonctionne pas encore sur E17 donc vous devrez utiliser un autre gestionnaire de fenêtres et noter les classes des fenêtre. Si vous avez e_utils installé, vous pouvez plus facilement les obtenir en ouvrant e_util_eapp_edit en cliquant sur "Create Icon" dans le menu affiché quand vous cliquez dans le coin haut gauche d'une fenêtre. E_util_eapp_edit devrait afficher la bonne classe de l'application de laquelle il a été ouvert.

Voici un exemple de fichier build.sh:

#!/bin/sh
# actually compile an edje file with all the gfx etc.
edje_cc $@ -id . -fd . icon.edc icon.eap
# add eap properties to the file - they are ALL optional EXCEPT name$
# and exe is optional for directory .eap files
enlightenment_eapp \
icon.eap \
-set-name "Firefox" \
-set-generic "Firefox" \
-set-comment "My favourite web browser" \
-set-exe "/usr/bin/firefox" \
-set-win-name "" \
-set-win-class "Firefox-bin"

$ enlightenment_eapp --help
OPTIONS:
  -lang LANG                 Set the language properties to modify
  -set-name NAME             Set the application name
  -set-generic GENERIC       Set the application generic name
  -set-comment COMMENT       Set the application comment
  -set-exe EXE               Set the application execute line
  -set-win-name WIN_NAME     Set the application window name
  -set-win-class WIN_CLASS   Set the application window class
  -set-startup-notify [1/0]  Set the application startup notify flag to on/off
  -set-wait-exit [1/0]       Set the application wait exit flag to on/off
  -del-name                  Delete the application name
  -del-generic               Delete the application generic name
  -del-comment               Delete the application comment
  -del-exe                   Delete the application execute line
  -del-win-name              Delete the application window name
  -del-win-class             Delete the application window class
  -del-startup-notify        Delete the application startup notify flag
  -del-wait-exit             Delete the application wait exit flag

Par exemple si vous avez un EAP qui exécute la ligne "evidence -T rephormed" vous pourriez la changer pour "evidence -T tosh" avec:

$ enlightenment_eapp -set-exe "evidence -T tosh" /path/to/evidence.eap 

3.4 - Fonds d'écran

E17 utilise le format binaire EDJ pour les fonds d'écran. Ces fichiers peuvent également contenir des animations et/ou effets. Les fichiers de fonds d'écrans EDJ peuvent être créés soit avec les utilitaires inclus dans e_utils ou manuellement utilisant les utilitaires inclus dans E17. La solution facile est d'utiliser e_utils - e17setroot et emblem en particulier. Notez que le package e_utils est séparé  (e17/apps/e_utils), vous devrez l'avoir installé ainsi que ses dépendances, (e17/libs/engrave) en plus du gestionnaire de fenêtres.Vous pouvez changer de fond d'écran avec e17setroot.

Voici le fonctionnement:

Usage: e17setroot <nomdel'image> | <edj>
  -t | --tile      <nomdel'image>   Tile l'image.
  -c | --center    <nomdel'image>   Centre l'image.
  -s | --scale     <nomdel'image>   Redimentionne l'image sur l'écran.
  -n | --noload    <nomdel'image>   Crée seulement le fichier edj sans l'afficher.
  -g | --get                     Obtenir le fond d'écran actuel.
  -h                             Show this help screen.

Si vous désirez juste créer un fichier EDJ d'une image, mais ne pas la charger, vous pouvez utiliser la commande suivante par example:

$ e17setroot -s -n /home/username/picture.png

Les fichiers sont créés dans ~/.e/e/backgrounds. Si vous desirez créer et charger une image comme fond d'écran, vous pouvez utiliser cette commande:

$ e17setroot -s /home/username/image.png

enlightenment_remote -desktop-bg-add 0 0 0 0 /path/to/background.edj

enlightenment_remote -desktop-bg-add 0 0 1 0 /path/to/background.edj

enlightenment_remote -desktop-bg-add 0 0 2 0 /path/to/background.edj

enlightenment_remote -desktop-bg-add 0 0 3 0 /path/to/background.edj

Pensez à "enlightenment_remote --help" pour plus de détails.

Lorsque vous avez crées plusieurs fichiers .edj de cette manière il existe un autre utilitaire dans e_utils qui est très utile: Emblem. Il s'agit d'une interface graphique qui affiche tous les fonds d'écran EDJ trouvés dans ~/.e/e/backgrounds, ~/.e/e/themes et PACKAGE_DATA_DIR/dir/themes. Emblem peut également être lancé depuis le menu E17 en séléctionnant  l'option "Background selector" dans la section configuration. Vous pouvez afficher l'image au centre en cliquant sur une miniature. Ensuite pour utiliser le fond d'écran cliquez sur l'image en grand. Emblem est fournis avec un thème en plus du thème par default. Vous pouvez séléctionner les thèmes en utilisant l'option "-theme /chemin/vers/le/theme.edj". Il est aussi possible de séléctionner quel display X Emblem utilise en utilisant l'option "-display". Par exemple si vous voulez utiliser le thème GANT vous pouvez utiliser la commande suivante:

emblem -theme  /usr/share/e_utils/data/emblem/gant.edj

Notez que la fausse transparence n'est pas supportée par E17. En d'autres mots si vous chargez un fond d'écran EDJ, les programmes qui utilisent la fausse transparence (par example la majorité des terminaux) ne verront pas le fond d'écran. Il est possible de forcer le support de la fausse transparence en utilisant Esetroot (fournis avec Eterm) pour choisir un "faux" fond d'écran. Vous pouvez egalement utiliser e17setroot, mais seulement en lui passant une image en paramètre et non un fichier EDJ. En effet e17setroot appelle Esetroot quand on lui passe une image en paramètre en plus de compiler un fichier EDJ. Il s'agit d'une astuce peu ésthétique, et il n'y a aucune garantie que les programmes utilisant la fausse transparence fonctionneront de cette manière. Il semble cependant que ça fonctionne pour la plupart.

Pour ceux qui désirent utiliser la fausse transparence (par example pour Eterm,aterm,rvxt etc..) ou qui désirent seulement récuperer l'image d'un fichier EDJ, il existe un utilitaire nommé edje_thumb qui permet de faire des captures d'un fichier EDJ à n'importe quelle résolution. Ceci est très utile en particulier lorsque vous utilisez un fichier EDJ qui contient en fait plusieurs images utilisées pour contruire le fond d'écran. La plupart des fond d'écran de ce site fonctionnent de cette manière.

Pour capturer une image dans un fichier EDJ:

edje_thumb INPUT_EDJE GROUP_TO_LOAD OUT_FILE [OPTIONS]
 

Les parmètres requis:
  INPUT_EDJE    le fichier EDJ à capturer
  GROUP_TO_LOAD le nom du groupe dans le fichier EDJ
  OUT_FILE      le fichier ou format de sortie (pour plusieurs frames incluez un %i pour accepter le nombre de frames - 'ala' printf)

Les options sont:
  -h          cette aide
  -g WxH      geometrie de rendu
  -og WxH    geometrie de sortie
  -fps N      images par secondes si on capture une animation
  -n NUM      nombre d'images a capturer

Vous pourriez utiliser cette commande par example:

edje_thumb /home/user/background.edj desktop/background /home/user/image.png -og 1600x1200 -g 1600x1200 

Ce qui crée une image de 1600x1200 avec un fichier EDJ. Maintenant vous pouvez facilement choisir ce fond pour utiliser la fausse tranparence - notez que vous devrez avoir Eterm installé pour disposer de cette commande:

Esetroot -s /home/user/image.png

Vous pourrez trouvez différents fonds d'écran au format EDJ sur ce site, voyez la section "Backgrounds" dans le menu de gauche. Si vous avez déjà des fonds d'écran au format EDJ et que vous ne desirez pas utiliser l'utilitaire e17setroot (ou qu'il n'est pas installé), vous pouvez encore charger un fond d'écran edj avec:

enlightenment_remote -bg-set /chemin/vers/fondécran.edj.

Compiler manuellement un fond d'écran: 

images{
 image, "image.jpg"             LOSSY 95;//
 }
 
 
 collections
 {
 // Customize away ;)
 group{
 name, "desktop/background";
       parts {
          part {
             name,          "background_image";
             mouse_events,  0;
             description {
                state,    "default" 0.0;
                rel1 {
                   relative, 0.0  0.0;
                   offset,   0    0;
                }
                rel2 {
                   relative, 1.0  1.0;
                   offset,   -1   -1;
                }
                image {
                   normal, "image.jpg";
                }
                fill {
                   origin {
                      relative, 0.0 0.0;
                      offset,   0 0;
                   }
                   size {
                      relative, 1.0 1.0;
                      offset,   0 0;
                   }
                }
             }
          }
 }
 }
 

$ edje_cc -id ./ -fd ./ fondécran.edc fondécran.edj
 

Ceci devrait créer un fichier nommé fondécran.edj que vous voudrez probablement renommer et déplacer dans ~/.e/e/backgrounds.

3.5 - Thèmes

Le format de thème E17 n'est pas définitif. C'est pourquoi il n'y a pas encore beaucoup de thèmes et ceux qui existent ne fonctionnent pas correctement s'ils n'ont pas été mis à jour récemment. Il est possible d'utiliser des thèmes personnalisés en les copiant dans ~/.e/e/themes. Ils s'affichent alors dans le menu d'E17 et vous pouvez les activer en séléctionnant le thème désiré. Notez que le thème par défaut n'est pas affiché dans le menu par default comme il n'est pas dans le répértoire ~/.e/e/themes. Pour l'ajouter au menu copiez le de /usr/share/enlightenment/data/themes/default.edj (depend de votre installation) vers ~/.e/e/themes.

Autrement vous avez la possibilité de faire un lien symbolique vers cet emplacement. Cette manière a l'avantage de permettre de pointer toujours vers le bon fichier même en cas de mise à jour - ce qui n'est pas le cas si vous copiez juste le default.edj dans ~/.e/e/themes.

Il y a une section thèmes sur ce site, ne la ratez pas :-)

Si vous désirez modifier un thème, vous devrez d'abord décompiler le fichier EDJ. En concidérant que le thème possède les bonnes informations de décompilation (ce n'est pas le cas pour tous les thèmes..), utilisez cette commande pour décompiler un thème:

edje_decc thème.edj

Ceci devrait créer un répértoire avec les fichiers du thème. Les thèmes contiennent habituellement un bon nombre d'images, un script appelé build.sh et un/plusieurs fichiers .edc. Les fichiers .edc contiennent le code Edje du thème. Certains thèmes ne se décompilent pas correctement, c'est le cas par exemple du thème par défaut de E17 qui se plaint d'une violation d'accés - essayant de copier des fichiers dans le répértoire ou vous lancez edj_decc et non dans le répértoire créé. De fait edje_decc crashe avec une violation d'accés et ces thèmes ne peuvent être décompilés. La plupart du temps les thèmes décompilent tout de même correctement.

Si vous désirez customizer le thème par défaut vous devrez prendre le code source, les fonts et les images contenues dans le répértoire source de E17, par example le répértoire créé quand vous avez téléchargé E17 des CVS.

Il est relativement aisé de combiner certains thèmes, par exemple remplacer l'horloge d'un thème par le graphisme de l'horloge d'un autre thème. Dans la majorité des cas tout ce que vous aurez a faire est d'écrire le bon fichier .edc par dessus l'ancien (dans ce cas le fichier est généralement nommé default_clock.edc) et biensur les images (dans ce cas par exemple les images qui correspondent à l'horloge). Changer les animations, les effets, et autres n'est pas aussi aisé et facile à expliquer, ceci ne sera pas abordé dans ce guide. Cependant un "theming tutorial" est en cours d'écriture, dans un guide séparé.

Il n'existe pas encore de documentation concise qui permette d'apprendre facilement comment faire un thème, pour l'instant la seule façon est de décompiler les thèmes existants et d'observer comment ils ont été conçus. Si vous voulez simplement changer les couleurs d'un thème par exemple. vous pouvez editer les images qu'il contient et recompiler le thème. Si le thème contient les bonnes informations dans le build.sh, ceci devrait s'effectuer sans problèmes. Voici le fichier build.sh du thème clean:

#!/bin/sh
edje_cc $@ --image_dir . --font_dir . default.edc -o clean-e17.edj

Le thème peut être recompilé en binaire EDJ à l'aide de ce script. En concidérant que vous avez modifier les fichiers correctement, le fichier .edj (ici clean-e17.edj) devrait être créé dans le répértoire ou vous lancez le script build.sh. Si ce n'est pas le cas, vous devriez avoir un message d'erreur, avec par exemple une liste de fichiers manquants.

3.6 - Frequently asked questions

En plus de ces FAQ, il existe une section "FAQs" dans ce site.

 
Q: J'utilises Eterm, gkrellm, torsmo ou une autre application qui utilise la fausse transparence et ça ne fonctionne pas. Qu'est-ce qui ne va pas?

E17 ne fonctionne pas avec la fausse transparence. La vraie transparence est utilisée par les modules de E17. Il est possible de forcer l'utilisation de la fausse transparence en parametrant un fond d'écran avec Esetroot (disponible avec Eterm) ou e17setroot (inclus dans e_utils, qui a besoin de Esetroot pour forcer la fausse transparence). Quand on force l'utilisation de la fausse transparence avec un de ces utilitaires, le fond d'écran de E17 ne change pas -seulement les applications qui utilisent la fausse transparence le verront. Notez que ce n'est pas une bonne manière de procéder et que des applications ne le supporterons pas forcement correctement.


Q: Il semble que E17 utilise maintenant le format .edj pour les thèmes/fonds d'écran. Comment convertir mes fichiers .eet?

Seule l'extension des fichiers a changé,le fichier en soi est le même. Renommez juste le fichier et ça devrait fonctionner.


Q: J'ai mis à jour E17 et maintenant je ne trouve plus les modules snow/flame ? Où sont ils?

Tous les modules non-critiques ont été déplacés dans un package séparé. Vous devrez installer apps/e_modules.


Q: Pourquoi utiliser des fichiers de configuration binaires?

Les fichiers binaires ont un accès en lecture/écriture très rapide, il n'y a donc pas de gaspillage inutile de CPU en parcourant les fichiers etc. Pour plus d'informations:
http://www.enlightenment.sourceforge.net/index.php?id=20
http://www.enlightenment.sourceforge.net/index.php?id=24
http://www.enlightenment.sourceforge.net/index.php?id=18


Q: Quels sont ces différents formats binaires?

Ce sont des mini-librairies binaires. Tous ces fichiers sont des archive EET - chacune contenant des type de données spécialisées pour differentes tâches. Ces fichiers ont différentes extensions, dépendant de ce pourquoi ils sont utilisés. Les extensions les plus courantes sont .edj et .eapp. Par exemple les fichiers EAPP sont utilisés pour les icônes alors que les fichiers EDJ sont pour les fond d'écran et les thèmes. Pour des informations plus précises visitez:
http://www.enlightenment.sourceforge.net/index.php?id=24
http://www.enlightenment.sourceforge.net/index.php?id=18
http://www.enlightenment.sourceforge.net/index.php?id=23
http://enlightenment.sourceforge.net/index.php?id=30


Q: Je ne veux pas créer mes icônes. Où puis-je trouver un packages avec des icônes ?

Téléchargez le ~/.e/e/applications/ de HandyAndE's (dévelopeur E17 et auteur d'Engage) ici: http://aje.codewordt.co.uk/Files_files/applications.tar.gz


Q: J'ai E16 installé. Dois-je le désinstaller avant de mettre E17?

Non ils peuvent coexister. Il n'y aura pas de conflits tant que l'un sera installé dans /usr/local et l'autre dans /usr. Vous devrez simplement spécifier le chemin complet vers l'exécutable (par exemple dans .xinitrc si vous l'utilisez) s'ils utilisent le même nom. Les fichiers de configuration utilisent des répertoires différents. E16.8 peut coexister avec E17 même dans le même répertoire. Si vous utilisez la version CVS de E16, le fichier devrait avoir un nom différent de E17. Ceci peut dépendre de votre distribution, le binaire E17 de la Gentoo est nommé enlightenment-0.17 par exemple.


Q: J'ai vu une jolie vidéo sur rasterman.com avec un fond d'écran animé. Où puis-je le trouver?

Voila http://www.rasterman.com/files/e17_bg_layered_sky.edj. Vous pouvez le charger avec un classique enlightenment_remote -bg-set /chemin/vers/fichier.edj. Cependant ce fond d'écran est très gourmand en ressources CPU, ce n'est probablement pas quelque chose que vous voudrez utiliser tout le temps. Le fond d'écran par défaut fait partie du thème par défaut situé dans /usr/share/enlightenment/data/themes/default.edj (en considérant que E17 est installé dans /usr) au cas où vous voudriez revenir au fond d'écran par défaut.


Q: J'ai vu de jolis effets de flammes et de neige (snow) dans les différents screenshots/videos de E17. Je ne parviens pas à les retrouver?

Vous devez charger les modules snow et flame. Il ne sont pas chargés par défaut. Veuillez lire la sections "modules" pour les details.


Q: J'utilise E17 depuis un moment, mais après une mise à jour il se passe des choses étranges. Avez vous une idée ?

Si votre version est antérieure au 08.05.2005:
    C'est généralement une bonne idée de supprimer ~/.e afin d'être sur que les fichiers de configuration utilisés sont les plus récents. Vous avez peut être des anciens fichiers qui n'ont pas les paramètres nécessaires au nouveau E17. Faites juste une sauvegarde avant et rappelez vous que vous devrez tout reconfigurer!

Si votre version est plus récente, vos fichiers de configuration seront automatiquement écrasés si nécessaire.

Q: Ou puis-je en savoir plus sur le développement?

Ici vous trouverez des stats CVS : http://cia.navi.cx/stats/project/e. La meilleure façon d'être informé est de suivre le dévelopement sur les mailing lists: http://www.enlightenment.sourceforge.net/index.php?id=3.


Q: Y a t'il un genre de benchmarks/tests inclus dans E17?

Oui, voici le nom de certains programmes qui vous intéresseront peut-être:

evas_software_x11_test
evas_gl_x11_test
ecore_evas_test

Vous devriez les avoir si vous avez les EFL.


Q: Comment changer le thème d'une application EWL?

La plupart des applications EWL devraient accepter l'argument "--ewl-theme". Par exemple si vous voulez utiliser e_util_eapp_edit avec le thème E17 : e_util_eapp_edit --ewl-theme e17 /chemin/vers/fichier.eapp

 
Q: Comment lancer des applications automatiquement au démarrage de E17?

Vous devrez créer un fichier texte ".order" dans ~/.e/e/applications/startup. Le fichier doit contenir la liste des fichiers EAPP des programmes que vous désirez démarrer automatiquement. Voyez la section "Icônes et menus" pour plus de détails.

4 - Autres Applications EFL

Cette section contient les informations concernant la configuration et l'usage des applications EFL les plus communes. Nous la complèterons plus tard.

4.1 - Eclair

Eclair est un lecteur multimedia basé sur les EFL. Il peut aussi bien lire de la musique que de la video. Comme vous pouvez le deviner sur l'image, les menus d'Eclair sont animés et utilisent des effets visuels sympathiques, maintenant avec l'affichage des pochettes. Les thèmes sont supportés mais il n'en existe pas encore. Vous pouvez accéder à la playlist par le bouton doré du bas - celui de gauche ouvre la partie avec affichage des pochettes. Il s'agit d'un logiciel en plein développement (il vient a peine d'être ajouté aux CVS). Notez que vous devrez disposer de la Xine-lib car Emotion (la librairie qu'il utilise pour la lecture audio et video) en a besoin. Un utilitaire est livré avec Eclair qui permet de tranformer les thèmes classic de Winamp au format de skin EDJ pour Eclair. Pour utiliser correctement cet utilitaire vous aurez besoin de ImageMagick et de unzip. L'initiateur de ce projet est Simon TRENY (moOm).

Usage: eclair [arguments] file(s)
 Available arguments:
 
 -h, --help                            Print this message and exit
 -t, --theme                           Specify an edj theme file for eclair
 -g, --gui-engine [software|gl]        Specify the gui engine
 -v, --video-engine [software|gl]      Specify the video engine

Le mode software est recommandé - le moteur OpenGL est toujours experimental. Si vous possédez une carte graphique Nvidia et que vous utilisez les drivers officiels (a sources fermées), vous pouvez essayer l'astuce suivante:

 $ __GL_SYNC_TO_VBLANK=1 eclair --video-engine gl

Avec ceci Eclair utilise le mode openGL pour le rendu video et synchronise avec le rafraichissement de l'écran. Ce qui devrait bien fonctionner avec la plupart des cartes Nvidia.

Eclair est fournis avec un thème additionnel - inspiré par les artworks G.A.N.T. de mattahan. Pour démarrer Eclair avec ce thème vous devez spécifier l'emplacement:

$ eclair -t /usr/share/eclair/themes/gant.edj 

Si vous voulez utiliser votre skin Winamp classic favorite au format WSZ, convertissez la à l'aide de cette commande:

eclair_wsz2edj winamp2_skin.wsz nouveau_theme_eclair.edj

4.2 - Engage

Le module E17:

Le module Engage dans E17

Sites que vous pourriez trouver utile:
http://andy.elcock.org/Software/Engage/FAQs.html
http://edevelop.org/errand/index-themes.html (thèmes pour la version standalone)
http://www.enlightenment.sourceforge.net/index.php?&id=15

Engage est une dockbar basée sur les EFL. La version standalone et la version module E17. Si vous avez E17 installé quand vous le compilez, il compilera alors le module en plus de la version stanalone. La version module ne dispose pas encore de toutes les fonctionnalités de la version standalone. La version module fonctionne commme un lanceur d'applications et une barre des tâches. La version module contient une fonctionnalité intéressante que ne contient pas la version standalone; la possibilité de changer de bureau en utilisant la molette sur les icônes, le bureau changera vers celui ou l'application se trouve. Si vous avez lancé plusieurs instances d'une application, ceci basculera entre elles de manière assez logique (molette vers le bas basculera vers l'icône la plus en bas etc...). Le développement futur est concentré sur la version module.

Notez que la dépendance E17 est facultative - si il est installé le module sera compilé en plus de la version standalone. Si vous ne l'avez pas, seule la version standalone sera compilée. 

Engage utilise les icônes EAPP dans ~/.e/e/applications/all. Vous pourrez trouver des icônes EAPP à cet endroit si vous ne désirez pas en créer vous même: http://aje.codewordt.co.uk/Files_files/applications.tar.gz. Vous pouvez également éditer celles-ci avec e_util_eapp_edit si e_utils est installé. Voyez la section icônes de ce guide pour des informations plus précises. Une fois que vous avez créé vos icônes EAPP dans ~/.e/e/applications/all, vous devrez faire un fichier texte ".order" ~/.e/e/applications/engage. Ce répertoire n'existe pas par défaut et n'est pas automatiquement créé - vous devrez le faire vous même. Le fichier ".order" contient juste une liste de fichiers EAPP dans l'ordre dans lequel vous désirez qu'ils apparaissent dans la barre. Voyez la sections "icônes et menus" pour plus d'exemples. Vous pouvez également glisser déplacer des fichiers EAPP de Evidence et de l'icône de e_utils_eapp_edit.

Le module n'est pas chargé par défaut au démarrage de E17. Pour charger le module utilisez la commande:

$ enlightenment_remote -module-load engage

Si vous n'aimez pas le thème par défaut du module Engage, vous pouvez le rendre complètement transparent (tant que Engage est au bas de l'écran) en éditant data/themes/module.edc. Vous devrez ajouter "color: 255 255 255 0;" à la ligne 34 - sans les guillemets évidemment. Voici à quoi ça devrait ressembler:

             rel2 {
                relative: 1.0  1.0;
                offset:   -1   -1;
                to:       "overlay";
             }
             color: 255 255 255 0;
             image {
                normal: "bg_h.png";

Si vous désirez retirer le texte rendez le transparent également.
Pour cela, éditez les variables couleurs dans module.edc à partir de la ligne 346:

      part {
         name: "EngageIconText";
	 type: TEXT;
	 mouse_events: 0;
	 effect: SOFT_SHADOW;
	 description {
	    state: "default" 0.0;
	    rel1 {
	       relative: 0.0  0.5;
	       offset:   0   0;
	    }
	    rel2 {
	       relative: 1.0  0.5;
	       offset:   300 0;
	    }
	    color: 255 255 255 255;
	    color3: 255 255 255 255;
	    text {
	       text: "";
	       font: "Edje Vera";
	       size: 12;
	       min: 1 1;
	       align: 0.0 0.0;
	    }
	 }
	 description {
	    state: "visible" 0.0;
	    rel1 {
	       relative: 0.0  0.5;
	       offset:   0   0;
	    }
	    rel2 {
	       relative: 1.0  0.5;
	       offset:   300 0;
	    }
	    color: 255 255 255 0;
	    color3: 255 255 255 0;
	    text {
	       text: "";
	       font: "Edje Vera";
	       size: 12;
	       min: 1 1;
	       align: 0.0 0.0;
	    }
	 }
	 description {
	    state: "hidden" 0.0;
	    rel1 {
	       relative: 0.0  0.5;
	       offset:   0   0;
	    }
	    rel2 {
	       relative: 1.0  0.5;
	       offset:   300 0;
	    }
	    color: 0 0 0 0;
	    color3: 255 255 255 0;
	    text {
	       text: "";
	       font: "Edje Vera";
	       size: 12;
	       min: 1 1;
	       align: 0.0 0.0;
	    }
	 }
      }

Usage: engage [OPTION] ...

 -h, --help                        Print this text
 -I, --ignore-iconified    [bool]  Ignore iconified windows
 -i, --ignore-running      [bool]  Ignore running apps
 -T, --tray                [bool]  Enable system tray
 -D, --appear-time         [flt]   Time taken (in seconds) for new icons to appear
 -b, --bg-main-color       [rgb]   Background main color
 -B, --bg-outline-color    [rgb]   Background outline color
 -d, --zoom-time           [flt]   Time taken (in seconds) for icons to zoom
 -Z, --zoom-factor         [flt]   Zoom factor of the icons - 1.0 == 100% == nozoom
 -z, --zoom                [bool]  Should we zoom icons?
 -S, --spacing             [int]   Space in pixels between each icon
 -s, --size                [int]   Size of icons in default state
 -A, --auto-hide           [bool]  Auto hide the engage bar
 -G, --grab-app            [bool]  Capture the icons of all running applications
 -g, --grab-min            [bool]  Capture the icons of minimised applications
 -R, --reserve             [int]   The amount of space reserved at the bottom of the screen
 -m, --mode                [int]   The display mode, 0 = ontop + shaped, 1 = below + transp.
 -e, --engine              [str]   The X11 engine to use - either software or gl
 -t, --theme               [str]   The theme name to use (minus path and extension)
 -H, --height              [int]   The overall height of the application area
 -W, --width               [int]   The overall width of the application area

$ engage -W 1280 -T 0 -I 1 -i 1 -e software -H 80 -s 28 -Z 1.9

$ engage -b "#00000000"