1
<?xml version="1.0" encoding="utf-8"?>
2
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
3
<!ENTITY legal SYSTEM "legal.xml">
4
<!ENTITY appversion "2.14">
5
<!ENTITY manrevision "1.0">
6
<!ENTITY date "March 2006">
7
<!ENTITY app "<application>Epiphany</application>">
8
<!ENTITY frplain "Epiphany">
9
<!ENTITY fr "<application>Epiphany Extensions</application>">
10
<!-- Information about the entities
11
The legal.xml file contains legal information, there is no need to edit the file.
12
Use the appversion entity to specify the version of the application.
13
Use the manrevision entity to specify the revision number of this manual.
14
Use the date entity to specify the release date of this manual.
15
Use the fr entity to specify the name of the application. -->]>
17
(Do not remove this comment block.)
18
Maintained by the GNOME Documentation Project
19
http://developer.GNOME.org/projects/gdp
20
Template version: 2.0 beta
21
Template last modified Jan 30, 2002
23
<!-- =============Document Header ============================= -->
24
<article id="index" lang="oc">
25
<!-- please do not change the id; for translations, change lang to -->
26
<!-- appropriate code -->
28
<abstract role="description">
29
<para>Various extensions for Epiphany Web browser.</para>
31
<title>Epiphany Extensions Manual</title>
35
<holder>Baptiste Mille-Mathias</holder>
39
<holder>Victor Osadci</holder>
41
<!-- translators: uncomment this:
45
<holder>ME-THE-TRANSLATOR (Latin translation)</holder>
49
<!-- An address can be added to the publisher information. If a role is
50
not specified, the publisher/author is the same for all versions of the
52
<publisher role="maintainer">
53
<publishername>Projècte de documentacion de GNOME</publishername>
56
<legalnotice id="legalnotice">
58
Permission is granted to copy, distribute and/or modify this
59
document under the terms of the GNU Free Documentation
60
License (GFDL), Version 1.1 or any later version published
61
by the Free Software Foundation with no Invariant Sections,
62
no Front-Cover Texts, and no Back-Cover Texts. You can find
63
a copy of the GFDL at this <ulink type="help" url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS
64
distributed with this manual.
66
<para> This manual is part of a collection of GNOME manuals
67
distributed under the GFDL. If you want to distribute this
68
manual separately from the collection, you can do so by
69
adding a copy of the license to the manual, as described in
70
section 6 of the license.
74
Many of the names used by companies to distinguish their
75
products and services are claimed as trademarks. Where those
76
names appear in any GNOME documentation, and the members of
77
the GNOME Documentation Project are made aware of those
78
trademarks, then the names are in capital letters or initial
83
DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
84
UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
85
WITH THE FURTHER UNDERSTANDING THAT:
89
<para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
90
WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
91
IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
92
THAT THE DOCUMENT OR MODIFIED VERSION OF THE
93
DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
94
A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
95
RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
96
OF THE DOCUMENT OR MODIFIED VERSION OF THE
97
DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
98
MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
99
YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
100
CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
101
SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
102
OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
103
LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
104
VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
105
EXCEPT UNDER THIS DISCLAIMER; AND
109
<para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
110
THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
111
CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
112
INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
113
DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
114
OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
115
PARTIES, BE LIABLE TO ANY PERSON FOR ANY
116
DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
117
CONSEQUENTIAL DAMAGES OF ANY CHARACTER
118
INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
119
OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
120
MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
121
LOSSES ARISING OUT OF OR RELATING TO USE OF THE
122
DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
123
EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
124
THE POSSIBILITY OF SUCH DAMAGES.
130
<!-- This file contains link to license for the
131
documentation (GNU FDL), and other legal stuff such as "NO
132
WARRANTY" statement. Please do not change any of this. -->
136
<firstname>Baptiste</firstname>
137
<surname>Mille-Mathias</surname>
139
<orgname>Projècte de documentacion de GNOME</orgname>
140
<address><email>baptiste.millemathias@gmail.com</email></address>
144
<firstname>Victor</firstname>
145
<surname>Osadci</surname>
147
<orgname>Projècte de documentacion de GNOME</orgname>
148
<address><email>Victor.Osadci.GNOME@xhtml.md</email></address>
155
<revnumber>1.0</revnumber>
161
This manual describes version 2.14 of Epiphany.
165
<indexterm zone="index">
166
<primary>Epiphany-Extensions</primary>
168
<indexterm zone="index">
169
<primary>epiphany-extensions</primary>
171
<indexterm zone="index">
172
<primary>extension</primary>
174
<indexterm zone="index">
175
<primary>Navegador</primary>
178
<!-- ============= Document Body ================================== -->
180
<sect1 id="epi-ext-intro">
181
<title>Introduccion</title>
183
<para><application>Epiphany Extensions</application> are a set of tools that extend the capabilities of <application>Epiphany</application>, the GNOME Web Browser.</para>
184
<para>They provide to Epiphany new functionality and complete some
188
<sect1 id="epi-ext-manager">
189
<title>Extensions Manager</title>
191
<sect2 id="epi-ext-manager-intro">
192
<title>Introduccion</title>
193
<para>The Extension Manager is the tool that lets you activate Epiphany
197
<sect2 id="epi-ext-manager-use">
198
<title>Using Extensions Manager</title>
199
<para>To open the Extension Manager, choose
200
<menuchoice><guimenu>Tools</guimenu><guimenuitem>Extension...</guimenuitem></menuchoice>.</para>
201
<para>To enable an extension, activate the check-box in front of the
202
extension. To disable an extension, deactivate the check-box.</para>
206
<sect1 id="epi-ext-actions">
207
<title>Accions</title>
209
<sect2 id="epi-ext-actions-intro">
210
<title>Introduccion</title>
212
<para>The Actions extension allows you to create specific actions in the
213
context menu, for images, pages or both.</para>
216
<sect2 id="epi-ext-action-manage">
217
<title>Manage Actions</title>
219
<sect3 id="epi-ext-action-manage-create">
220
<title>Create Actions</title>
222
<para>To create an action, perform the following steps:
225
<para>Choose <menuchoice><guimenu>Edit</guimenu>
226
<guimenuitem>Actions</guimenuitem></menuchoice>
227
to open the Actions manager</para>
230
<para>Press <guibutton>Add</guibutton> to add a
235
<para>In the "Add Action" window,
238
<para>Enter the <guilabel>Name</guilabel> of the action. The name
239
will be displayed in the context menu</para>
242
<para>Enter the <guilabel>Description</guilabel> of the action.
243
The Description will be displayed in the
244
statusbar of <application>Epiphany</application> and in the Action
248
<para>Enter the <guilabel>Command</guilabel> to execute. this
249
command will be executed and will receive as
250
argument the element on which you'll launch
251
the action. This action can be any
252
program or script available in your path</para>
255
<para>Select <guilabel>Pages</guilabel> or
256
<guilabel>Images</guilabel> to choose on
257
which elements the action will appear</para>
260
<para>Press <guibutton>Add</guibutton></para>
266
<para>Press <guibutton>Close</guibutton> to close the Actions Manager</para>
270
<figure><title>An example of action</title>
271
<graphic fileref="figures/epi-ext-action-create.png"/>
275
<sect3 id="epi-ext-action-manage-edit">
276
<title>Edit Actions</title>
278
<para>To edit an action, follow these steps:
281
<para>Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Actions</guimenuitem></menuchoice>
282
to open the Actions manager</para>
286
Select the action to edit
290
<para>Press <guibutton>Edit</guibutton>
294
<para>Edit the action as described in <xref linkend="epi-ext-action-manage-create"/>
301
<sect3 id="epi-ext-action-manage-del">
302
<title>Delete Actions</title>
304
<para>To delete an action, do the following:
307
<para>Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Actions</guimenuitem></menuchoice>
308
to open the Actions manager</para>
312
Select the action to delete
316
<para>Press <guibutton>Remove</guibutton>
320
<para>Press <guibutton>Close</guibutton> to close the Actions Manager</para>
327
<sect2 id="epi-ext-actions-usage">
328
<title>Using Actions</title>
330
<para>To use a custom action, choose the action to execute from the context
331
menu of the element you wish to perform the action on.</para>
332
<figure><title>The <application>Epiphany</application> image context menu with a custom action</title>
333
<graphic fileref="figures/epi-ext-actions-use.png"/>
339
<sect1 id="epi-ext-adblocker">
340
<title>Ad Blocker</title>
342
<sect2 id="epi-ext-adblocker-intro">
343
<title>Introduccion</title>
345
<para>The Ad Blocker extension lets you block ad banners on websites.
346
It avoids downloading them, saving time and bandwidth.</para>
349
<sect2 id="epi-ext-adblocker-usage">
350
<title>Using Ad Blocker</title>
352
<para>To use the Ad Blocker, you have to enable the extension.
353
The extension will ignore link to ads when you visit websites, and they won't
354
be displayed in web pages.</para>
355
<para><application>Epiphany</application> will display an icon in left side of the status bar
356
(see <xref linkend="epi-ext-figure-adblocker"/>) to inform you that it has
357
blocked ads. If you move the mouse pointer over the icon, it will
358
give you of the number of ads blocked in the page.
359
<figure id="epi-ext-figure-adblocker">
360
<title>The Ad Blocker icon</title>
361
<graphic fileref="figures/epi-ext-adblocker.png"/>
366
<sect2 id="epi-ext-adblocker-usage-extend">
367
<title>Extend Ad Blocker</title>
369
<para>Ad Blocker should block most of the advertisement on the
370
web, but if you find that some banners are not blocked or Ad
371
Blocker is too restrictive, you can tune Ad Blocker extension to
374
<para>Ad Blocker uses Perl regular expressions to match known URLs of
375
ads servers and common words used in URLs of ads. Ad Blocker
376
stores the system-wide rules in the file
377
<filename>adblock-patterns</filename> located in <filename class="directory">$PREFIX/share/epiphany-extensions/</filename>;
378
one regular expression per line.
381
<sect3 id="epi-ext-adblocker-usage-extend-blacklist">
382
<title>Add a deny rule</title>
384
<para>If you want to block an ad not blocked by the Ad
385
Blocker default rules, you may create a blacklist file, and
386
add rules inside.</para>
387
<para><application>Epiphany</application> looks for the blacklist rules in the file
388
<filename>$HOME/.gnome2/epiphany/extensions/data/adblock/blacklist</filename>.
392
<sect3 id="epi-ext-adblocker-usage-extend-whitelist">
393
<title>Add a permit rule</title>
395
<para>If you want allow to permit an ad to be displayed or
396
correct a rule of Ad Blocker which is too restrictive, you can
397
create a whitelist file, and add rules inside.</para>
398
<para><application>Epiphany</application> looks for white-list rules in the file
399
<filename>$HOME/.gnome2/epiphany/extensions/data/adblock/whitelist</filename>.
405
<sect1 id="epi-ext-autoreloadtab">
406
<title>Auto Reload Tab</title>
408
<sect2 id="epi-ext-autoreloadtab-intro">
409
<title>Introduccion</title>
411
<para>The Auto Reload Tab extension allows you to regularly reload a page
415
<sect2 id="epi-ext-autoreloadtab-usage">
416
<title>Using Auto Reload Tab</title>
418
<para>Enter the URL of a page you want to open and you know its
419
content change often, then choose
420
<menuchoice><guimenu>View</guimenu><guimenuitem>Auto
421
Reload</guimenuitem></menuchoice> to enable auto reload,
422
<application>Epiphany</application> will refresh each 3 minutes.</para>
425
<title>Auto reload local files</title>
427
When a local file is opened, <application>Epiphany</application> will monitor it and reload the file when it changes.
434
<sect1 id="epi-ext-autoscroll">
435
<title>AutoScroll</title>
437
<sect2 id="epi-ext-autoscroll-intro">
438
<title>Introduccion</title>
440
<para>The Auto Scroll extension allows you to automatically scroll a page in
441
any direction. For instance, if you set a slow scroll, you can read a
442
whole web page without touching your mouse.</para>
445
<sect2 id="epi-ext-autoscroll-usage">
446
<title>Using Auto Scroll</title>
448
<para>To start to auto scroll on a page,
451
<para>Press and release the middle-mouse button; a
452
target appears, and the cursor of mouse pointer is
453
changed to a hand cursor.</para>
456
<para>Move the cursor in the direction to scroll.
457
The page will start to scroll in that direction.</para>
464
<sect1 id="epi-ext-certificates">
465
<title>Certificats</title>
467
<sect2 id="epi-ext-certificates-intro">
468
<title>Introduccion</title>
470
<para>The Certificates extension gives access to the certificates stored
471
by <application>Epiphany</application>, in order to view or manage them.</para>
474
<sect2 id="epi-ext-certificates-usage">
475
<title>Using Certificates</title>
477
<sect3 id="epi-ext-certificates-usage-view">
478
<title>View website certificate</title>
480
<para>When you browse a secured website, the unlocked padlock
481
which appear on the left of the status bar becomes a locked
482
padlock. When the Certificates extension is activated, you
483
can click on the padlock, it will display the
484
certificate information.</para>
487
<sect3 id="epi-ext-certificates-usage-manage">
488
<title>Manage Certificates</title>
490
<para>Certificates extensions lets you manage the certificates
491
stored by <application>Epiphany</application> Browser.</para>
492
<para>To display the <guilabel>Certificate Manager</guilabel>, choose
493
<menuchoice><guimenu>Tools</guimenu><guimenuitem>Manage
494
Certificates</guimenuitem></menuchoice>, it gives access to 4
498
<term><guilabel>Your Certificates</guilabel></term>
499
<listitem><para>To import, view, backup and delete
500
your own certificates. Personal Certificates can be used
501
to identify when you browse a sensible site.</para></listitem>
506
<term><guilabel>Other People's</guilabel></term>
507
<listitem><para>To import, view, edit and delete
508
certificates from people you know.</para></listitem>
511
<term><guilabel>Sits web</guilabel></term>
512
<listitem><para>To import, view, edit and delete
513
certificates from website you visited.</para></listitem>
516
<term><guilabel>Authorities</guilabel></term>
517
<listitem><para>To import, view, edit and delete
518
certificates from authorities. Authorities are
519
organizations which create and validate the authenticity
520
of published certificates over the Internet.</para></listitem>
526
<sect3 id="epi-ext-certificates-usage-manage-devices">
527
<title>Manage Security Devices</title>
529
<para>Security Devices are used encrypt and decrypt connections
530
and can store certificates and passwords.</para>
535
<sect1 id="epi-ext-errorviewer">
536
<title>Error Viewer</title>
538
<sect2 id="epi-ext-errorviewer-intro">
539
<title>Introduccion</title>
541
<para>The Error Viewer extension allows you to view errors in web pages,
542
validate web pages and check links.</para>
545
<sect2 id="epi-ext-errorviewer-usage">
546
<title>Using Error Viewer</title>
548
<para>The Error Viewer is a small but useful extension for webmasters to check that
549
websites (specially yours) conform to Web standards. This extension comes with 3
553
<term><guilabel>Links Checker</guilabel></term>
554
<listitem><para>Detects dead links on a site</para></listitem>
557
<term><guilabel>HTML Code Checker</guilabel></term>
558
<listitem><para>Checks the validity of the source code.</para></listitem>
561
<term><guilabel>Error Viewer</guilabel></term>
562
<listitem><para>Displays various errors of a
563
webpage (like javascript, ...)</para></listitem>
567
<para>To launch the Links Checker, choose
568
<menuchoice><guimenu>Tools</guimenu><guimenuitem>Check
569
Links</guimenuitem></menuchoice>. The error viewer window will open, and
570
the links verification will start automatically.</para>
571
<para>To launch the HTML Code Checker, choose
572
<menuchoice><guimenu>Tools</guimenu><guimenuitem>Check
573
HTML</guimenuitem></menuchoice>. The error viewer window will open, and
574
the HTML code verification will start automatically.</para>
575
<para>To launch the Error Viewer, choose
576
<menuchoice><guimenu>Tools</guimenu><guimenuitem>Error
577
Viewer</guimenuitem></menuchoice>. The error viewer window will open, it
578
will display all the validation errors discovered in the web page.</para>
582
<sect1 id="epi-ext-favicon">
583
<title>Favicon Fallback</title>
585
<sect2 id="epi-ext-favicon-intro">
586
<title>Introduccion</title>
588
<para>The Favicon Fallback extension allows to retrieve the icon favicon.ico when
589
the favicon is not well declared in web page.</para>
592
<sect2 id="epi-ext-favicon-usage">
593
<title>Using Favicon</title>
595
<para>Once activated, this extension will retrieve the picture file
596
/favicon.ico on each site you will visit if this file exists. Then
597
<application>Epiphany</application> will display this icon on the left of the location bar.</para>
601
<sect1 id="epi-ext-gestures">
602
<title>Gestures</title>
604
<sect2 id="epi-ext-gestures-intro">
605
<title>Introduccion</title>
607
<para>The Gestures allows you to quickly perform actions in <application>Epiphany</application> by drawing
608
a shape with the mouse.</para>
611
<sect2 id="epi-ext-gestures-usage">
612
<title>Using Gestures</title>
614
<para>To perform a gesture, press the middle button in the view pane of
615
a <application>Epiphany</application> window, move the mouse in one of the following patterns, and then
616
release the button. The cursor will change while the gesture is being performed.
619
<table frame="topbot" id="epi-ext-gestures-table-patterns">
620
<title>List of available default patterns in <application>Epiphany Extensions</application></title>
621
<tgroup cols="3" colsep="0" rowsep="0">
622
<colspec colname="COLSPEC0"/>
623
<colspec colname="COLSPEC1"/>
624
<colspec colname="COLSPEC2"/>
627
<entry valign="top">Accion</entry>
628
<entry valign="top">Gesture</entry>
629
<entry valign="top">Exemple</entry>
634
<entry valign="top">Go back in history</entry>
635
<entry valign="top">Esquèrra</entry>
639
<imagedata fileref="figures/epi-ext-gestures-back.png" format="PNG"/>
645
<entry valign="top">Go forward in history</entry>
646
<entry valign="top">Drecha</entry>
650
<imagedata fileref="figures/epi-ext-gestures-forward.png" format="PNG"/>
656
<entry valign="top">Go up in a directory</entry>
657
<entry valign="top">Up - Left - Up</entry>
661
<imagedata fileref="figures/epi-ext-gestures-up.png" format="PNG"/>
667
<entry valign="top">Go to your home page</entry>
668
<entry valign="top">Up - Left - Down</entry>
672
<imagedata fileref="figures/epi-ext-gestures-homepage.png" format="PNG"/>
678
<entry valign="top">Reload the page</entry>
679
<entry valign="top">Up - Down</entry>
683
<imagedata fileref="figures/epi-ext-gestures-reload.png" format="PNG"/>
689
<entry valign="top">Stop loading the page</entry>
690
<entry valign="top">Left - Up</entry>
694
<imagedata fileref="figures/epi-ext-gestures-stop.png" format="PNG"/>
700
<entry valign="top">Dobrir una novèla fenèstra</entry>
701
<entry valign="top">Amont</entry>
705
<imagedata fileref="figures/epi-ext-gestures-new-window.png" format="PNG"/>
711
<entry valign="top">Open a new tab</entry>
712
<entry valign="top">Aval</entry>
716
<imagedata fileref="figures/epi-ext-gestures-new-tab.png" format="PNG"/>
722
<entry valign="top">Close a tab/window</entry>
723
<entry valign="top">Right - Left - Right</entry>
727
<imagedata fileref="figures/epi-ext-gestures-close.png" format="PNG"/>
733
<entry valign="top">Close a tab /window (second gesture)</entry>
734
<entry valign="top">Down - Right</entry>
738
<imagedata fileref="figures/epi-ext-gestures-close-2.png" format="PNG"/>
744
<entry valign="top">Toggle full-screen mode</entry>
745
<entry valign="top">Down - Left</entry>
749
<imagedata fileref="figures/epi-ext-gestures-fullscreen.png" format="PNG"/>
755
<entry valign="top">Go to the next tab</entry>
756
<entry valign="top">Up - Right</entry>
760
<imagedata fileref="figures/epi-ext-gestures-next-tab.png" format="PNG"/>
766
<entry valign="top">Go to the previous tab</entry>
767
<entry valign="top">Up - Left</entry>
771
<imagedata fileref="figures/epi-ext-gestures-prev-tab.png" format="PNG"/>
777
<entry valign="top">View the page source</entry>
778
<entry valign="top">Left - Down - Right - Down - Left (Do a
779
<wordasword>E</wordasword>)</entry>
783
<imagedata fileref="figures/epi-ext-gestures-view-source.png" format="PNG"/>
789
<entry valign="top">View the page source (Second gesture)</entry>
790
<entry valign="top">Up - Right - Down</entry>
794
<imagedata fileref="figures/epi-ext-gestures-view-source-2.png" format="PNG"/>
804
<sect2 id="epi-ext-gestures-create">
805
<title>Create gestures</title>
807
<para>The Gestures extension lets you create your own gesture patterns, and so let you
808
extend the set provided by default.</para>
810
<sect3 id="epi-ext-gestures-create-how">
811
<title>Understand how gesture works</title>
813
<para><application>Epiphany</application> stores the definition of the gestures for all users in the file
814
<filename>ephy-gestures.xml</filename> located in the directory <filename class="directory">$PREFIX/share/epiphany-extensions/</filename>; this
815
file uses the xml format, and defines the gestures for all the users of
818
<para>If you open this file, you see a set of markup gesture, and
819
inside them, there is one of several markup sequence and one markup
822
<title>A Gesture Example</title>
824
<![CDATA[<!-- down-left -->
826
<sequence>36987</sequence>
827
<sequence>3687</sequence>
828
<action>/menubar/ViewMenu/ViewFullscreenMenu</action>
829
</gesture>]]></programlisting>
834
<sect3 id="epi-ext-gestures-create-why">
835
<title>Create new gesture</title>
837
<para>In this section, we will explain how to create a new gesture. We
838
will decide to print the web page when we will draw a
839
<wordasword>P</wordasword> with the mouse.</para>
841
<para>To create your own gestures, first create a file named
842
<filename>ephy-gestures.xml</filename> in the directory <filename class="directory">~/.gnome2/epiphany/</filename> which will store your
843
personal gesture definitions.</para>
845
<para>Open the newly created file with a text editor and add the following
848
<![CDATA[<?xml version="1.0"?>
849
<epiphany_gestures version="0.4">
851
<sequence></sequence>
854
</epiphany_gestures>]]></programlisting>
857
<sect4 id="epi-ext-gestures-create-seq">
858
<title>Define the gesture movement</title>
860
<para>To define a new gesture, you need at least one or several
861
sequences and an action to execute.</para>
862
<para>A sequence is a set of numerical values between 1 and 9 which
863
define the gesture to draw following a phone keypad layout (with "1"
864
placed to the top-left hand corner and the "9" at the bottom-right
866
<para>If we want to draw a <wordasword>P</wordasword>, the key sequence
867
is 74123654, insert this value between the markups "sequence".</para>
869
<![CDATA[<?xml version="1.0"?>
870
<epiphany_gestures version="0.4">
872
<sequence>74123654</sequence>
875
</epiphany_gestures>]]></programlisting>
878
<sect4 id="epi-ext-gestures-create-act">
879
<title>Define the action</title>
881
<para>An action describes the path to a menu or toolbar item
882
in the <application>Epiphany</application> window. All these paths are defined is the file
883
<filename>ephy-gestures.xml</filename> located in <filename class="directory">$PREFIX/epiphany/epiphany-ui.xml</filename></para>
885
<![CDATA[<?xml version="1.0"?>
886
<epiphany_gestures version="0.4">
888
<sequence>74123654</sequence>
889
<action>/menubar/FileMenu/FilePrintMenu</action>
891
</epiphany_gestures>]]></programlisting>
897
<sect1 id="epi-ext-greasemonkey">
898
<title>Greasemonkey</title>
900
<sect2 id="epi-ext-greasemonkey-intro">
901
<title>Introduccion</title>
903
<para>Greasemonkey is a powerful extension that allows users to use
904
scripts that make on-the-fly changes to web pages. The
905
greasemonkey scripts can make page modifications or automatically
906
fill forms for instance.</para>
907
<para>Greasemonkey scripts are javascripts and have the file
908
extension ".user.js". Greasemonkey extension doesn't come with any scripts, you have to find
909
by yourself scripts over the web. A good Greasemonkey scripts repository is the
910
site <ulink url="http://userscripts.org/">http://userscripts.org/</ulink>.</para>
911
<para>To learn more about Greasemonkey, read the <ulink url="http://en.wikipedia.org/wiki/Greasemonkey">definition</ulink> on the
912
Wikipedia on-line enciclopedia.</para>
915
<sect2 id="epi-ext-greasemonkey-usage">
916
<title>Using Greasemonkey</title>
918
<sect3 id="epi-ext-greasemonkey-usage-add">
919
<title>Install a Greasemonkey script</title>
921
<para>To install a Greasemonkey script, first locate a link to a
922
greasemonkey script on a web page, right-click on the link, and
923
choose <guimenuitem>Install User Script</guimenuitem>. <application>Epiphany</application>
924
will download the script; a message box will confirm the script
925
is installed and ready to use.</para>
926
<tip><para>You can manually install Greasemonkey scripts by
927
copying them in <filename class="directory">$HOME/.gnome2/epiphany/extensions/data/greasemonkey/</filename></para></tip>
930
<sect3 id="epi-ext-greasemonkey-usage-del">
931
<title>Remove a Greasemonkey script</title>
933
<para><application>Epiphany</application> doesn't provide a Graphical User interface to delete scripts;
934
to remove a script go to
935
<filename class="directory">$HOME/.gnome2/epiphany/extensions/data/greasemonkey/</filename>
936
, and move the script file in the trash.</para>
941
<sect1 id="epi-ext-javaconsole">
942
<title>Java Console</title>
944
<sect2 id="epi-ext-javaconsole-intro">
945
<title>Introduccion</title>
947
<para>Java Console extension provides access to the Java-Plugin
951
<sect2 id="epi-ext-javaconsole-usage">
952
<title>Using Java Console</title>
954
<para>To display the Java Console, choose
955
<menuchoice><guimenu>Tools</guimenu><guimenuitem>Java
956
Console</guimenuitem></menuchoice>.</para>
960
<sect1 id="epi-ext-newsfeedsubscription">
961
<title>News Feed Subscription</title>
963
<sect2 id="epi-ext-newsfeedsubscription-intro">
964
<title>Introduccion</title>
966
<para>The News Feed Subscription extension allows you to subscribe to a news feed
967
offered by the web page in your favorite news reader. The supported
970
<listitem><para>Liferea</para></listitem>
971
<listitem><para>Straw</para></listitem>
972
<listitem><para>Blam</para></listitem>
977
<sect2 id="epi-ext-newsfeedsubscription-usage">
978
<title>Using News Feed Subscription</title>
980
<para>When <application>Epiphany</application> detects a that a website provides RSS and Atom feeds, it
981
will display an icon on left side of the <application>Epiphany</application> status bar.</para>
982
<para>To register this feed:
986
Choose <menuchoice><guimenu>Tools</guimenu><guimenuitem>News Feed
987
Subscription</guimenuitem></menuchoice>, a new
988
window with the list of available feeds
989
appears. You can also click on the Feed icon in the status bar to
990
make the <interface>News Feed Subscription</interface> window appear.
995
Choose the feeds you wan to subscribe to. You can also copy the feed
996
Loaction using the feed's context menu.
1001
Press <guibutton>Subscribe</guibutton> to
1002
subscribe the feeds.
1010
<sect1 id="epi-ext-pageinfo">
1011
<title>Page Info</title>
1013
<sect2 id="epi-ext-pageinfo-intro">
1014
<title>Introduccion</title>
1016
<para>The Page Info extension provides detailed information about the web
1017
pages you visit.</para>
1020
<sect2 id="epi-ext-pageinfo-usage">
1021
<title>Using Page Info</title>
1023
<para>To access the page information choose
1024
<menuchoice><guimenu>View</guimenu><guimenuitem>Page
1025
Information</guimenuitem></menuchoice>; a new window appears, letting
1029
<term><guilabel>General</guilabel></term>
1030
<listitem><para>Provides various information on the page and
1031
the website</para></listitem>
1034
<term><guilabel>Media</guilabel></term>
1035
<listitem><para>displays media files (pictures, sounds,...)
1036
used on the page.</para></listitem>
1039
<term><guilabel>Ligams</guilabel></term>
1040
<listitem><para>Provides all the links of the web page.</para></listitem>
1043
<term><guilabel>Formularis</guilabel></term>
1044
<listitem><para>All the forms available in the page are
1045
displayed.</para></listitem>
1048
<term><guilabel>Metadata</guilabel></term>
1049
<listitem><para>Displays all the information entered by
1050
the webmaster about the site.</para></listitem>
1057
<sect1 id="epi-ext-pushscroll">
1058
<title>Push Scroll</title>
1060
<sect2 id="epi-ext-pushscroll-intro">
1061
<title>Introduccion</title>
1063
<para>The Push Scroll extension provides scroll function while the
1064
middle mouse button is pressed.</para>
1067
<sect2 id="epi-ext-pushscroll-usage">
1068
<title>Using Push Scroll</title>
1070
<para>To use Push Scroll, simply press the middle mouse button, and
1071
move your mouse in any direction, the page will scroll.</para>
1075
<sect1 id="epi-ext-pythonconsole">
1076
<title>Python Console</title>
1078
<sect2 id="epi-ext-pythonconsole-intro">
1079
<title>Introduccion</title>
1081
<para>Opens an interactive Python console, and allows to modify
1082
<application>Epiphany</application> through Python.</para>
1085
<sect2 id="epi-ext-pythonconsole-usage">
1086
<title>Using Python Console</title>
1088
<para>To display the Python Console, choose
1089
<menuchoice><guimenu>Tools</guimenu><guimenuitem>Python Console</guimenuitem></menuchoice>.
1094
<sect1 id="epi-ext-style">
1095
<title>Select Stylesheet</title>
1097
<sect2 id="epi-ext-style-intro">
1098
<title>Introduccion</title>
1100
<para>The Select Stylesheet extension lets you
1101
switch between the stylesheets of a web page. You can also
1102
disable the stylesheets when you browsing a page.</para>
1105
<sect2 id="epi-ext-style-usage">
1106
<title>Using Select Stylesheet</title>
1108
<para>To change the style sheet of the website you visit, choose
1109
<menuchoice><guimenu>View</guimenu><guimenuitem>Style</guimenuitem></menuchoice>
1110
, then choose a style sheet from those available.</para>
1111
<para>If you choose the style sheet <guilabel>none</guilabel> the
1112
website will not use any style sheet.</para>
1116
<sect1 id="epi-ext-sidebar">
1117
<title>Sidebar</title>
1119
<sect2 id="epi-ext-sidebar-intro">
1120
<title>Introduccion</title>
1122
<para>The Sidebar extension adds a small window on the left side of the
1123
<application>Epiphany</application> window. Sidebar allows to display website content and can provide quick
1124
access to their information.</para>
1127
<sect2 id="epi-ext-sidebar-usage">
1128
<title>Using Sidebar</title>
1131
<title><application>Epiphany</application> with a Sidebar displayed</title>
1132
<graphic fileref="figures/epi-ext-sidebar.png"/>
1135
<sect3 id="epi-ext-sidebar-usage-display">
1136
<title>Display Sidebar</title>
1138
<para>By default, the Sidebar is not displayed; to display the
1139
Sidebar, choose menu
1140
<menuchoice><guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem></menuchoice>.</para>
1141
<tip><para>You can also toggle the visibility of Sidebar by pressing
1142
<keycap>F9</keycap>.</para></tip>
1145
<sect3 id="epi-ext-sidebar-usage-add">
1146
<title>Add a Sidebar</title>
1148
<para>To add a Sidebar, activate the Sidebar extension, then
1149
click on the link that the website provides to install the sidebar.
1150
A window requests to add the document to the Sidebar,
1151
click <guibutton>Add a Sidebar</guibutton>, the sidebar document
1152
is added to the Sidebar.</para>
1153
<para>You can find a list of websites that provide sidebar on <ulink url="http://dmoz.org/Netscape/Sidebar/">DMOZ</ulink>.</para>
1156
<sect3 id="epi-ext-sidebar-usage-switch">
1157
<title>Switch between Sidebars</title>
1159
<para>When you have subscribed to several sidebars, to switch
1160
between them, select the Sidebar from the drop-box at the top of the
1164
<sect3 id="epi-ext-sidebar-usage-del">
1165
<title>Delete a Sidebar</title>
1167
<para>To delete a Sidebar which you have added, display the
1168
sidebar to delete and press the trash icon.</para>
1173
<sect1 id="epi-ext-smart">
1174
<title>Smart Bookmarks</title>
1176
<sect2 id="epi-ext-smart-intro">
1177
<title>Introduccion</title>
1179
<para>The Smart Bookmarks extension is an extension that enable to
1180
look up selected text with a smart bookmark.</para>
1183
<sect2 id="epi-ext-smart-usage">
1184
<title>Using Smart Bookmarks</title>
1186
<para>To create a smart bookmark, see the appropriate <ulink type="help" url="ghelp:epiphany#smart-bookmarks-create-a-smartbookmark">
1187
section</ulink> in the <application>Epiphany</application> manual.</para>
1188
<para>To look up text, select the text in a web page and
1189
choose <guimenuitem>look-up</guimenuitem> and the smart
1190
bookmark from the context menu. A web browser will be opened with the result
1191
of the look-up.</para>
1195
<sect1 id="epi-ext-tabgroups">
1196
<title>Tab Groups</title>
1198
<sect2 id="epi-ext-tabgroups-intro">
1199
<title>Introduccion</title>
1201
<para>The Tab Groups extension makes new tabs appear after the current
1205
<sect2 id="epi-ext-tabgroups-usage">
1206
<title>Using Tab Groups</title>
1208
<para>Once this extension is enabled, it changes the normal behaviour
1209
(where new tabs are created after the last tab) to a new one. When you open
1210
a new tab, it will be created after the current tab.</para>
1213
<title>A new tab created after the first tab</title>
1214
<graphic fileref="figures/epi-ext-tabgroups.png"/>
1219
<sect1 id="epi-ext-tabstates">
1220
<title>Tab States</title>
1222
<sect2 id="epi-ext-tabstates-intro">
1223
<title>Introduccion</title>
1225
<para>The Tab States extension changes the status of the tab label to
1226
signal the content has changed.</para>
1229
<sect2 id="epi-ext-tabstates-usage">
1230
<title>Using Tab States</title>
1232
<para>Once this extension is enabled, when the content of a page in
1233
a tab changes, the tab label will become bold, to notify you that the
1234
page has changed.</para>
1238
<!-- The tabsmenu extension is currently broken. -->
1240
<sect1 id="epi-ext-tabsmenu">
1241
<title>Tabsmenu</title>
1243
<sect2 id="epi-ext-tabsmenu-intro">
1244
<title>Introduction</title>
1246
<para>The Tabsmenu extension allows to move tabs between &app; windows.</para>
1249
<sect2 id="epi-ext-tabsmenu-usage">
1250
<title>Using Tab States</title>
1252
<para>To use this extension you must open at least 2 &app;
1254
<para>To move a tab to another window, display the tab in its in
1256
<menuchoice><guimenu>Tabs</guimenu><guisubmenu>Move Tab to
1257
Window</guisubmenu><guimenuitem>Window
1258
name</guimenuitem></menuchoice>. The tab is moved to the selected
1261
<tip><para>You can also move tabs between window from the
1262
context menu on the tabs.</para></tip>
1267
<sect1 id="epi-ext-about">
1268
<title>A prepaus d'<application>Epiphany Extensions</application></title>
1271
<application>Epiphany Extensions</application> were written by
1273
<listitem><para>Samuel Abels (<email>spam2@debain.org</email>)</para></listitem>
1274
<listitem><para>Crispin Flowerday
1275
(<email>gnome@flowerday.cx</email>)</para></listitem>
1276
<listitem><para>Adam Hooper (<email>adamh@cvs.gnome.org</email>)</para></listitem>
1277
<listitem><para>Mathias Hasselmann (<email>mathias@taschenorakel.de</email>)</para></listitem>
1278
<listitem><para>James Henstridge
1279
(<email>james@daa.com.au</email>)</para></listitem>
1280
<listitem><para>Jean-Yves Lefort (<email>jylefort@brutele.be</email>)</para></listitem>
1281
<listitem><para>Christian Persch (<email>chpe@gnome.org</email>)</para></listitem>
1282
<listitem><para>Raphaël Slinckx (<email>raphael@slinckx.net</email>)</para></listitem>
1283
<listitem><para>Justin Wake (<email>jwake@iinet.net.au</email>)</para></listitem>
1287
This manual was written by Baptiste Mille-Mathias
1288
<email>baptiste.millemathias@gmail.com</email>.
1292
This program is distributed under the terms of the GNU
1293
General Public license as published by the Free Software
1294
Foundation; either version 2 of the License, or (at your option)
1295
any later version. A copy of this license can be found at this
1296
<ulink url="ghelp:gpl" type="help">link</ulink>, or in the file
1297
COPYING included with the source code of this program.