# Manuel des extensions d'Epiphany

## Introduction

Epiphany Extensions représente un ensemble d'outils augmentant les possibilités d'Epiphany, le navigateur Web de GNOME.

Elles offrent à Epiphany de nouvelles fonctionnalités et complètent celles existantes.

## Gestionnaire d'extensions

### Introduction

Le gestionnaire d'extensions est l'outil qui permet d'activer les extensions d'Epiphany.

### Utilisation du gestionnaire d'extensions

Pour ouvrir le gestionnaire d'extensions, choisissez Outils Extensions.

Pour activer une extension, cochez la case en face de cette extension. Pour désactiver une extension, décochez cette case.

## Actions

### Introduction

L'extension Actions permet de créer des actions spécifiques pour les images, les pages ou les deux, dans le menu contextuel.

### Gestion des actions

#### Création d'actions

Pour créer une action, suivez les instructions suivantes :

1. Choisissez Édition Actions pour ouvrir le gestionnaire d'actions.

2. Cliquez sur Ajouter pour ajouter une nouvelle action.

3. Dans la fenêtre « Ajouter une action » :

   - Saisissez le Nom de l'action. C'est ce nom qui apparaîtra dans le menu contextuel.

   - Saisissez la Description de l'action. La description sera affichée dans la barre d'état d'Epiphany et dans le gestionnaire d'actions.

   - Saisissez la Commande à exécuter. Cette commande sera exécutée et recevra comme paramètre l'élément depuis lequel l'action a été initiée. Cette action peut être un programme ou un script disponible dans le chemin.

   - Sélectionnez Pages ou Images pour choisir sur quel élément l'action doit agir.

   - Cliquez sur Ajouter.

4. Cliquez sur Fermer pour fermer le gestionnaire d'actions.

##### Un exemple d'action

#### Modification des actions

Pour modifier une action, suivez ces instructions :

1. Choisissez Édition Actions pour ouvrir le gestionnaire d'actions.

2. Sélectionnez l'action à modifier.

3. Cliquez sur Propriétés.

4. Modifiez l'action comme expliqué dans epi-ext-action-manage-create.

#### Suppression d'actions

Pour supprimer une action, suivez les étapes suivantes :

1. Choisissez Édition Actions pour ouvrir le gestionnaire d'actions.

2. Sélectionnez l'action à supprimer.

3. Cliquez sur Supprimer.

4. Cliquez sur Fermer pour fermer le gestionnaire d'actions.

### Utilisation des actions

Pour utiliser une action personnalisée, choisissez l'action à exécuter depuis le menu contextuel de l'élément sur lequel vous souhaitez que l'action agisse.

#### Le menu contextuel des images dans Epiphany avec une action personnalisée

## Ad Blocker

### Introduction

L'extension Ad Blocker permet de bloquer l'affichage et le chargement des bannières publicitaires sur les sites Web, ce qui permet de gagner du temps et de la bande passante.

### Utilisation de Ad Blocker

Pour utiliser l'extension Ad Blocker, il suffit de l'activer. L'extension ignore les liens vers les publicités lorsque vous visitez un site Web, elles ne sont donc pas visibles sur les pages Web.

Epiphany affiche une icône du côté gauche de la barre d'état (voir epi-ext-figure-adblocker) pour indiquer que des publicités sont bloquées. En passant le pointeur de la souris devant l'icône, le nombre de publicités bloquées sur cette page sera affiché.

#### L'icône de Ad Blocker

### Extension de Ad Blocker

Ad Blocker peut bloquer la plupart des publicités sur le Web. Si toutefois beaucoup de bannières ne sont pas bloquées ou au contraire si Ad Blocker est trop restrictif, il est possible de paramétrer l'extension Ad Blocker pour répondre à vos exigences.

Ad Blocker utilise des expressions régulières Perl pour trouver les adresses Web connues des serveurs de publicités ainsi que les mots les plus utilisés dans les adresses Web de publicité. Ad Blocker enregistre les règles générales du système dans le fichier `adblock-patterns` situé dans `$PREFIX/share/epiphany-extensions/` ; une seule expression régulière par ligne.

#### Ajout d'une règle d'exclusion

Si vous souhaitez bloquer une publicité non reconnue par les règles initiales de Ad Blocker, vous pouvez créer une liste noire et y ajouter des règles.

Epiphany recherche les règles de la liste noire dans le fichier `$HOME/.gnome2/epiphany/extensions/data/adblock/blacklist`.

#### Ajout d'une règle de permission

Si vous souhaitez permettre à une publicité d'être affichée ou corriger une règle de Ad Blocker qui est trop restrictive, vous pouvez créer une liste blanche et y ajouter des règles.

Epiphany recherche les règles de la liste blanche dans le fichier `$HOME/.gnome2/epiphany/extensions/data/adblock/whitelist`.

## Rechargement automatique d'onglet

### Introduction

L'extension de rechargement automatique d'onglet permet de rafraîchir régulièrement le contenu d'une page affichée dans un onglet.

### Utilisation du rechargement automatique d'onglet

Saisissez l'adresse de la page à ouvrir et dont vous savez que le contenu change souvent, puis choisissez Affichage Rafraîchir automatiquement pour activer le rechargement automatique. Epiphany met alors à jour le contenu de la page toutes les 3 minutes.

#### Rechargement automatique de fichiers locaux

Lorsqu'un fichier local est ouvert, Epiphany le surveille et recharge son contenu lorsqu'il est modifié.

## Défilement automatique

### Introduction

L'extension Défilement automatique permet de faire défiler une page automatiquement dans n'importe quelle direction. Par exemple, en sélectionnant un défilement lent, il est possible de lire une page Web entière sans toucher à la souris.

### Utilisation du Défilement automatique

Pour démarrer un défilement automatique sur une page,

1. Appuyez et relâchez le bouton milieu de la souris ; une cible apparaît et le pointeur de la souris prend la forme d'une main.

2. Déplacez le curseur dans la direction souhaitée du défilement. La page commence à défiler dans cette direction.

## Certificats

### Introduction

L'extension Certificats donne accès aux certificats sauvegardés par Epiphany, dans le but de les consulter ou de les gérer.

### Utilisation de Certificats

#### Affichage des certificats de sites Web

Lors d'une visite sur un site Web sécurisé, le cadenas situé à gauche de la barre d'état passe de ouvert à fermé. Lorsque l'extension Certificats est activée, il est possible de cliquer sur le cadenas, ce qui affiche les informations relatives au certificat.

#### Gestion des certificats

L'extention Certificats permet de gérer les certificats sauvegardés par le navigateur Epiphany.

Pour afficher le Gestionnaire de certificats, choisissez Outils Gérer les certificats, ce qui donne accès à 4 onglets :

Your Certificates (Vos certificats)

- Pour importer, afficher, sauvegarder et supprimer vos certificats personnels. Ceux-ci peuvent être utilisés pour vous identifier lorsque vous naviguez sur un site sensible.

Other People's (Autres personnes)

- Pour importer, afficher, modifier et supprimer les certificats de vos connaissances.

Web Sites

- Pour importer, afficher, modifier et supprimer les certificats provenant des sites déjà visités.

Authorities (Autorités)

- Pour importer, afficher, modifier et supprimer les certificats provenant d'autorités. Celles-ci sont les organisations pouvant créer des certificats publiés sur Internet et valider leur authenticité.

#### Gestion des systèmes de sécurité

Les systèmes de sécurité permettent de chiffrer et déchiffrer les connexions et peuvent stocker des certificats et des mots de passe.

## Visionneur d'erreurs

### Introduction

L'extension Visionneur d'erreurs permet d'afficher les erreurs dans les pages Web, de valider des pages Web et de vérifier des liens.

### Utilisation du visionneur d'erreurs

Le visionneur d'erreurs est une petite extension utile aux webmestres pour vérifier que leurs sites sont conformes aux standards du Web. Cette extension offre 3 fonctionnalités :

Vérificateur de liens

- Détection des liens mort sur un site.

Vérificateur de code HTML

- Vérification de la validité du code source.

Visionneur d'erreurs

- Affichage d'erreurs diverses dans une page Web (comme javascript, ...).

Pour démarrer la vérification de liens, choisissez Outils Vérifier les liens. La fenêtre de vérification des erreurs s'ouvre et la vérification des liens démarre automatiquement.

Pour démarrer la vérification de code HTML, choisissez Outils Vérifier le code HTML. La fenêtre de vérification des erreurs s'ouvre et la vérification de code HTML démarre automatiquement.

Pour lancer le visionneur d'erreur, choisissez Outils Visionneur d'erreurs. La fenêtre du visionneur d'erreurs s'ouvre. Elle affiche toutes les erreurs de validation découvertes dans la page Web.

## Favicon par défaut

### Introduction

L'extension Favicon par défaut permet de récupérer l'icône favicon.ico lorsque la favicon n'est pas correctement déclarée dans la page Web.

### Utilisation de Favicon

Lorsque l'extension est activée, elle récupère le fichier image /favicon.ico sur chaque site visité si ce fichier existe. Puis, Epiphany affiche cette icône à gauche dans la barre d'adresse.

## Mouvements

### Introduction

L'extension Mouvements permet d'exécuter rapidement des actions dans Epiphany en dessinant une forme avec la souris.

### Utilisation de Mouvements

Pour effectuer un mouvement, cliquez sur le bouton milieu de la souris dans le volet d'affichage d'une fenêtre d'Epiphany, bougez la souris en dessinant l'un des schémas ci-après, puis relâchez le bouton. Le curseur change d'apparence durant le mouvement.

### Liste des schémas disponibles par défaut dans Epiphany Extensions

Action | Mouvement | Exemple
Revenir à la page précédente dans l'historique | Gauche |
Aller à la page suivante dans l'historique | Droite |
Remonter d'un niveau d'arborescence | Haut - gauche - haut |
Aller sur la page par défaut | Haut - gauche - bas |
Actualiser la page | Haut - bas |
Arrêter le chargement de la page | Gauche - haut |
Ouvrir une nouvelle fenêtre | Haut |
Ouvrir un nouvel onglet | Bas |
Fermer un onglet ou une fenêtre | Droite - gauche - droite |
Fermer un onglet ou une fenêtre (second mouvement) | Bas - droite |
Activer ou quitter le mode plein écran | Bas - gauche |
Aller à l'onglet suivant | Haut - droite |
Aller à l'onglet précédent | Haut - gauche |
Voir le code source de la page | Gauche - bas - droite - bas - gauche (faire un S) |
Voir le code source de la page (second mouvement) | Haut - droite - bas |

### Création de mouvements

L'extension Mouvements permet de créer vos propres schémas de mouvements et d'enrichir ceux fournis par défaut.

#### Fonctionnement des mouvements

Epiphany stocke la définition des mouvements pour tous les utilisateurs dans le fichier `ephy-gestures.xml` situé dans le répertoire `$PREFIX/share/epiphany-extensions/`. Ce fichier utilise le format XML et définit les mouvements pour tous les utilisateurs du système.

En ouvrant ce fichier, on peut voir un ensemble de balises de mouvement. À l'intérieur, on trouve une ou plusieurs balises <sequence> et une balise d'action.

##### Un exemple de mouvement

    <!-- down-left -->
    <gesture>
    	<sequence>36987</sequence>
    	<sequence>3687</sequence>
    	<action>/menubar/ViewMenu/ViewFullscreenMenu</action>
    </gesture>

#### Création d'un mouvement

Dans cette section, on explique comment créer un nouveau mouvement. L'exemple choisi correspond à l'impression d'une page Web en dessinant un P à l'aide de la souris.

Pour créer vos propres mouvements, créez d'abord un fichier nommé `ephy-gestures.xml` dans le répertoire `~/.gnome2/epiphany/` qui stockera les définitions de vos mouvements personnels.

Ouvrez le fichier nouvellement créé avec un éditeur de texte et insérez le contenu suivant :

    <?xml version="1.0"?>
    <epiphany_gestures version="0.4">
    	<gesture>
    		<sequence></sequence>
    		<action></action>
    	</gesture>
    </epiphany_gestures>

##### Définition du schéma de mouvement

Pour définir un nouveau mouvement, nous avons besoin d'au moins une ou plusieurs séquences et d'une action à exécuter.

Une séquence est un groupe de valeurs numériques comprises entre 1 et 9 qui définit le mouvement en suivant le plan d'un clavier de téléphone (avec le « 1 » situé dans le coin supérieur gauche et le « 9 » dans le coin inférieur droit).

Si l'on souhaite dessiner un P, la séquence est 74123654. Insérez cette valeur entre les balises « sequence ».

    <?xml version="1.0"?>
    <epiphany_gestures version="0.4">
    	<gesture>
    		<sequence>74123654</sequence>
    		<action></action>
    	</gesture>
    </epiphany_gestures>

##### Définition de l'action

Une action décrit le chemin vers un menu ou un élément de barre d'outils dans la fenêtre d'Epiphany. Tous les chemins sont définis dans le fichier `ephy-gestures.xml` situé dans `$PREFIX/epiphany/epiphany-ui.xml`.

    <?xml version="1.0"?>
    <epiphany_gestures version="0.4">
    	<gesture>
    		<sequence>74123654</sequence>
    		<action>/menubar/FileMenu/FilePrintMenu</action>
    	</gesture>
    </epiphany_gestures>

## Greasemonkey

### Introduction

Greasemonkey est une extension puissante qui permet aux utilisateurs d'utiliser des scripts qui effectuent des changements à la volée sur les pages Web. Par exemple, les scripts Greasemonkey peuvent faire des modifications de page ou remplir automatiquement des formulaires.

Les scripts Greasemonkey sont des javascripts et ont l'extension de fichier « .user.js ». L'extension Greasemonkey n'est livrée avec aucun script, il faudra donc trouver vous-même les scripts sur le Web. Le site http://userscripts.org/ possède un bon dépôt de scripts Greasemonkey.

Pour en savoir plus au sujet de Greasemonkey, consultez la définition sur l'encyclopédie en ligne Wikipédia.

### Utilisation de Greasemonkey

#### Installation d'un script Greasemonkey

Pour installer un script Greasemonkey, trouvez d'abord un lien vers un script Greasemonkey sur une page Web. Faites un clic droit sur le lien et choisissez Installer un script utilisateur. Epiphany télécharge alors le script. Un message confirme que le script est installé et prêt à l'emploi.

Il est possible d'installer manuellement des scripts Greasemonkey en les copiant dans `$HOME/.gnome2/epiphany/extensions/data/greasemonkey/`

#### Désinstallation d'un script Greasemonkey

Epiphany ne fournit pas d'interface graphique pour supprimer les scripts. Pour ce faire, il faut aller dans `$HOME/.gnome2/epiphany/extensions/data/greasemonkey/` et mettre le fichier de script à la corbeille.

## Console Java

### Introduction

L'extension Console Java donne accès à la console du greffon Java.

### Utilisation de Console Java

Pour afficher la console Java, choisissez Outils Console Java.

## Abonnement aux flux de nouvelles

### Introduction

L'extension « Abonnement aux flux de nouvelles » permet de s'abonner à un flux de nouvelles proposé par une page Web dans votre lecteur de nouvelles favori. Les lecteurs de nouvelles pris en charge sont

- Liferea

- Straw

- Blam

### Utilisation des Abonnements aux flux de nouvelles

Quand Epiphany détecte qu'un site Web propose des flux RSS ou Atom, une icône s'affiche sur le côté gauche de la barre d'état d'Epiphany.

Pour s'abonner à ce flux :

1. Choisissez Outils Abonnement aux flux de nouvelles. Une nouvelle fenêtre contenant la liste des flux disponibles apparaît. On peut aussi cliquer sur l'icône Flux dans la barre d'état pour faire apparaître la fenêtre d'Abonnement aux flux de nouvelles.

2. Choisissez les flux auxquels vous souhaitez vous abonner. Il est aussi possible de copier l'adresse du flux en utilisant son menu contextuel.

3. Cliquez sur S'abonner pour vous inscrire au flux.

## Informations sur la page

### Introduction

L'extension « Informations sur la page » affiche des informations détaillées concernant la page Web visitée.

### Utilisation de Informations sur la page

Pour accéder aux informations concernant la page, choisissez Affichage Informations sur la page. Une nouvelle fenêtre apparaît, donnant accès à 5 onglets :

Généralités

- Fournit diverses informations à propos de la page et du site.

Média

- Affiche les fichiers multimédias (images, sons, ...) utilisés sur cette page.

Liens

- Affiche tous les liens de la page Web.

Formulaires

- Tous les formulaires disponibles sur la page sont affichés.

Métadonnées

- Affiche les informations fournies par le webmestre concernant ce site.

## Défilement à la souris

### Introduction

L'extension « Défilement à la souris » fait défiler la page lorsque le bouton milieu de la souris est pressé.

### Utilisation du défilement à la souris

Pour utiliser le défilement à la souris, appuyez simplement le bouton milieu de la souris. Puis, en déplaçant celle-ci dans n'importe quelle direction, la page va défiler.

## Console Python

### Introduction

Ouvre une console Python interactive et permet de modifier Epiphany en utilisant Python.

### Utilisation de la console Python

Pour afficher la console Python, choisissez Outils Console Python.

## Sélection de la feuille de style

### Introduction

L'extension « Sélection de la feuille de style » permet de passer de l'une à l'autre des feuilles de style d'une page Web. Vous pouvez également désactiver les feuilles de style lorsque vous visitez une page.

### Utilisation de la Sélection de la feuille de style

Pour changer la feuille de style du site visité, choisissez Affichage Style, puis choisissez une feuille de style dans les feuilles disponibles.

En choisissant la feuille de style Aucune, le site Web n'utilise aucune feuille de style.

## Panneau latéral

### Introduction

L'extension Panneau latéral ajoute une petite fenêtre sur le côté gauche de la fenêtre d'Epiphany. Le panneau latéral permet d'afficher le contenu d'un site Web et d'accéder rapidement à ses informations.

### Utilisation du panneau latéral

#### Epiphany avec un panneau latéral

#### Affichage du panneau latéral

Par défaut, le panneau latéral n'est pas affiché. Pour l'afficher, choisissez Affichage Panneau latéral.

La touche F9 permet aussi d'afficher ou de masquer le panneau latéral.

#### Ajout d'un panneau latéral

Pour ajouter un panneau latéral, activez l'extension Panneau latéral, puis cliquez sur le lien donné par le site Web pour installer le panneau latéral. Une boîte de dialogue demande alors s'il faut ajouter le document au panneau latéral. Cliquez sur Ajouter un panneau latéral pour que le document soit ajouté au panneau latéral.

On peut trouver une liste de sites Web contenant des panneaux latéraux sur DMOZ.

#### Basculer entre panneaux latéraux

Lorsqu'on a installé plusieurs panneaux latéraux, on peut passer de l'un à l'autre en sélectionnant le panneau latéral souhaité dans le menu déroulant en haut du panneau latéral.

#### Suppression d'un panneau latéral

Pour supprimer un panneau latéral existant, affichez le panneau latéral à supprimer et cliquez sur l'icône corbeille.

## Signets intelligents

### Introduction

L'extension Signets intelligents est une extension qui active la recherche d'un texte sélectionné avec un signet intelligent.

### Utilisation des signets intelligents

Pour créer un signet intelligent, consultez la section correspondante dans le manuel d'Epiphany.

Pour rechercher du texte, sélectionnez le texte sur une page Web, faites un clic droit et choisissez Rechercher et le signet intelligent dans le menu contextuel. Une nouvelle fenêtre du navigateur s'ouvre avec le résultat de la recherche.

## Groupes d'onglets

### Introduction

L'extension Groupes d'onglets permet de faire apparaître les nouveaux onglets juste après l'onglet actuel.

### Utilisation de Groupes d'onglets

Une fois cette extension activée, un nouveau mode de fonctionnement vient remplacer l'habituel (quand les nouveaux onglets sont créés après le dernier onglet). Quand on ouvre un nouvel onglet, il est créé après l'onglet actuel.

#### Un nouvel onglet créé après le premier onglet

## États des onglets

### Introduction

L'extension États des onglets modifie l'état de l'étiquette d'onglet lorsque le contenu de celui-ci a changé.

### Utilisation de États des onglets

Lorsque l'extension est activée, l'étiquette d'un onglet dont le contenu change s'affiche en gras, pour vous avertir que la page a été modifiée.

## À propos des extensions d'Epiphany

Les extensions d'Epiphany ont été écrites par :

- Samuel Abels (spam2@debain.org)

- Crispin Flowerday (gnome@flowerday.cx)

- Adam Hooper (adamh@cvs.gnome.org)

- Mathias Hasselmann (mathias@taschenorakel.de)

- James Henstridge (james@daa.com.au)

- Jean-Yves Lefort (jylefort@brutele.be)

- Christian Persch (chpe@gnome.org)

- Raphaël Slinckx (raphael@slinckx.net)

- Justin Wake (jwake@iinet.net.au)

Ce manuel a été écrit par Baptiste Mille-Mathias baptiste.millemathias@gmail.com.

Ce programme est distribué selon les termes de la GNU General Public License publiée par la Free Software Fondation ; à partir de la version 2 de cette licence, ou (selon votre choix) toute version supérieure. Une copie de cette licence peut être trouvée à cette adresse, ou encore dans le ficher COPYING inclus avec le code source de ce programme.