<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY legal SYSTEM "legal.xml">
  <!ENTITY appversion "2.14">
  <!ENTITY manrevision "1.0">
  <!ENTITY date "March 2006">
  <!ENTITY app "<application>Epiphany</application>">
  <!ENTITY frplain "Epiphany">
  <!ENTITY fr "<application>Epiphany Extensions</application>">
  <!-- Information about the entities
       The legal.xml file contains legal information, there is no need to edit the file. 
       Use the appversion entity to specify the version of the application.
       Use the manrevision entity to specify the revision number of this manual.
       Use the date entity to specify the release date of this manual.
       Use the fr entity to specify the name of the application. -->
]>
<!-- 
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://developer.GNOME.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Jan 30, 2002
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="en">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo>
    <abstract role="description">
      <para>Variuous extensions for Epiphany Web browser.</para>
    </abstract>
    <title>Epiphany Extensions Manual</title>       

    <copyright>
      <year>2006</year>
      <holder>Baptiste Mille-Mathias</holder>
    </copyright>
    <copyright>
      <year>2006</year>
      <holder>Victor Osadci</holder>
    </copyright>
<!-- translators: uncomment this:

  <copyright>
   <year>2002</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>

   -->
<!-- An address can be added to the publisher information.  If a role is 
     not specified, the publisher/author is the same for all versions of the 
     document.  -->
    <publisher role="maintainer"> 
      <publishername>GNOME Documentation Project</publishername> 
    </publisher> 

   &legal; <!-- This file contains link to license for the
   documentation (GNU FDL), and other legal stuff such as "NO
   WARRANTY" statement. Please do not change any of this. -->

    <authorgroup> 
      <author> 
	<firstname>Baptiste</firstname> 
	<surname>Mille-Mathias</surname> 
	<affiliation> 
	  <orgname>GNOME Documentation Project</orgname> 
	  <address><email>baptiste.millemathias@gmail.com</email></address> 
	</affiliation> 
      </author>
	  <author> 
	<firstname>Victor</firstname> 
	<surname>Osadci</surname> 
	<affiliation> 
	  <orgname>GNOME Documentation Project</orgname> 
	  <address><email>Victor.Osadci.GNOME@xhtml.md</email></address> 
	</affiliation> 
	  </author> 
    </authorgroup>

    <revhistory>
      <revision>
        <revnumber>1.0</revnumber>
        <date>2006-03</date>
      </revision>
    </revhistory>

    <releaseinfo>
      This manual describes version &appversion; of &frplain;.
    </releaseinfo>
  </articleinfo>

  <indexterm zone="index"> 
    <primary>Epiphany-Extensions</primary> 
  </indexterm> 
  <indexterm zone="index"> 
    <primary>epiphany-extensions</primary> 
  </indexterm>
  <indexterm zone="index"> 
    <primary>extension</primary> 
  </indexterm>
  <indexterm zone="index"> 
    <primary>Browser</primary> 
  </indexterm>

<!-- ============= Document Body ================================== -->
	
	<sect1 id="epi-ext-intro">
		<title>Introduction</title>

		<para>&fr; are a set of tools that extend the capabilities of &app;, the GNOME Web Browser.</para>
		<para>They provide to Epiphany new functionality and complete some
		existing.</para>
	</sect1>	

	<sect1 id="epi-ext-manager">
		<title>Extensions Manager</title>

		<sect2 id="epi-ext-manager-intro">
			<title>Introduction</title>
			<para>The Extension Manager is the tool that lets you activate Epiphany
			Extensions.</para>
		</sect2>

		<sect2 id="epi-ext-manager-use">
			<title>Using Extensions Manager</title>
			<para>To open the Extension Manager, choose
			<menuchoice><guimenu>Tools</guimenu><guimenuitem>Extension...</guimenuitem></menuchoice>.</para>
			<para>To enable an extension, activate the check-box in front of the
			extension. To disable an extension, deactivate the check-box.</para>
		</sect2>
	</sect1>

	<sect1 id="epi-ext-actions">
		<title>Actions</title>	

		<sect2 id="epi-ext-actions-intro">
			<title>Introduction</title>
	
			<para>The Actions extension allows you to create specific actions in the
			context menu, for images, pages or both.</para>
		</sect2>

		<sect2 id="epi-ext-action-manage">
			<title>Manage Actions</title>

			<sect3 id="epi-ext-action-manage-create">
				<title>Create Actions</title>
			
				<para>To create an action, perform the following steps:
					<orderedlist>
						<listitem>
							<para>Choose <menuchoice><guimenu>Edit</guimenu>
							<guimenuitem>Actions</guimenuitem></menuchoice>
							to open the Actions manager</para>
						</listitem>
						<listitem>
							<para>Press <guibutton>Add</guibutton> to add a
							new action
							</para>
						</listitem>
						<listitem>
							<para>In the "Add Action" window, 
								<itemizedlist>
									<listitem>
										<para>Enter the <guilabel>Name</guilabel> of the action. The name
										will be displayed in the context menu</para>
									</listitem>
									<listitem>
										<para>Enter the <guilabel>Description</guilabel> of the action.
										The Description will be displayed in the
										statusbar of &app; and in the Action
										Manager</para>
									</listitem>
									<listitem>
										<para>Enter the <guilabel>Command</guilabel> to execute. this
										command will be executed and will receive as
										argument the element on which you'll launch
										the action. This action can be any
										program or script available in your path</para>
									</listitem>
									<listitem>
										<para>Select <guilabel>Pages</guilabel> or
										<guilabel>Images</guilabel> to choose on
										which elements the action will appear</para>
									</listitem>
									<listitem>
										<para>Press <guibutton>Add</guibutton></para>
									</listitem>
								</itemizedlist>
							</para>
						</listitem>
						<listitem>
							<para>Press <guibutton>Close</guibutton> to close the Actions Manager</para>
						</listitem>
					</orderedlist>
				</para>
				<figure><title>An example of action</title>
				<graphic fileref="figures/epi-ext-action-create.png"/>
				</figure>
			</sect3>
			
			<sect3 id="epi-ext-action-manage-edit">
				<title>Edit Actions</title>
			
				<para>To edit an action, follow these steps:
					<orderedlist>
						<listitem>
							<para>Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Actions</guimenuitem></menuchoice>
							to open the Actions manager</para>
						</listitem>
						<listitem>
							<para>
								Select the action to edit
							</para>
						</listitem>
						<listitem>
							<para>Press <guibutton>Edit</guibutton> 
							</para>
						</listitem>
						<listitem>
							<para>Edit the action as described in <xref linkend="epi-ext-action-manage-create"/>
							</para>
						</listitem>
					</orderedlist>
				</para>
			</sect3>
			
			<sect3 id="epi-ext-action-manage-del">
				<title>Delete Actions</title>
			
				<para>To delete an action, do the following:
					<orderedlist>
						<listitem>
							<para>Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Actions</guimenuitem></menuchoice>
							to open the Actions manager</para>
						</listitem>
						<listitem>
							<para>
								Select the action to delete
							</para>
						</listitem>
						<listitem>
							<para>Press <guibutton>Remove</guibutton> 
							</para>
						</listitem>
						<listitem>
							<para>Press <guibutton>Close</guibutton> to close the Actions Manager</para>
						</listitem>
					</orderedlist>
				</para>
			</sect3>
		</sect2>

		<sect2 id="epi-ext-actions-usage">
			<title>Using Actions</title>

			<para>To use a custom action, choose the action to execute from the context 
			menu of the element you wish to perform the action on.</para>
			<figure><title>The &app; image context menu with a custom action</title>
			<graphic fileref="figures/epi-ext-actions-use.png"/>
			</figure>
		</sect2>

	</sect1>
	
	<sect1 id="epi-ext-adblocker">
		<title>Ad Blocker</title>
		
		<sect2 id="epi-ext-adblocker-intro">
			<title>Introduction</title>
			
			<para>The Ad Blocker extension lets you block ad banners on websites.
			It avoids downloading them, saving time and bandwidth.</para>
		</sect2>

		<sect2 id="epi-ext-adblocker-usage">
			<title>Using Ad Blocker</title>
			
			<para>To use the Ad Blocker, you have to enable the extension.
			The extension will ignore link to ads when you visit websites, and	they won't 
			be displayed in web pages.</para>
			<para>&app; will display an icon in left side of the status bar 
			(see <xref linkend="epi-ext-figure-adblocker"	/>) to inform you that it has 
			blocked ads. If you move the mouse pointer over the icon, it will
			give you of the number of ads blocked in the page.
			<figure id="epi-ext-figure-adblocker">
				<title>The Ad Blocker icon</title>
				<graphic fileref="figures/epi-ext-adblocker.png"/>
			</figure>
			</para>
		</sect2>

		<sect2 id="epi-ext-adblocker-usage-extend">
				<title>Extend Ad Blocker</title>

				<para>Ad Blocker should block most of the advertisement on the
				web, but if you find that some banners are not blocked or Ad
				Blocker is too restrictive, you can	tune Ad Blocker extension to
				match your needs.
				</para>
				<para>Ad Blocker uses Perl regular expressions to match known URLs of
				ads servers and common words used in URLs of ads. Ad Blocker
				stores the system-wide rules in the file
				<filename>adblock-patterns</filename> located in <filename
				class='directory'>$PREFIX/share/epiphany-extensions/</filename>;
				one regular	expression per line. 
				</para>

				<sect3 id="epi-ext-adblocker-usage-extend-blacklist">
					<title>Add a deny rule</title>

					<para>If you want to block an ad not blocked by the Ad
					Blocker default rules, you may create a blacklist file, and
					add rules inside.</para>
					<para>&app; looks for the blacklist rules in the file 
					<filename>$HOME/.gnome2/epiphany/extensions/data/adblock/blacklist</filename>.
					</para>
				</sect3>

				<sect3 id="epi-ext-adblocker-usage-extend-whitelist">
					<title>Add a permit rule</title>

					<para>If you want allow to permit an ad to be displayed or
					correct a rule of Ad Blocker which is too restrictive, you can
					create a whitelist file, and add rules inside.</para>
					<para>&app; looks for white-list rules in the file 
					<filename>$HOME/.gnome2/epiphany/extensions/data/adblock/whitelist</filename>.
					</para>
				</sect3>
		</sect2>
	</sect1>
	
	<sect1 id="epi-ext-autoreloadtab">
		<title>Auto Reload Tab</title>	

		<sect2 id="epi-ext-autoreloadtab-intro">
			<title>Introduction</title>
	
			<para>The Auto Reload Tab extension allows you to regularly reload a page 
			in a tab.</para>
		</sect2>

		<sect2 id="epi-ext-autoreloadtab-usage">
			<title>Using Auto Reload Tab</title>

			<para>Enter the URL of a page you want to open and you know its
			content change often, then choose
			<menuchoice><guimenu>View</guimenu><guimenuitem>Auto
			Reload</guimenuitem></menuchoice> to enable auto reload,
			&app; will refresh each 3 minutes.</para>

			<note>
			  <title>Auto reload local files</title>
			  <para>
				When a local file is opened, &app; will monitor it and reload the file when it changes.
			  </para>
			</note>
			
		</sect2>
	</sect1>

	<sect1 id="epi-ext-autoscroll">
		<title>AutoScroll</title>	

		<sect2 id="epi-ext-autoscroll-intro">
			<title>Introduction</title>
	
			<para>The Auto Scroll extension allows you to automatically scroll a page in 
			any direction.	For instance, if you set a slow scroll, you can read a
			whole web page without touching your mouse.</para>
		</sect2>

		<sect2 id="epi-ext-autoscroll-usage">
			<title>Using Auto Scroll</title>

			<para>To start to auto scroll on a page,
				<orderedlist>
					<listitem>
						<para>Press and release the middle-mouse button; a
						target appears, and the cursor of mouse pointer is 
						changed to a hand cursor.</para>
					</listitem>
					<listitem>
						<para>Move the cursor in the direction to scroll. 
						The page will start to scroll in that direction.</para>
					</listitem>
				</orderedlist>
			</para>
		</sect2>
	</sect1>

	<sect1 id="epi-ext-certificates">
		<title>Certificates</title>
		
		<sect2 id="epi-ext-certificates-intro">
			<title>Introduction</title>
			
			<para>The Certificates extension gives access to the certificates stored
			by &app;, in order to view or manage them.</para>
		</sect2>

		<sect2 id="epi-ext-certificates-usage">
			<title>Using Certificates</title>
			
			<sect3 id="epi-ext-certificates-usage-view">
				<title>View website certificate</title>
			
				<para>When you browse a secured website, the unlocked padlock
				which appear on the left of the status bar becomes a locked
				padlock. When the Certificates extension is activated, you
				can click on the padlock, it will display the
				certificate information.</para>
			</sect3>

			<sect3 id="epi-ext-certificates-usage-manage">
				<title>Manage Certificates</title>
			
				<para>Certificates extensions lets you manage the certificates
				stored by &app; Browser.</para>
				<para>To display the <guilabel>Certificate Manager</guilabel>, choose
				<menuchoice><guimenu>Tools</guimenu><guimenuitem>Manage
				Certificates</guimenuitem></menuchoice>, it gives access to 4
				tabs:
					<variablelist>
						<varlistentry>
							<term><guilabel>Your Certificates</guilabel></term>
							<listitem><para>To import, view, backup and delete
							your own certificates. Personal Certificates can be used
							to identify when you browse a sensible site.</para></listitem>
						</varlistentry>
					</variablelist>
					<variablelist>
						<varlistentry>
							<term><guilabel>Other People's</guilabel></term>
							<listitem><para>To import, view, edit and delete
							certificates from people you know.</para></listitem>
						</varlistentry>
						<varlistentry>
							<term><guilabel>Web Sites</guilabel></term>
							<listitem><para>To import, view, edit and delete
							certificates from website you visited.</para></listitem>
						</varlistentry>
						<varlistentry>
							<term><guilabel>Authorities</guilabel></term>
							<listitem><para>To import, view, edit and delete
							certificates from authorities. Authorities are
							organizations which create and validate the authenticity
							of published certificates over the Internet.</para></listitem>
						</varlistentry>
					</variablelist>
				</para>
			</sect3>

			<sect3 id="epi-ext-certificates-usage-manage-devices">
				<title>Manage Security Devices</title>
			
				<para>Security Devices are used encrypt and decrypt connections
				and can store certificates and passwords.</para>
			</sect3>
		</sect2>
	</sect1>
	
	<sect1 id="epi-ext-errorviewer">
		<title>Error Viewer</title>	

		<sect2 id="epi-ext-errorviewer-intro">
			<title>Introduction</title>
	
			<para>The Error Viewer extension allows you to view errors in web pages,
			validate web pages and check links.</para>
		</sect2>

		<sect2 id="epi-ext-errorviewer-usage">
			<title>Using Error Viewer</title>

			<para>The Error Viewer is a small but useful extension for webmasters to check that
			websites (specially yours) conform to Web standards. This extension comes with 3
			functions:
				<variablelist>
					<varlistentry>
						<term><guilabel>Links Checker</guilabel></term>
						<listitem><para>Detects dead links on a site</para></listitem>
					</varlistentry>
					<varlistentry>
						<term><guilabel>HTML Code Checker</guilabel></term>
						<listitem><para>Checks the validity of the source code.</para></listitem>
					</varlistentry>
					<varlistentry>
						<term><guilabel>Error Viewer</guilabel></term>
						<listitem><para>Displays various errors of a
						webpage (like javascript, ...)</para></listitem>
					</varlistentry>
				</variablelist>
			</para>
			<para>To launch the Links Checker, choose
			<menuchoice><guimenu>Tools</guimenu><guimenuitem>Check
			Links</guimenuitem></menuchoice>. The error viewer window will open, and
			the links verification will start automatically.</para>
			<para>To launch the HTML Code Checker, choose
			<menuchoice><guimenu>Tools</guimenu><guimenuitem>Check
			HTML</guimenuitem></menuchoice>. The error viewer window will open, and
			the HTML code verification will start automatically.</para>
			<para>To launch the Error Viewer, choose
			<menuchoice><guimenu>Tools</guimenu><guimenuitem>Error
			Viewer</guimenuitem></menuchoice>. The error viewer window will open, it
			will display all the validation errors discovered in the web page.</para>
		</sect2>
	</sect1>
	
	<sect1 id="epi-ext-favicon">
		<title>Favicon Fallback</title>

		<sect2 id="epi-ext-favicon-intro">
			<title>Introduction</title>
		
			<para>The Favicon Fallback extension allows to retrieve the icon favicon.ico when
			the favicon is not well declared in web page.</para>
		</sect2>

		<sect2 id="epi-ext-favicon-usage">
			<title>Using Favicon</title>

			<para>Once activated, this extension will retrieve the picture file
			/favicon.ico on each site you will visit if this file exists. Then
			&app; will display this icon on the left of the location bar.</para>
		</sect2>
	</sect1>

	<sect1 id="epi-ext-gestures">
		<title>Gestures</title>
		
		<sect2 id="epi-ext-gestures-intro">
			<title>Introduction</title>
	
			<para>The Gestures allows you to quickly perform actions in &app; by drawing
			a shape with the mouse.</para>
		</sect2>

		<sect2 id="epi-ext-gestures-usage">
			<title>Using Gestures</title>

			<para>To perform a gesture, press the middle button in the view pane of
			a &app; window, move the mouse in one of the following patterns, and then
			release the button. The cursor will change while the gesture is being performed.
			</para>

			<table frame="topbot" id="epi-ext-gestures-table-patterns">
				<title>List of available default patterns in &fr;</title>
				<tgroup cols="3" colsep="0" rowsep="0">
					<colspec colname="COLSPEC0"/>
					<colspec colname="COLSPEC1"/>
					<colspec colname="COLSPEC2"/>
					<thead>
						<row rowsep="1">
							<entry valign="top">Action</entry>
							<entry valign="top">Gesture</entry>
							<entry valign="top">Example</entry>
						</row>
					</thead>
					<tbody>
						<row>
							<entry valign="top">Go back in history</entry>
							<entry valign="top">Left</entry>
							<entry valign="top">
								<mediaobject>
									<imageobject>
										<imagedata fileref="figures/epi-ext-gestures-back.png" format="PNG"/>
									</imageobject>
								</mediaobject>
							</entry>
						</row>
						<row>
							<entry valign="top">Go forward in history</entry>
							<entry valign="top">Right</entry>
							<entry valign="top">
								<mediaobject>
									<imageobject>
										<imagedata fileref="figures/epi-ext-gestures-forward.png" format="PNG"/>
									</imageobject>
								</mediaobject>
							</entry>
						</row>
						<row>
							<entry valign="top">Go up in a directory</entry>
							<entry valign="top">Up - Left - Up</entry>
							<entry valign="top">
								<mediaobject>
									<imageobject>
										<imagedata fileref="figures/epi-ext-gestures-up.png" format="PNG"/>
									</imageobject>
								</mediaobject>
							</entry>
						</row>
						<row>
							<entry valign="top">Go to your home page</entry>
							<entry valign="top">Up - Left - Down</entry>
							<entry valign="top">
								<mediaobject>
									<imageobject>
										<imagedata fileref="figures/epi-ext-gestures-homepage.png" format="PNG"/>
									</imageobject>
								</mediaobject>
							</entry>
						</row>
						<row>
							<entry valign="top">Reload the page</entry>
							<entry valign="top">Up - Down</entry>
							<entry valign="top">
								<mediaobject>
									<imageobject>
										<imagedata fileref="figures/epi-ext-gestures-reload.png" format="PNG"/>
									</imageobject>
								</mediaobject>
							</entry>
						</row>
						<row>
							<entry valign="top">Stop loading the page</entry>
							<entry valign="top">Left - Up</entry>
							<entry valign="top">
								<mediaobject>
									<imageobject>
										<imagedata fileref="figures/epi-ext-gestures-stop.png" format="PNG"/>
									</imageobject>
								</mediaobject>
							</entry>
						</row>
						<row>
							<entry valign="top">Open a new window</entry>
							<entry valign="top">Up</entry>
							<entry valign="top">
								<mediaobject>
									<imageobject>
										<imagedata fileref="figures/epi-ext-gestures-new-window.png" format="PNG"/>
									</imageobject>
								</mediaobject>
							</entry>
						</row>
						<row>
							<entry valign="top">Open a new tab</entry>
							<entry valign="top">Down</entry>
							<entry valign="top">
								<mediaobject>
									<imageobject>
										<imagedata fileref="figures/epi-ext-gestures-new-tab.png" format="PNG"/>
									</imageobject>
								</mediaobject>
							</entry>
						</row>
						<row>
							<entry valign="top">Close a tab/window</entry>
							<entry valign="top">Right - Left - Right</entry>
							<entry valign="top">
								<mediaobject>
									<imageobject>
										<imagedata fileref="figures/epi-ext-gestures-close.png" format="PNG"/>
									</imageobject>
								</mediaobject>
							</entry>
						</row>
						<row>
							<entry valign="top">Close a tab /window (second gesture)</entry>
							<entry valign="top">Down - Right</entry>
							<entry valign="top">
								<mediaobject>
									<imageobject>
										<imagedata fileref="figures/epi-ext-gestures-close-2.png" format="PNG"/>
									</imageobject>
								</mediaobject>
							</entry>
						</row>
						<row>
							<entry valign="top">Toggle full-screen mode</entry>
							<entry valign="top">Down - Left</entry>
							<entry valign="top">
								<mediaobject>
									<imageobject>
										<imagedata fileref="figures/epi-ext-gestures-fullscreen.png" format="PNG"/>
									</imageobject>
								</mediaobject>
							</entry>
						</row>
						<row>
							<entry valign="top">Go to the next tab</entry>
							<entry valign="top">Up - Right</entry>
							<entry valign="top">
								<mediaobject>
									<imageobject>
										<imagedata fileref="figures/epi-ext-gestures-next-tab.png" format="PNG"/>
									</imageobject>
								</mediaobject>
							</entry>
						</row>
						<row>
							<entry valign="top">Go to the previous tab</entry>
							<entry valign="top">Up - Left</entry>
							<entry valign="top">
								<mediaobject>
									<imageobject>
										<imagedata fileref="figures/epi-ext-gestures-prev-tab.png" format="PNG"/>
									</imageobject>
								</mediaobject>
							</entry>
						</row>
						<row>
							<entry valign="top">View the page source</entry>
							<entry valign="top">Left - Down - Right - Down - Left (Do a
							<wordasword>S</wordasword>)</entry>
							<entry valign="top">
								<mediaobject>
									<imageobject>
										<imagedata fileref="figures/epi-ext-gestures-view-source.png" format="PNG"/>
									</imageobject>
								</mediaobject>
							</entry>
						</row>
						<row>
							<entry valign="top">View the page source (Second gesture)</entry>
							<entry valign="top">Up - Right - Down</entry>
							<entry valign="top">
								<mediaobject>
									<imageobject>
										<imagedata fileref="figures/epi-ext-gestures-view-source-2.png" format="PNG"/>
									</imageobject>
								</mediaobject>
							</entry>
						</row>
					</tbody>
				</tgroup>
			</table>
		</sect2>

		<sect2 id="epi-ext-gestures-create">
			<title>Create gestures</title>
				
			<para>The Gestures extension lets you create your own gesture patterns, and so let you
			extend the set provided by default.</para>

			<sect3 id="epi-ext-gestures-create-how">
				<title>Understand how gesture works</title>

				<para>&app; stores the definition of the gestures for all users in the file 
				<filename>ephy-gestures.xml</filename> located in the directory <filename
				class="directory">$PREFIX/share/epiphany-extensions/</filename>; this
				file uses the xml format, and defines the gestures for all the users of
				the system.</para>
				
				<para>If you open this file, you see a set of markup gesture, and
				inside them, there is one of several markup sequence and one markup
				action.
				<example>
					<title>A Gesture Example</title>
					<programlisting>
<![CDATA[<!-- down-left -->
<gesture>
	<sequence>36987</sequence>
	<sequence>3687</sequence>
	<action>/menubar/ViewMenu/ViewFullscreenMenu</action>
</gesture>]]></programlisting>
				</example>
				</para>
			</sect3>

			<sect3 id="epi-ext-gestures-create-why">
				<title>Create new gesture</title>

				<para>In this section, we will explain how to create a new gesture. We
				will decide to print the web page when we will draw a
				<wordasword>P</wordasword> with the mouse.</para>

				<para>To create your own gestures, first create a file named
				<filename>ephy-gestures.xml</filename> in the directory <filename
				class="directory">~/.gnome2/epiphany/</filename> which will store your
				personal gesture definitions.</para>
				
				<para>Open the newly created file with a text editor and add the following
				content:
				<programlisting>
<![CDATA[<?xml version="1.0"?>
<epiphany_gestures version="0.4">
	<gesture>
		<sequence></sequence>
		<action></action>
	</gesture>
</epiphany_gestures>]]></programlisting>
				</para>
				
				<sect4 id="epi-ext-gestures-create-seq">
					<title>Define the gesture movement</title>
					
					<para>To define a new gesture, you need at least one or several
					sequences and an action	to execute.</para>
					<para>A sequence is a set of numerical values between 1 and 9 which
					define the gesture to draw following a phone keypad layout (with "1"
					placed to the top-left hand corner and the "9" at the bottom-right
					hand corner).</para>
					<para>If we want to draw a <wordasword>P</wordasword>, the key sequence
					is 74123654, insert this value between the markups "sequence".</para>
				<programlisting>
<![CDATA[<?xml version="1.0"?>
<epiphany_gestures version="0.4">
	<gesture>
		<sequence>74123654</sequence>
		<action></action>
	</gesture>
</epiphany_gestures>]]></programlisting>
				</sect4>

				<sect4 id="epi-ext-gestures-create-act">
					<title>Define the action</title>
					
					<para>An action describes the path to a menu or toolbar item
					in the &app; window. All these paths are defined is the file
					<filename>ephy-gestures.xml</filename> located in <filename
					class="directory">$PREFIX/epiphany/epiphany-ui.xml</filename></para>
				<programlisting>
<![CDATA[<?xml version="1.0"?>
<epiphany_gestures version="0.4">
	<gesture>
		<sequence>74123654</sequence>
		<action>/menubar/FileMenu/FilePrintMenu</action>
	</gesture>
</epiphany_gestures>]]></programlisting>
				</sect4>
			</sect3>
		</sect2>
	</sect1>

	<sect1 id="epi-ext-greasemonkey">
		<title>Greasemonkey</title>	

		<sect2 id="epi-ext-greasemonkey-intro">
			<title>Introduction</title>
	
			<para>Greasemonkey is a powerful extension that allows users to use 
			scripts that make on-the-fly changes to web pages. The
			greasemonkey scripts can make page modifications or automatically
			fill forms for instance.</para>
			<para>Greasemonkey scripts are javascripts and have the file
			extension ".user.js". Greasemonkey extension doesn't come with any scripts, you have to find
			by yourself scripts over the web. A good Greasemonkey scripts repository is the
			site <ulink
			url="http://userscripts.org/">http://userscripts.org/</ulink>.</para>
			<para>To learn more about Greasemonkey, read the <ulink
			url="http://en.wikipedia.org/wiki/Greasemonkey">definition</ulink> on the 
			Wikipedia on-line enciclopedia.</para>
		</sect2>

		<sect2 id="epi-ext-greasemonkey-usage">
			<title>Using Greasemonkey</title>
			
			<sect3 id="epi-ext-greasemonkey-usage-add">
				<title>Install a Greasemonkey script</title>
		
				<para>To install a Greasemonkey script, first locate a link to a
				greasemonkey script on a web page, right-click on the link, and
				choose <guimenuitem>Install User Script</guimenuitem>. &app; 
				will download the script; a message box will confirm the script
				is installed and ready to use.</para>
				<tip><para>You can manually install Greasemonkey scripts by
				copying them in <filename
				class="directory">$HOME/.gnome2/epiphany/extensions/data/greasemonkey/</filename></para></tip>
			</sect3>

			<sect3 id="epi-ext-greasemonkey-usage-del">
				<title>Remove a Greasemonkey script</title>

				<para>&app; doesn't provide a Graphical User interface to delete scripts;
				to remove a script go to 
				<filename class="directory">$HOME/.gnome2/epiphany/extensions/data/greasemonkey/</filename>
				, and move the script file in the trash.</para>
			</sect3>
		</sect2>
	</sect1>
	
	<sect1 id="epi-ext-javaconsole">
		<title>Java Console</title>	

		<sect2 id="epi-ext-javaconsole-intro">
			<title>Introduction</title>
	
			<para>Java Console extension provides access to the Java-Plugin
			Console.</para>
		</sect2>

		<sect2 id="epi-ext-javaconsole-usage">
			<title>Using Java Console</title>

			<para>To display the Java Console, choose
			<menuchoice><guimenu>Tools</guimenu><guimenuitem>Java
			Console</guimenuitem></menuchoice>.</para>
		</sect2>
	</sect1>

	<sect1 id="epi-ext-newsfeedsubscription">
		<title>News Feed Subscription</title>	

		<sect2 id="epi-ext-newsfeedsubscription-intro">
			<title>Introduction</title>
	
			<para>The News Feed Subscription extension allows you to subscribe to a news feed
			offered by the web page in your favorite news reader. The supported
			feed readers are
			<itemizedlist>
				<listitem><para>Liferea</para></listitem>
				<listitem><para>Straw</para></listitem>
				<listitem><para>Blam</para></listitem>
			</itemizedlist>
			</para>
		</sect2>

		<sect2 id="epi-ext-newsfeedsubscription-usage">
			<title>Using News Feed Subscription</title>

			<para>When &app; detects a that a website provides RSS and Atom feeds, it
			will display an icon on left side of the &app; status bar.</para>
			<para>To register this feed: 
				<orderedlist>
					<listitem>
						<para>
							Choose <menuchoice><guimenu>Tools</guimenu><guimenuitem>News Feed
							Subscription</guimenuitem></menuchoice>, a new
							window with the list of available feeds
							appears. You can also click on the Feed icon in the status bar to 
							make the <interface>News Feed Subscription</interface> window appear.
						</para>
					</listitem>
					<listitem>
						<para>
							Choose the feeds you wan to subscribe to. You can also copy the feed
							Loaction using the feed's context menu.
						</para>
					</listitem>
					<listitem>
						<para>
							Press <guibutton>Subscribe</guibutton> to
							subscribe the feeds.
						</para>
					</listitem>
				</orderedlist>
			</para>
		</sect2>
	</sect1>
	
	<sect1 id="epi-ext-pageinfo">
		<title>Page Info</title>
		
		<sect2 id="epi-ext-pageinfo-intro">
			<title>Introduction</title>
			
			<para>The Page Info extension provides detailed information about the web 
			pages you visit.</para>
		</sect2>

		<sect2 id="epi-ext-pageinfo-usage">
			<title>Using Page Info</title>
			
			<para>To access the page information choose
			<menuchoice><guimenu>View</guimenu><guimenuitem>Page
			Information</guimenuitem></menuchoice>; a new window appears, letting
			you access 5 tabs:
				<variablelist>
					<varlistentry>
						<term><guilabel>General</guilabel></term>
						<listitem><para>Provides various information on the page and
					the website</para></listitem>
					</varlistentry>
					<varlistentry>
						<term><guilabel>Media</guilabel></term>
						<listitem><para>displays media files (pictures, sounds,...) 
						used on the page.</para></listitem>
					</varlistentry>
					<varlistentry>
						<term><guilabel>Links</guilabel></term>
						<listitem><para>Provides all the links of the web page.</para></listitem>
					</varlistentry>
					<varlistentry>
						<term><guilabel>Forms</guilabel></term>
						<listitem><para>All the forms available in the page are
						displayed.</para></listitem>
					</varlistentry>
					<varlistentry>
						<term><guilabel>Metadata</guilabel></term>
						<listitem><para>Displays all the information entered by
						the webmaster about the site.</para></listitem>
					</varlistentry>
				</variablelist>
			</para>
		</sect2>
	</sect1>
	
	<sect1 id="epi-ext-pushscroll">
		<title>Push Scroll</title>	

		<sect2 id="epi-ext-pushscroll-intro">
			<title>Introduction</title>
	
			<para>The Push Scroll extension provides scroll function while the
			middle mouse button is pressed.</para>
		</sect2>

		<sect2 id="epi-ext-pushscroll-usage">
			<title>Using Push Scroll</title>

			<para>To use Push Scroll, simply press the middle mouse button, and
			move your mouse in any direction, the page will scroll.</para>
		</sect2>
	</sect1>
	
	<sect1 id="epi-ext-pythonconsole">
		<title>Python Console</title>	

		<sect2 id="epi-ext-pythonconsole-intro">
			<title>Introduction</title>
	
			<para>Opens an interactive Python console, and allows to modify
			&app; through Python.</para>
		</sect2>

		<sect2 id="epi-ext-pythonconsole-usage">
			<title>Using Python Console</title>

			<para>To display the Python Console, choose
			<menuchoice><guimenu>Tools</guimenu><guimenuitem>Python Console</guimenuitem></menuchoice>.
			</para>
		</sect2>
	</sect1>
	
	<sect1 id="epi-ext-style">
		<title>Select Stylesheet</title>
		
		<sect2 id="epi-ext-style-intro">
			<title>Introduction</title>
			
			<para>The Select Stylesheet extension lets you 
			switch between the stylesheets of a web page. You can also 
			disable the stylesheets when you browsing a page.</para>
		</sect2>

		<sect2 id="epi-ext-style-usage">
			<title>Using Select Stylesheet</title>
			
			<para>To change the style sheet of the website you visit, choose 
			<menuchoice><guimenu>View</guimenu><guimenuitem>Style</guimenuitem></menuchoice>
			, then choose a style sheet from those available.</para>
			<para>If you choose the style sheet <guilabel>none</guilabel> the
			website will not use any style sheet.</para>
		</sect2>
	</sect1>

	<sect1 id="epi-ext-sidebar">
		<title>Sidebar</title>

		<sect2 id="epi-ext-sidebar-intro">
			<title>Introduction</title>

			<para>The Sidebar extension adds a small window on the left side of the
			&app; window. Sidebar allows to display website content and	can provide quick
			access to their information.</para>
		</sect2>
		
		<sect2 id="epi-ext-sidebar-usage">
			<title>Using Sidebar</title>

			<figure>
				<title>&app; with a Sidebar displayed</title>
				<graphic fileref="figures/epi-ext-sidebar.png"/>
			</figure>

			<sect3 id="epi-ext-sidebar-usage-display">
				<title>Display Sidebar</title>

				<para>By default, the Sidebar is not displayed; to display the
				Sidebar, choose menu
				<menuchoice><guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem></menuchoice>.</para>
				<tip><para>You can also toggle the visibility of Sidebar by pressing
				<keycap>F9</keycap>.</para></tip>
			</sect3>			

			<sect3 id="epi-ext-sidebar-usage-add">
				<title>Add a Sidebar</title>
				
				<para>To add a Sidebar, activate the Sidebar extension, then
				click on the link that the website provides to install the sidebar.
				A window requests to add the document to the Sidebar, 
				click <guibutton>Add a Sidebar</guibutton>, the sidebar document
				is added to the Sidebar.</para> 
				<para>You can find a list of websites that provide sidebar on <ulink
				url="http://dmoz.org/Netscape/Sidebar/">DMOZ</ulink>.</para>
			</sect3>

			<sect3 id="epi-ext-sidebar-usage-switch">
				<title>Switch between Sidebars</title>
				
				<para>When you have subscribed to several sidebars, to switch
				between them, select the Sidebar from the drop-box at the top of the 
				Sidebar.</para>
			</sect3>

			<sect3 id="epi-ext-sidebar-usage-del">
				<title>Delete a Sidebar</title>
				
				<para>To delete a Sidebar which you have added, display the
				sidebar to delete and press the trash icon.</para>
			</sect3>
		</sect2>
	</sect1>
	
	<sect1 id="epi-ext-smart">
		<title>Smart Bookmarks</title>
		
		<sect2 id="epi-ext-smart-intro">
			<title>Introduction</title>
			
			<para>The Smart Bookmarks extension is an extension that enable to
			look up selected text with a smart bookmark.</para>
		</sect2>

		<sect2 id="epi-ext-smart-usage">
			<title>Using Smart Bookmarks</title>
			
			<para>To create a smart bookmark, see the appropriate <ulink
			type="help" url="ghelp:epiphany#smart-bookmarks-create-a-smartbookmark">
			section</ulink>	in the &app; manual.</para>
			<para>To look up text, select the text in a web page and 
			choose <guimenuitem>look-up</guimenuitem> and the smart
			bookmark from the context menu. A web browser will be opened with the result
			of the look-up.</para>
		</sect2>
	</sect1>

	<sect1 id="epi-ext-tabgroups">
		<title>Tab Groups</title>
		
		<sect2 id="epi-ext-tabgroups-intro">
			<title>Introduction</title>
			
			<para>The Tab Groups extension makes new tabs appear after the current 
			tab.</para>
		</sect2>

		<sect2 id="epi-ext-tabgroups-usage">
			<title>Using Tab Groups</title>
			
			<para>Once this extension is enabled, it changes the normal behaviour
			(where new tabs are created after the last tab) to a new one. When you open 
			a new tab, it	will be created after the current tab.</para>

			<figure>
				<title>A new tab created after the first tab</title>
				<graphic fileref="figures/epi-ext-tabgroups.png"/>
			</figure>
		</sect2>
	</sect1>
	
	<sect1 id="epi-ext-tabstates">
		<title>Tab States</title>
		
		<sect2 id="epi-ext-tabstates-intro">
			<title>Introduction</title>
			
			<para>The Tab States extension changes the status of the tab label to
			signal the content has changed.</para>
		</sect2>

		<sect2 id="epi-ext-tabstates-usage">
			<title>Using Tab States</title>
			
			<para>Once this extension is enabled, when the content of a page in
			a tab changes, the tab label will become bold, to notify you that the 
			page has changed.</para>
		</sect2>
	</sect1>

<!-- The tabsmenu extension is currently broken. -->
<!--
	<sect1 id="epi-ext-tabsmenu">
		<title>Tabsmenu</title>
		
		<sect2 id="epi-ext-tabsmenu-intro">
			<title>Introduction</title>
			
			<para>The Tabsmenu extension allows to move tabs between &app; windows.</para>
		</sect2>

		<sect2 id="epi-ext-tabsmenu-usage">
			<title>Using Tab States</title>
			
			<para>To use this extension you must open at least 2 &app;
			windows.</para>
			<para>To move a tab to another window, display the tab in its in
			window, select
			<menuchoice><guimenu>Tabs</guimenu><guisubmenu>Move Tab to
			Window</guisubmenu><guimenuitem>Window
			name</guimenuitem></menuchoice>. The tab is moved to the selected
			window.
			</para>
			<tip><para>You can also move tabs between window from the
			context menu on the tabs.</para></tip>
		</sect2>
	</sect1>
-->

	<sect1 id="epi-ext-about">
		<title>About &fr;</title>

		<para>
		&fr; were written by 
		<itemizedlist>
			<listitem><para>Samuel Abels
			(<email>spam2@debain.org</email>)</para></listitem>
			<listitem><para>Crispin Flowerday
			(<email>gnome@flowerday.cx</email>)</para></listitem>
			<listitem><para>Adam Hooper
			(<email>adamh@cvs.gnome.org</email>)</para></listitem>
			<listitem><para>Mathias Hasselmann
			(<email>mathias@taschenorakel.de</email>)</para></listitem>
			<listitem><para>James Henstridge
			(<email>james@daa.com.au</email>)</para></listitem>
			<listitem><para>Jean-Yves Lefort
			(<email>jylefort@brutele.be</email>)</para></listitem> 
			<listitem><para>Christian Persch
			(<email>chpe@gnome.org</email>)</para></listitem>
			<listitem><para>Raphaël Slinckx
			(<email>raphael@slinckx.net</email>)</para></listitem>
			<listitem><para>Justin Wake
			(<email>jwake@iinet.net.au</email>)</para></listitem>
		</itemizedlist>
		</para>
		<para>
			This manual was written by Baptiste Mille-Mathias
			<email>baptiste.millemathias@gmail.com</email>.
		</para>

		<para>
			This program is distributed under the terms of the GNU
			General Public license as published by the Free Software
			Foundation; either version 2 of the License, or (at your option)
			any later version. A copy of this license can be found at this
			<ulink url="ghelp:gpl" type="help">link</ulink>, or in the file
			COPYING included with the source code of this program.
		</para>
	</sect1>
	
</article>
