~ubuntu-branches/ubuntu/hardy/epiphany-extensions/hardy-updates

« back to all changes in this revision

Viewing changes to help/oc/epiphany-extensions.xml

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2008-02-11 12:07:10 UTC
  • mfrom: (1.1.25 upstream)
  • Revision ID: james.westby@ubuntu.com-20080211120710-mene00j2jh4ddwnz
Tags: 2.20.1svn20080211-0ubuntu1
* New SVN snapshot:
  - work with the hardy epiphany-browser version (lp: #178117)
* debian/control.in:
  - build using xulrunner
  - updated epiphany-browser requirement
* debian/patches/ephy-extensions.xul.1.9.patch:
  - patch from Alexander Sack to build using xulrunner1.9
* debian/patches/delicious.diff:
  - dropped, the change is in the svn version
* debian/rules:
  - build using libxul
  - updated installation directory

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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. -->]>
 
16
<!-- 
 
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
 
22
-->
 
23
<!-- =============Document Header ============================= -->
 
24
<article id="index" lang="oc">
 
25
<!-- please do not change the id; for translations, change lang to -->
 
26
<!-- appropriate code -->
 
27
  <articleinfo>
 
28
    <abstract role="description">
 
29
      <para>Various extensions for Epiphany Web browser.</para>
 
30
    </abstract>
 
31
    <title>Epiphany Extensions Manual</title>       
 
32
 
 
33
    <copyright>
 
34
      <year>2006</year>
 
35
      <holder>Baptiste Mille-Mathias</holder>
 
36
    </copyright>
 
37
    <copyright>
 
38
      <year>2006</year>
 
39
      <holder>Victor Osadci</holder>
 
40
    </copyright>
 
41
<!-- translators: uncomment this:
 
42
 
 
43
  <copyright>
 
44
   <year>2002</year>
 
45
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
 
46
  </copyright>
 
47
 
 
48
   -->
 
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 
 
51
     document.  -->
 
52
    <publisher role="maintainer"> 
 
53
      <publishername>Projècte de documentacion de GNOME</publishername> 
 
54
    </publisher> 
 
55
 
 
56
      <legalnotice id="legalnotice">
 
57
         <para>
 
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.
 
65
          </para>
 
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.
 
71
         </para>
 
72
 
 
73
         <para>
 
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
 
79
           capital letters.
 
80
         </para>
 
81
 
 
82
         <para>
 
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:
 
86
 
 
87
           <orderedlist>
 
88
                 <listitem>
 
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
 
106
                   </para>
 
107
                 </listitem>
 
108
                 <listitem>
 
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.
 
125
                   </para>
 
126
                 </listitem>
 
127
           </orderedlist>
 
128
         </para>
 
129
   </legalnotice>
 
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. -->
 
133
 
 
134
    <authorgroup> 
 
135
      <author> 
 
136
        <firstname>Baptiste</firstname> 
 
137
        <surname>Mille-Mathias</surname> 
 
138
        <affiliation> 
 
139
          <orgname>Projècte de documentacion de GNOME</orgname> 
 
140
          <address><email>baptiste.millemathias@gmail.com</email></address> 
 
141
        </affiliation> 
 
142
      </author>
 
143
          <author> 
 
144
        <firstname>Victor</firstname> 
 
145
        <surname>Osadci</surname> 
 
146
        <affiliation> 
 
147
          <orgname>Projècte de documentacion de GNOME</orgname> 
 
148
          <address><email>Victor.Osadci.GNOME@xhtml.md</email></address> 
 
149
        </affiliation> 
 
150
          </author> 
 
151
    </authorgroup>
 
152
 
 
153
    <revhistory>
 
154
      <revision>
 
155
        <revnumber>1.0</revnumber>
 
156
        <date>03/2006</date>
 
157
      </revision>
 
158
    </revhistory>
 
159
 
 
160
    <releaseinfo>
 
161
      This manual describes version 2.14 of Epiphany.
 
162
    </releaseinfo>
 
163
  </articleinfo>
 
164
 
 
165
  <indexterm zone="index"> 
 
166
    <primary>Epiphany-Extensions</primary> 
 
167
  </indexterm> 
 
168
  <indexterm zone="index"> 
 
169
    <primary>epiphany-extensions</primary> 
 
170
  </indexterm>
 
171
  <indexterm zone="index"> 
 
172
    <primary>extension</primary> 
 
173
  </indexterm>
 
174
  <indexterm zone="index"> 
 
175
    <primary>Navegador</primary> 
 
176
  </indexterm>
 
177
 
 
178
<!-- ============= Document Body ================================== -->
 
179
        
 
180
        <sect1 id="epi-ext-intro">
 
181
                <title>Introduccion</title>
 
182
 
 
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
 
185
                existing.</para>
 
186
        </sect1>        
 
187
 
 
188
        <sect1 id="epi-ext-manager">
 
189
                <title>Extensions Manager</title>
 
190
 
 
191
                <sect2 id="epi-ext-manager-intro">
 
192
                        <title>Introduccion</title>
 
193
                        <para>The Extension Manager is the tool that lets you activate Epiphany
 
194
                        Extensions.</para>
 
195
                </sect2>
 
196
 
 
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>
 
203
                </sect2>
 
204
        </sect1>
 
205
 
 
206
        <sect1 id="epi-ext-actions">
 
207
                <title>Accions</title>  
 
208
 
 
209
                <sect2 id="epi-ext-actions-intro">
 
210
                        <title>Introduccion</title>
 
211
        
 
212
                        <para>The Actions extension allows you to create specific actions in the
 
213
                        context menu, for images, pages or both.</para>
 
214
                </sect2>
 
215
 
 
216
                <sect2 id="epi-ext-action-manage">
 
217
                        <title>Manage Actions</title>
 
218
 
 
219
                        <sect3 id="epi-ext-action-manage-create">
 
220
                                <title>Create Actions</title>
 
221
                        
 
222
                                <para>To create an action, perform the following steps:
 
223
                                        <orderedlist>
 
224
                                                <listitem>
 
225
                                                        <para>Choose <menuchoice><guimenu>Edit</guimenu>
 
226
                                                        <guimenuitem>Actions</guimenuitem></menuchoice>
 
227
                                                        to open the Actions manager</para>
 
228
                                                </listitem>
 
229
                                                <listitem>
 
230
                                                        <para>Press <guibutton>Add</guibutton> to add a
 
231
                                                        new action
 
232
                                                        </para>
 
233
                                                </listitem>
 
234
                                                <listitem>
 
235
                                                        <para>In the "Add Action" window, 
 
236
                                                                <itemizedlist>
 
237
                                                                        <listitem>
 
238
                                                                                <para>Enter the <guilabel>Name</guilabel> of the action. The name
 
239
                                                                                will be displayed in the context menu</para>
 
240
                                                                        </listitem>
 
241
                                                                        <listitem>
 
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
 
245
                                                                                Manager</para>
 
246
                                                                        </listitem>
 
247
                                                                        <listitem>
 
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>
 
253
                                                                        </listitem>
 
254
                                                                        <listitem>
 
255
                                                                                <para>Select <guilabel>Pages</guilabel> or
 
256
                                                                                <guilabel>Images</guilabel> to choose on
 
257
                                                                                which elements the action will appear</para>
 
258
                                                                        </listitem>
 
259
                                                                        <listitem>
 
260
                                                                                <para>Press <guibutton>Add</guibutton></para>
 
261
                                                                        </listitem>
 
262
                                                                </itemizedlist>
 
263
                                                        </para>
 
264
                                                </listitem>
 
265
                                                <listitem>
 
266
                                                        <para>Press <guibutton>Close</guibutton> to close the Actions Manager</para>
 
267
                                                </listitem>
 
268
                                        </orderedlist>
 
269
                                </para>
 
270
                                <figure><title>An example of action</title>
 
271
                                <graphic fileref="figures/epi-ext-action-create.png"/>
 
272
                                </figure>
 
273
                        </sect3>
 
274
                        
 
275
                        <sect3 id="epi-ext-action-manage-edit">
 
276
                                <title>Edit Actions</title>
 
277
                        
 
278
                                <para>To edit an action, follow these steps:
 
279
                                        <orderedlist>
 
280
                                                <listitem>
 
281
                                                        <para>Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Actions</guimenuitem></menuchoice>
 
282
                                                        to open the Actions manager</para>
 
283
                                                </listitem>
 
284
                                                <listitem>
 
285
                                                        <para>
 
286
                                                                Select the action to edit
 
287
                                                        </para>
 
288
                                                </listitem>
 
289
                                                <listitem>
 
290
                                                        <para>Press <guibutton>Edit</guibutton> 
 
291
                                                        </para>
 
292
                                                </listitem>
 
293
                                                <listitem>
 
294
                                                        <para>Edit the action as described in <xref linkend="epi-ext-action-manage-create"/>
 
295
                                                        </para>
 
296
                                                </listitem>
 
297
                                        </orderedlist>
 
298
                                </para>
 
299
                        </sect3>
 
300
                        
 
301
                        <sect3 id="epi-ext-action-manage-del">
 
302
                                <title>Delete Actions</title>
 
303
                        
 
304
                                <para>To delete an action, do the following:
 
305
                                        <orderedlist>
 
306
                                                <listitem>
 
307
                                                        <para>Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Actions</guimenuitem></menuchoice>
 
308
                                                        to open the Actions manager</para>
 
309
                                                </listitem>
 
310
                                                <listitem>
 
311
                                                        <para>
 
312
                                                                Select the action to delete
 
313
                                                        </para>
 
314
                                                </listitem>
 
315
                                                <listitem>
 
316
                                                        <para>Press <guibutton>Remove</guibutton> 
 
317
                                                        </para>
 
318
                                                </listitem>
 
319
                                                <listitem>
 
320
                                                        <para>Press <guibutton>Close</guibutton> to close the Actions Manager</para>
 
321
                                                </listitem>
 
322
                                        </orderedlist>
 
323
                                </para>
 
324
                        </sect3>
 
325
                </sect2>
 
326
 
 
327
                <sect2 id="epi-ext-actions-usage">
 
328
                        <title>Using Actions</title>
 
329
 
 
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"/>
 
334
                        </figure>
 
335
                </sect2>
 
336
 
 
337
        </sect1>
 
338
        
 
339
        <sect1 id="epi-ext-adblocker">
 
340
                <title>Ad Blocker</title>
 
341
                
 
342
                <sect2 id="epi-ext-adblocker-intro">
 
343
                        <title>Introduccion</title>
 
344
                        
 
345
                        <para>The Ad Blocker extension lets you block ad banners on websites.
 
346
                        It avoids downloading them, saving time and bandwidth.</para>
 
347
                </sect2>
 
348
 
 
349
                <sect2 id="epi-ext-adblocker-usage">
 
350
                        <title>Using Ad Blocker</title>
 
351
                        
 
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"/>
 
362
                        </figure>
 
363
                        </para>
 
364
                </sect2>
 
365
 
 
366
                <sect2 id="epi-ext-adblocker-usage-extend">
 
367
                                <title>Extend Ad Blocker</title>
 
368
 
 
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
 
372
                                match your needs.
 
373
                                </para>
 
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. 
 
379
                                </para>
 
380
 
 
381
                                <sect3 id="epi-ext-adblocker-usage-extend-blacklist">
 
382
                                        <title>Add a deny rule</title>
 
383
 
 
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>.
 
389
                                        </para>
 
390
                                </sect3>
 
391
 
 
392
                                <sect3 id="epi-ext-adblocker-usage-extend-whitelist">
 
393
                                        <title>Add a permit rule</title>
 
394
 
 
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>.
 
400
                                        </para>
 
401
                                </sect3>
 
402
                </sect2>
 
403
        </sect1>
 
404
        
 
405
        <sect1 id="epi-ext-autoreloadtab">
 
406
                <title>Auto Reload Tab</title>  
 
407
 
 
408
                <sect2 id="epi-ext-autoreloadtab-intro">
 
409
                        <title>Introduccion</title>
 
410
        
 
411
                        <para>The Auto Reload Tab extension allows you to regularly reload a page 
 
412
                        in a tab.</para>
 
413
                </sect2>
 
414
 
 
415
                <sect2 id="epi-ext-autoreloadtab-usage">
 
416
                        <title>Using Auto Reload Tab</title>
 
417
 
 
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>
 
423
 
 
424
                        <note>
 
425
                          <title>Auto reload local files</title>
 
426
                          <para>
 
427
                                When a local file is opened, <application>Epiphany</application> will monitor it and reload the file when it changes.
 
428
                          </para>
 
429
                        </note>
 
430
                        
 
431
                </sect2>
 
432
        </sect1>
 
433
 
 
434
        <sect1 id="epi-ext-autoscroll">
 
435
                <title>AutoScroll</title>       
 
436
 
 
437
                <sect2 id="epi-ext-autoscroll-intro">
 
438
                        <title>Introduccion</title>
 
439
        
 
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>
 
443
                </sect2>
 
444
 
 
445
                <sect2 id="epi-ext-autoscroll-usage">
 
446
                        <title>Using Auto Scroll</title>
 
447
 
 
448
                        <para>To start to auto scroll on a page,
 
449
                                <orderedlist>
 
450
                                        <listitem>
 
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>
 
454
                                        </listitem>
 
455
                                        <listitem>
 
456
                                                <para>Move the cursor in the direction to scroll. 
 
457
                                                The page will start to scroll in that direction.</para>
 
458
                                        </listitem>
 
459
                                </orderedlist>
 
460
                        </para>
 
461
                </sect2>
 
462
        </sect1>
 
463
 
 
464
        <sect1 id="epi-ext-certificates">
 
465
                <title>Certificats</title>
 
466
                
 
467
                <sect2 id="epi-ext-certificates-intro">
 
468
                        <title>Introduccion</title>
 
469
                        
 
470
                        <para>The Certificates extension gives access to the certificates stored
 
471
                        by <application>Epiphany</application>, in order to view or manage them.</para>
 
472
                </sect2>
 
473
 
 
474
                <sect2 id="epi-ext-certificates-usage">
 
475
                        <title>Using Certificates</title>
 
476
                        
 
477
                        <sect3 id="epi-ext-certificates-usage-view">
 
478
                                <title>View website certificate</title>
 
479
                        
 
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>
 
485
                        </sect3>
 
486
 
 
487
                        <sect3 id="epi-ext-certificates-usage-manage">
 
488
                                <title>Manage Certificates</title>
 
489
                        
 
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
 
495
                                tabs:
 
496
                                        <variablelist>
 
497
                                                <varlistentry>
 
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>
 
502
                                                </varlistentry>
 
503
                                        </variablelist>
 
504
                                        <variablelist>
 
505
                                                <varlistentry>
 
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>
 
509
                                                </varlistentry>
 
510
                                                <varlistentry>
 
511
                                                        <term><guilabel>Sits web</guilabel></term>
 
512
                                                        <listitem><para>To import, view, edit and delete
 
513
                                                        certificates from website you visited.</para></listitem>
 
514
                                                </varlistentry>
 
515
                                                <varlistentry>
 
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>
 
521
                                                </varlistentry>
 
522
                                        </variablelist>
 
523
                                </para>
 
524
                        </sect3>
 
525
 
 
526
                        <sect3 id="epi-ext-certificates-usage-manage-devices">
 
527
                                <title>Manage Security Devices</title>
 
528
                        
 
529
                                <para>Security Devices are used encrypt and decrypt connections
 
530
                                and can store certificates and passwords.</para>
 
531
                        </sect3>
 
532
                </sect2>
 
533
        </sect1>
 
534
        
 
535
        <sect1 id="epi-ext-errorviewer">
 
536
                <title>Error Viewer</title>     
 
537
 
 
538
                <sect2 id="epi-ext-errorviewer-intro">
 
539
                        <title>Introduccion</title>
 
540
        
 
541
                        <para>The Error Viewer extension allows you to view errors in web pages,
 
542
                        validate web pages and check links.</para>
 
543
                </sect2>
 
544
 
 
545
                <sect2 id="epi-ext-errorviewer-usage">
 
546
                        <title>Using Error Viewer</title>
 
547
 
 
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
 
550
                        functions:
 
551
                                <variablelist>
 
552
                                        <varlistentry>
 
553
                                                <term><guilabel>Links Checker</guilabel></term>
 
554
                                                <listitem><para>Detects dead links on a site</para></listitem>
 
555
                                        </varlistentry>
 
556
                                        <varlistentry>
 
557
                                                <term><guilabel>HTML Code Checker</guilabel></term>
 
558
                                                <listitem><para>Checks the validity of the source code.</para></listitem>
 
559
                                        </varlistentry>
 
560
                                        <varlistentry>
 
561
                                                <term><guilabel>Error Viewer</guilabel></term>
 
562
                                                <listitem><para>Displays various errors of a
 
563
                                                webpage (like javascript, ...)</para></listitem>
 
564
                                        </varlistentry>
 
565
                                </variablelist>
 
566
                        </para>
 
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>
 
579
                </sect2>
 
580
        </sect1>
 
581
        
 
582
        <sect1 id="epi-ext-favicon">
 
583
                <title>Favicon Fallback</title>
 
584
 
 
585
                <sect2 id="epi-ext-favicon-intro">
 
586
                        <title>Introduccion</title>
 
587
                
 
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>
 
590
                </sect2>
 
591
 
 
592
                <sect2 id="epi-ext-favicon-usage">
 
593
                        <title>Using Favicon</title>
 
594
 
 
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>
 
598
                </sect2>
 
599
        </sect1>
 
600
 
 
601
        <sect1 id="epi-ext-gestures">
 
602
                <title>Gestures</title>
 
603
                
 
604
                <sect2 id="epi-ext-gestures-intro">
 
605
                        <title>Introduccion</title>
 
606
        
 
607
                        <para>The Gestures allows you to quickly perform actions in <application>Epiphany</application> by drawing
 
608
                        a shape with the mouse.</para>
 
609
                </sect2>
 
610
 
 
611
                <sect2 id="epi-ext-gestures-usage">
 
612
                        <title>Using Gestures</title>
 
613
 
 
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.
 
617
                        </para>
 
618
 
 
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"/>
 
625
                                        <thead>
 
626
                                                <row rowsep="1">
 
627
                                                        <entry valign="top">Accion</entry>
 
628
                                                        <entry valign="top">Gesture</entry>
 
629
                                                        <entry valign="top">Exemple</entry>
 
630
                                                </row>
 
631
                                        </thead>
 
632
                                        <tbody>
 
633
                                                <row>
 
634
                                                        <entry valign="top">Go back in history</entry>
 
635
                                                        <entry valign="top">Esquèrra</entry>
 
636
                                                        <entry valign="top">
 
637
                                                                <mediaobject>
 
638
                                                                        <imageobject>
 
639
                                                                                <imagedata fileref="figures/epi-ext-gestures-back.png" format="PNG"/>
 
640
                                                                        </imageobject>
 
641
                                                                </mediaobject>
 
642
                                                        </entry>
 
643
                                                </row>
 
644
                                                <row>
 
645
                                                        <entry valign="top">Go forward in history</entry>
 
646
                                                        <entry valign="top">Drecha</entry>
 
647
                                                        <entry valign="top">
 
648
                                                                <mediaobject>
 
649
                                                                        <imageobject>
 
650
                                                                                <imagedata fileref="figures/epi-ext-gestures-forward.png" format="PNG"/>
 
651
                                                                        </imageobject>
 
652
                                                                </mediaobject>
 
653
                                                        </entry>
 
654
                                                </row>
 
655
                                                <row>
 
656
                                                        <entry valign="top">Go up in a directory</entry>
 
657
                                                        <entry valign="top">Up - Left - Up</entry>
 
658
                                                        <entry valign="top">
 
659
                                                                <mediaobject>
 
660
                                                                        <imageobject>
 
661
                                                                                <imagedata fileref="figures/epi-ext-gestures-up.png" format="PNG"/>
 
662
                                                                        </imageobject>
 
663
                                                                </mediaobject>
 
664
                                                        </entry>
 
665
                                                </row>
 
666
                                                <row>
 
667
                                                        <entry valign="top">Go to your home page</entry>
 
668
                                                        <entry valign="top">Up - Left - Down</entry>
 
669
                                                        <entry valign="top">
 
670
                                                                <mediaobject>
 
671
                                                                        <imageobject>
 
672
                                                                                <imagedata fileref="figures/epi-ext-gestures-homepage.png" format="PNG"/>
 
673
                                                                        </imageobject>
 
674
                                                                </mediaobject>
 
675
                                                        </entry>
 
676
                                                </row>
 
677
                                                <row>
 
678
                                                        <entry valign="top">Reload the page</entry>
 
679
                                                        <entry valign="top">Up - Down</entry>
 
680
                                                        <entry valign="top">
 
681
                                                                <mediaobject>
 
682
                                                                        <imageobject>
 
683
                                                                                <imagedata fileref="figures/epi-ext-gestures-reload.png" format="PNG"/>
 
684
                                                                        </imageobject>
 
685
                                                                </mediaobject>
 
686
                                                        </entry>
 
687
                                                </row>
 
688
                                                <row>
 
689
                                                        <entry valign="top">Stop loading the page</entry>
 
690
                                                        <entry valign="top">Left - Up</entry>
 
691
                                                        <entry valign="top">
 
692
                                                                <mediaobject>
 
693
                                                                        <imageobject>
 
694
                                                                                <imagedata fileref="figures/epi-ext-gestures-stop.png" format="PNG"/>
 
695
                                                                        </imageobject>
 
696
                                                                </mediaobject>
 
697
                                                        </entry>
 
698
                                                </row>
 
699
                                                <row>
 
700
                                                        <entry valign="top">Dobrir una novèla fenèstra</entry>
 
701
                                                        <entry valign="top">Amont</entry>
 
702
                                                        <entry valign="top">
 
703
                                                                <mediaobject>
 
704
                                                                        <imageobject>
 
705
                                                                                <imagedata fileref="figures/epi-ext-gestures-new-window.png" format="PNG"/>
 
706
                                                                        </imageobject>
 
707
                                                                </mediaobject>
 
708
                                                        </entry>
 
709
                                                </row>
 
710
                                                <row>
 
711
                                                        <entry valign="top">Open a new tab</entry>
 
712
                                                        <entry valign="top">Aval</entry>
 
713
                                                        <entry valign="top">
 
714
                                                                <mediaobject>
 
715
                                                                        <imageobject>
 
716
                                                                                <imagedata fileref="figures/epi-ext-gestures-new-tab.png" format="PNG"/>
 
717
                                                                        </imageobject>
 
718
                                                                </mediaobject>
 
719
                                                        </entry>
 
720
                                                </row>
 
721
                                                <row>
 
722
                                                        <entry valign="top">Close a tab/window</entry>
 
723
                                                        <entry valign="top">Right - Left - Right</entry>
 
724
                                                        <entry valign="top">
 
725
                                                                <mediaobject>
 
726
                                                                        <imageobject>
 
727
                                                                                <imagedata fileref="figures/epi-ext-gestures-close.png" format="PNG"/>
 
728
                                                                        </imageobject>
 
729
                                                                </mediaobject>
 
730
                                                        </entry>
 
731
                                                </row>
 
732
                                                <row>
 
733
                                                        <entry valign="top">Close a tab /window (second gesture)</entry>
 
734
                                                        <entry valign="top">Down - Right</entry>
 
735
                                                        <entry valign="top">
 
736
                                                                <mediaobject>
 
737
                                                                        <imageobject>
 
738
                                                                                <imagedata fileref="figures/epi-ext-gestures-close-2.png" format="PNG"/>
 
739
                                                                        </imageobject>
 
740
                                                                </mediaobject>
 
741
                                                        </entry>
 
742
                                                </row>
 
743
                                                <row>
 
744
                                                        <entry valign="top">Toggle full-screen mode</entry>
 
745
                                                        <entry valign="top">Down - Left</entry>
 
746
                                                        <entry valign="top">
 
747
                                                                <mediaobject>
 
748
                                                                        <imageobject>
 
749
                                                                                <imagedata fileref="figures/epi-ext-gestures-fullscreen.png" format="PNG"/>
 
750
                                                                        </imageobject>
 
751
                                                                </mediaobject>
 
752
                                                        </entry>
 
753
                                                </row>
 
754
                                                <row>
 
755
                                                        <entry valign="top">Go to the next tab</entry>
 
756
                                                        <entry valign="top">Up - Right</entry>
 
757
                                                        <entry valign="top">
 
758
                                                                <mediaobject>
 
759
                                                                        <imageobject>
 
760
                                                                                <imagedata fileref="figures/epi-ext-gestures-next-tab.png" format="PNG"/>
 
761
                                                                        </imageobject>
 
762
                                                                </mediaobject>
 
763
                                                        </entry>
 
764
                                                </row>
 
765
                                                <row>
 
766
                                                        <entry valign="top">Go to the previous tab</entry>
 
767
                                                        <entry valign="top">Up - Left</entry>
 
768
                                                        <entry valign="top">
 
769
                                                                <mediaobject>
 
770
                                                                        <imageobject>
 
771
                                                                                <imagedata fileref="figures/epi-ext-gestures-prev-tab.png" format="PNG"/>
 
772
                                                                        </imageobject>
 
773
                                                                </mediaobject>
 
774
                                                        </entry>
 
775
                                                </row>
 
776
                                                <row>
 
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>
 
780
                                                        <entry valign="top">
 
781
                                                                <mediaobject>
 
782
                                                                        <imageobject>
 
783
                                                                                <imagedata fileref="figures/epi-ext-gestures-view-source.png" format="PNG"/>
 
784
                                                                        </imageobject>
 
785
                                                                </mediaobject>
 
786
                                                        </entry>
 
787
                                                </row>
 
788
                                                <row>
 
789
                                                        <entry valign="top">View the page source (Second gesture)</entry>
 
790
                                                        <entry valign="top">Up - Right - Down</entry>
 
791
                                                        <entry valign="top">
 
792
                                                                <mediaobject>
 
793
                                                                        <imageobject>
 
794
                                                                                <imagedata fileref="figures/epi-ext-gestures-view-source-2.png" format="PNG"/>
 
795
                                                                        </imageobject>
 
796
                                                                </mediaobject>
 
797
                                                        </entry>
 
798
                                                </row>
 
799
                                        </tbody>
 
800
                                </tgroup>
 
801
                        </table>
 
802
                </sect2>
 
803
 
 
804
                <sect2 id="epi-ext-gestures-create">
 
805
                        <title>Create gestures</title>
 
806
                                
 
807
                        <para>The Gestures extension lets you create your own gesture patterns, and so let you
 
808
                        extend the set provided by default.</para>
 
809
 
 
810
                        <sect3 id="epi-ext-gestures-create-how">
 
811
                                <title>Understand how gesture works</title>
 
812
 
 
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
 
816
                                the system.</para>
 
817
                                
 
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
 
820
                                action.
 
821
                                <example>
 
822
                                        <title>A Gesture Example</title>
 
823
                                        <programlisting>
 
824
<![CDATA[<!-- down-left -->
 
825
<gesture>
 
826
        <sequence>36987</sequence>
 
827
        <sequence>3687</sequence>
 
828
        <action>/menubar/ViewMenu/ViewFullscreenMenu</action>
 
829
</gesture>]]></programlisting>
 
830
                                </example>
 
831
                                </para>
 
832
                        </sect3>
 
833
 
 
834
                        <sect3 id="epi-ext-gestures-create-why">
 
835
                                <title>Create new gesture</title>
 
836
 
 
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>
 
840
 
 
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>
 
844
                                
 
845
                                <para>Open the newly created file with a text editor and add the following
 
846
                                content:
 
847
                                <programlisting>
 
848
<![CDATA[<?xml version="1.0"?>
 
849
<epiphany_gestures version="0.4">
 
850
        <gesture>
 
851
                <sequence></sequence>
 
852
                <action></action>
 
853
        </gesture>
 
854
</epiphany_gestures>]]></programlisting>
 
855
                                </para>
 
856
                                
 
857
                                <sect4 id="epi-ext-gestures-create-seq">
 
858
                                        <title>Define the gesture movement</title>
 
859
                                        
 
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
 
865
                                        hand corner).</para>
 
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>
 
868
                                <programlisting>
 
869
<![CDATA[<?xml version="1.0"?>
 
870
<epiphany_gestures version="0.4">
 
871
        <gesture>
 
872
                <sequence>74123654</sequence>
 
873
                <action></action>
 
874
        </gesture>
 
875
</epiphany_gestures>]]></programlisting>
 
876
                                </sect4>
 
877
 
 
878
                                <sect4 id="epi-ext-gestures-create-act">
 
879
                                        <title>Define the action</title>
 
880
                                        
 
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>
 
884
                                <programlisting>
 
885
<![CDATA[<?xml version="1.0"?>
 
886
<epiphany_gestures version="0.4">
 
887
        <gesture>
 
888
                <sequence>74123654</sequence>
 
889
                <action>/menubar/FileMenu/FilePrintMenu</action>
 
890
        </gesture>
 
891
</epiphany_gestures>]]></programlisting>
 
892
                                </sect4>
 
893
                        </sect3>
 
894
                </sect2>
 
895
        </sect1>
 
896
 
 
897
        <sect1 id="epi-ext-greasemonkey">
 
898
                <title>Greasemonkey</title>     
 
899
 
 
900
                <sect2 id="epi-ext-greasemonkey-intro">
 
901
                        <title>Introduccion</title>
 
902
        
 
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>
 
913
                </sect2>
 
914
 
 
915
                <sect2 id="epi-ext-greasemonkey-usage">
 
916
                        <title>Using Greasemonkey</title>
 
917
                        
 
918
                        <sect3 id="epi-ext-greasemonkey-usage-add">
 
919
                                <title>Install a Greasemonkey script</title>
 
920
                
 
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>
 
928
                        </sect3>
 
929
 
 
930
                        <sect3 id="epi-ext-greasemonkey-usage-del">
 
931
                                <title>Remove a Greasemonkey script</title>
 
932
 
 
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>
 
937
                        </sect3>
 
938
                </sect2>
 
939
        </sect1>
 
940
        
 
941
        <sect1 id="epi-ext-javaconsole">
 
942
                <title>Java Console</title>     
 
943
 
 
944
                <sect2 id="epi-ext-javaconsole-intro">
 
945
                        <title>Introduccion</title>
 
946
        
 
947
                        <para>Java Console extension provides access to the Java-Plugin
 
948
                        Console.</para>
 
949
                </sect2>
 
950
 
 
951
                <sect2 id="epi-ext-javaconsole-usage">
 
952
                        <title>Using Java Console</title>
 
953
 
 
954
                        <para>To display the Java Console, choose
 
955
                        <menuchoice><guimenu>Tools</guimenu><guimenuitem>Java
 
956
                        Console</guimenuitem></menuchoice>.</para>
 
957
                </sect2>
 
958
        </sect1>
 
959
 
 
960
        <sect1 id="epi-ext-newsfeedsubscription">
 
961
                <title>News Feed Subscription</title>   
 
962
 
 
963
                <sect2 id="epi-ext-newsfeedsubscription-intro">
 
964
                        <title>Introduccion</title>
 
965
        
 
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
 
968
                        feed readers are
 
969
                        <itemizedlist>
 
970
                                <listitem><para>Liferea</para></listitem>
 
971
                                <listitem><para>Straw</para></listitem>
 
972
                                <listitem><para>Blam</para></listitem>
 
973
                        </itemizedlist>
 
974
                        </para>
 
975
                </sect2>
 
976
 
 
977
                <sect2 id="epi-ext-newsfeedsubscription-usage">
 
978
                        <title>Using News Feed Subscription</title>
 
979
 
 
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: 
 
983
                                <orderedlist>
 
984
                                        <listitem>
 
985
                                                <para>
 
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.
 
991
                                                </para>
 
992
                                        </listitem>
 
993
                                        <listitem>
 
994
                                                <para>
 
995
                                                        Choose the feeds you wan to subscribe to. You can also copy the feed
 
996
                                                        Loaction using the feed's context menu.
 
997
                                                </para>
 
998
                                        </listitem>
 
999
                                        <listitem>
 
1000
                                                <para>
 
1001
                                                        Press <guibutton>Subscribe</guibutton> to
 
1002
                                                        subscribe the feeds.
 
1003
                                                </para>
 
1004
                                        </listitem>
 
1005
                                </orderedlist>
 
1006
                        </para>
 
1007
                </sect2>
 
1008
        </sect1>
 
1009
        
 
1010
        <sect1 id="epi-ext-pageinfo">
 
1011
                <title>Page Info</title>
 
1012
                
 
1013
                <sect2 id="epi-ext-pageinfo-intro">
 
1014
                        <title>Introduccion</title>
 
1015
                        
 
1016
                        <para>The Page Info extension provides detailed information about the web 
 
1017
                        pages you visit.</para>
 
1018
                </sect2>
 
1019
 
 
1020
                <sect2 id="epi-ext-pageinfo-usage">
 
1021
                        <title>Using Page Info</title>
 
1022
                        
 
1023
                        <para>To access the page information choose
 
1024
                        <menuchoice><guimenu>View</guimenu><guimenuitem>Page
 
1025
                        Information</guimenuitem></menuchoice>; a new window appears, letting
 
1026
                        you access 5 tabs:
 
1027
                                <variablelist>
 
1028
                                        <varlistentry>
 
1029
                                                <term><guilabel>General</guilabel></term>
 
1030
                                                <listitem><para>Provides various information on the page and
 
1031
                                        the website</para></listitem>
 
1032
                                        </varlistentry>
 
1033
                                        <varlistentry>
 
1034
                                                <term><guilabel>Media</guilabel></term>
 
1035
                                                <listitem><para>displays media files (pictures, sounds,...) 
 
1036
                                                used on the page.</para></listitem>
 
1037
                                        </varlistentry>
 
1038
                                        <varlistentry>
 
1039
                                                <term><guilabel>Ligams</guilabel></term>
 
1040
                                                <listitem><para>Provides all the links of the web page.</para></listitem>
 
1041
                                        </varlistentry>
 
1042
                                        <varlistentry>
 
1043
                                                <term><guilabel>Formularis</guilabel></term>
 
1044
                                                <listitem><para>All the forms available in the page are
 
1045
                                                displayed.</para></listitem>
 
1046
                                        </varlistentry>
 
1047
                                        <varlistentry>
 
1048
                                                <term><guilabel>Metadata</guilabel></term>
 
1049
                                                <listitem><para>Displays all the information entered by
 
1050
                                                the webmaster about the site.</para></listitem>
 
1051
                                        </varlistentry>
 
1052
                                </variablelist>
 
1053
                        </para>
 
1054
                </sect2>
 
1055
        </sect1>
 
1056
        
 
1057
        <sect1 id="epi-ext-pushscroll">
 
1058
                <title>Push Scroll</title>      
 
1059
 
 
1060
                <sect2 id="epi-ext-pushscroll-intro">
 
1061
                        <title>Introduccion</title>
 
1062
        
 
1063
                        <para>The Push Scroll extension provides scroll function while the
 
1064
                        middle mouse button is pressed.</para>
 
1065
                </sect2>
 
1066
 
 
1067
                <sect2 id="epi-ext-pushscroll-usage">
 
1068
                        <title>Using Push Scroll</title>
 
1069
 
 
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>
 
1072
                </sect2>
 
1073
        </sect1>
 
1074
        
 
1075
        <sect1 id="epi-ext-pythonconsole">
 
1076
                <title>Python Console</title>   
 
1077
 
 
1078
                <sect2 id="epi-ext-pythonconsole-intro">
 
1079
                        <title>Introduccion</title>
 
1080
        
 
1081
                        <para>Opens an interactive Python console, and allows to modify
 
1082
                        <application>Epiphany</application> through Python.</para>
 
1083
                </sect2>
 
1084
 
 
1085
                <sect2 id="epi-ext-pythonconsole-usage">
 
1086
                        <title>Using Python Console</title>
 
1087
 
 
1088
                        <para>To display the Python Console, choose
 
1089
                        <menuchoice><guimenu>Tools</guimenu><guimenuitem>Python Console</guimenuitem></menuchoice>.
 
1090
                        </para>
 
1091
                </sect2>
 
1092
        </sect1>
 
1093
        
 
1094
        <sect1 id="epi-ext-style">
 
1095
                <title>Select Stylesheet</title>
 
1096
                
 
1097
                <sect2 id="epi-ext-style-intro">
 
1098
                        <title>Introduccion</title>
 
1099
                        
 
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>
 
1103
                </sect2>
 
1104
 
 
1105
                <sect2 id="epi-ext-style-usage">
 
1106
                        <title>Using Select Stylesheet</title>
 
1107
                        
 
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>
 
1113
                </sect2>
 
1114
        </sect1>
 
1115
 
 
1116
        <sect1 id="epi-ext-sidebar">
 
1117
                <title>Sidebar</title>
 
1118
 
 
1119
                <sect2 id="epi-ext-sidebar-intro">
 
1120
                        <title>Introduccion</title>
 
1121
 
 
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>
 
1125
                </sect2>
 
1126
                
 
1127
                <sect2 id="epi-ext-sidebar-usage">
 
1128
                        <title>Using Sidebar</title>
 
1129
 
 
1130
                        <figure>
 
1131
                                <title><application>Epiphany</application> with a Sidebar displayed</title>
 
1132
                                <graphic fileref="figures/epi-ext-sidebar.png"/>
 
1133
                        </figure>
 
1134
 
 
1135
                        <sect3 id="epi-ext-sidebar-usage-display">
 
1136
                                <title>Display Sidebar</title>
 
1137
 
 
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>
 
1143
                        </sect3>                        
 
1144
 
 
1145
                        <sect3 id="epi-ext-sidebar-usage-add">
 
1146
                                <title>Add a Sidebar</title>
 
1147
                                
 
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>
 
1154
                        </sect3>
 
1155
 
 
1156
                        <sect3 id="epi-ext-sidebar-usage-switch">
 
1157
                                <title>Switch between Sidebars</title>
 
1158
                                
 
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 
 
1161
                                Sidebar.</para>
 
1162
                        </sect3>
 
1163
 
 
1164
                        <sect3 id="epi-ext-sidebar-usage-del">
 
1165
                                <title>Delete a Sidebar</title>
 
1166
                                
 
1167
                                <para>To delete a Sidebar which you have added, display the
 
1168
                                sidebar to delete and press the trash icon.</para>
 
1169
                        </sect3>
 
1170
                </sect2>
 
1171
        </sect1>
 
1172
        
 
1173
        <sect1 id="epi-ext-smart">
 
1174
                <title>Smart Bookmarks</title>
 
1175
                
 
1176
                <sect2 id="epi-ext-smart-intro">
 
1177
                        <title>Introduccion</title>
 
1178
                        
 
1179
                        <para>The Smart Bookmarks extension is an extension that enable to
 
1180
                        look up selected text with a smart bookmark.</para>
 
1181
                </sect2>
 
1182
 
 
1183
                <sect2 id="epi-ext-smart-usage">
 
1184
                        <title>Using Smart Bookmarks</title>
 
1185
                        
 
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>
 
1192
                </sect2>
 
1193
        </sect1>
 
1194
 
 
1195
        <sect1 id="epi-ext-tabgroups">
 
1196
                <title>Tab Groups</title>
 
1197
                
 
1198
                <sect2 id="epi-ext-tabgroups-intro">
 
1199
                        <title>Introduccion</title>
 
1200
                        
 
1201
                        <para>The Tab Groups extension makes new tabs appear after the current 
 
1202
                        tab.</para>
 
1203
                </sect2>
 
1204
 
 
1205
                <sect2 id="epi-ext-tabgroups-usage">
 
1206
                        <title>Using Tab Groups</title>
 
1207
                        
 
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>
 
1211
 
 
1212
                        <figure>
 
1213
                                <title>A new tab created after the first tab</title>
 
1214
                                <graphic fileref="figures/epi-ext-tabgroups.png"/>
 
1215
                        </figure>
 
1216
                </sect2>
 
1217
        </sect1>
 
1218
        
 
1219
        <sect1 id="epi-ext-tabstates">
 
1220
                <title>Tab States</title>
 
1221
                
 
1222
                <sect2 id="epi-ext-tabstates-intro">
 
1223
                        <title>Introduccion</title>
 
1224
                        
 
1225
                        <para>The Tab States extension changes the status of the tab label to
 
1226
                        signal the content has changed.</para>
 
1227
                </sect2>
 
1228
 
 
1229
                <sect2 id="epi-ext-tabstates-usage">
 
1230
                        <title>Using Tab States</title>
 
1231
                        
 
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>
 
1235
                </sect2>
 
1236
        </sect1>
 
1237
 
 
1238
<!-- The tabsmenu extension is currently broken. -->
 
1239
<!--
 
1240
        <sect1 id="epi-ext-tabsmenu">
 
1241
                <title>Tabsmenu</title>
 
1242
                
 
1243
                <sect2 id="epi-ext-tabsmenu-intro">
 
1244
                        <title>Introduction</title>
 
1245
                        
 
1246
                        <para>The Tabsmenu extension allows to move tabs between &app; windows.</para>
 
1247
                </sect2>
 
1248
 
 
1249
                <sect2 id="epi-ext-tabsmenu-usage">
 
1250
                        <title>Using Tab States</title>
 
1251
                        
 
1252
                        <para>To use this extension you must open at least 2 &app;
 
1253
                        windows.</para>
 
1254
                        <para>To move a tab to another window, display the tab in its in
 
1255
                        window, select
 
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
 
1259
                        window.
 
1260
                        </para>
 
1261
                        <tip><para>You can also move tabs between window from the
 
1262
                        context menu on the tabs.</para></tip>
 
1263
                </sect2>
 
1264
        </sect1>
 
1265
-->
 
1266
 
 
1267
        <sect1 id="epi-ext-about">
 
1268
                <title>A prepaus d'<application>Epiphany Extensions</application></title>
 
1269
 
 
1270
                <para>
 
1271
                <application>Epiphany Extensions</application> were written by 
 
1272
                <itemizedlist>
 
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>
 
1284
                </itemizedlist>
 
1285
                </para>
 
1286
                <para>
 
1287
                        This manual was written by Baptiste Mille-Mathias
 
1288
                        <email>baptiste.millemathias@gmail.com</email>.
 
1289
                </para>
 
1290
 
 
1291
                <para>
 
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.
 
1298
                </para>
 
1299
        </sect1>
 
1300
        
 
1301
</article>