path: root/help/C/epiphany.xml

<?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 "1.0">
  <!ENTITY manrevision "1.0">
  <!ENTITY date "May 2003">
  <!ENTITY fr "<application>Epiphany</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> 
    <title>Epiphany Manual &manrevision;</title>       

    <copyright> 
      <year>2003</year> 
      <holder>Patanjali Somayaji</holder> 
    </copyright>
    <copyright> 
      <year>2003</year> 
      <holder>David Bordoley</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> 
      <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>Patanjali</firstname> 
    <surname>Somayaji</surname> 
    <affiliation> 
      <orgname>GNOME Documentation Project</orgname> 
      <address> <email>patanjali@codito.com</email> </address> 
    </affiliation> 
      </author> 
      <author> 
    <firstname>David</firstname> 
    <surname>Bordoley</surname> 
    <affiliation> 
      <orgname>Epiphany Development Team</orgname> 
      <address> <email>bordoley@msu.edu</email> </address> 
    </affiliation> 
      </author> 
    </authorgroup>


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

  <indexterm zone="index"> 
    <primary>Epiphany</primary> 
  </indexterm> 
  <indexterm zone="index"> 
    <primary>epiphany</primary> 
  </indexterm>
  <indexterm zone="index"> 
    <primary>Browser</primary> 
  </indexterm>

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
<!-- Use the Introduction section to give a brief overview of what
     the application is and what it does. -->
  <sect1 id="fr-introduction"> 
    <title>Introduction</title> 
    <para>&fr; is a GNOME web browser based on the mozilla rendering 
    engine. &fr; aims to be simple to use and standards compliant.
   </para>
  </sect1>

<!-- ============= Getting Started =============================== -->
  <sect1 id="ephy-getting-started">
      <title>Getting Started</title>

        <sect2 id="ephy-to-open-browser-window">
          <title>To Open a Browser Window</title>
            <para>You can open a browser window in the following ways:</para>
        <variablelist>
            <varlistentry>
            <term><guimenu>Applications</guimenu> menu</term>
            <listitem>
            <para>Choose 
            <menuchoice>
            <guisubmenu>Internet</guisubmenu>
            <guimenuitem>Web Browser</guimenuitem>
            </menuchoice>. </para>
            </listitem>
            </varlistentry>
            <varlistentry>
            <term>Command line</term>
            <listitem>
            <para>Type <command>epiphany</command>, then press <keycap>Return</keycap>.</para>
            </listitem>
            </varlistentry>
            </variablelist>
        </sect2>
        <sect2 id="ephy-to-open-bookmarks">
          <title>To Open the Bookmarks Window</title>
                <para>You can open the bookmarks window in the following ways:</para>
        <variablelist>
            <varlistentry>
            <term><guimenu>Applications</guimenu> menu</term>
            <listitem>
            <para>Choose 
            <menuchoice>
            <guisubmenu>Internet</guisubmenu>
            <guimenuitem>Web Bookmarks</guimenuitem>
            </menuchoice>. </para>
            </listitem>
            </varlistentry>
            <varlistentry>
            <term>Command line</term>
            <listitem>
            <para>Type <command>epiphany -b</command>, then press <keycap>Return</keycap>.</para>
            </listitem>
            </varlistentry>
            </variablelist>
        </sect2>

  </sect1>

<!-- ============= Browser Windows ============================ -->
  <sect1 id="ephy-browser-windows">
      <title>Browser Windows</title>
      <para>Browser windows enable you to browse between web pages. 
<xref linkend="ephy-screenshot"/> shows a browser window displaying the 
home page.</para>
    <figure id="ephy-screenshot">
      <title>Browser window displaying the home page</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/ephy-screenshot.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>A page being displayed in a browser window. Callouts: Menubar, toolbar, address entry, bookmarks bar, view pane</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
    </figure>
    <para><xref linkend="epiphany-TBL-1"/> describes the components of a browser window.</para>
    <table frame="topbot" id="epiphany-TBL-1">
      <title>Browser Window Components</title>
      <tgroup cols="2" colsep="0" rowsep="0">
        <colspec colname="colspec0" colwidth="29.39*"/>
        <colspec colname="colspec1" colwidth="70.61*"/>
        <thead>
          <row rowsep="1">
            <entry valign="top">
              <para>Component</para>
            </entry>
            <entry valign="top">
              <para>Description </para>
            </entry>
          </row>
        </thead>
        <tbody>
          <row>
            <entry valign="top">
              <para>Menubar</para>
            </entry>
            <entry valign="top">
              <para>Contains menus that you use to perform tasks in a browser window.</para>
            </entry>
          </row>
          <row>
            <entry valign="top">
              <para>Toolbar</para>
            </entry>
            <entry valign="top">
              <para>Contains buttons that you use to perform tasks in a browser window.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec0" valign="top">
              <para>Address entry</para>
            </entry>
            <entry colname="colspec1" valign="top">
              <para>Drop-down combination box that you use to enter web addresses or search terms.</para>
            </entry>
          </row>
    <row>
            <entry colname="colspec0" valign="top">
              <para>Bookmarks bar</para>
            </entry>
            <entry colname="colspec1" valign="top">
              <para>Contains menus, buttons and text fields that you use for highspeed access to bookmarks and web searches.</para>
            </entry>
          </row>
          <row>
            <entry valign="top">
              <para>View pane</para>
            </entry>
            <entry valign="top">
              <para>Displays the contents of the viewed page.</para>
            </entry>
          </row>
          <row>
            <entry colname="colspec0" valign="top">
              <para>Statusbar</para>
            </entry>
            <entry colname="colspec1" valign="top">
              <para>Displays status information.</para>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </table>
    <para>You can also open a popup menu from browser
windows. To open this popup menu right-click in a browser
window. The items in this menu depend on where you right-click. For example,
when you right-click on a link, you can choose items related to
the link. When you right-click on the web page itself,
you can choose items related to the display of the web page.</para>
  </sect1>

<!-- ============= Browsing the Web =========================== -->
  <sect1 id="ephy-browsing-web">
      <title>Browsing the Web</title>
      <para>
      </para>
        <sect2 id="using-address-entry">
          <title>Using the Address Entry</title>
          <para>
          </para>
        </sect2>
    <sect2 id="using-toolbar">
          <title>Using the Toolbar</title>
          <para>
          </para>
        </sect2>
    <sect2 id="using-bookmarks-bar">
          <title>Using the Bookmarks Bar</title>
          <para>
          </para>
        </sect2>
    <sect2 id="using-fullscreen-mode">
          <title>Using Fullscreen Mode</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-open-new-window">
          <title>To Open a New Window</title>
          <para>To open a new window, choose 
          <menuchoice> <guimenu>File</guimenu> <guimenuitem>New Window</guimenuitem>
             </menuchoice>.
      </para>
        </sect2>
    <sect2 id="to-open-new-tab">
          <title>To Open a New Tab</title>
          <para>To open a new tab, choose 
          <menuchoice> <guimenu>File</guimenu> <guimenuitem>New Tab</guimenuitem>
             </menuchoice>. The new tab will be place to the right of any existing tabs.
      </para>
    </sect2>
    <sect2 id="ephy-to-open-file">
          <title>To Open a File</title>
          <para>To open a file, choose 
          <menuchoice> <guimenu>File</guimenu> <guimenuitem>Open...</guimenuitem>
             </menuchoice>
          to display the <guilabel>Open File</guilabel> dialog. Select the file
          that you want to open, then click <guibutton>OK</guibutton>. The file is
          displayed in the browser window. </para>
        </sect2>
    <sect2 id="to-save-page-to-file">
          <title>To Save a Page to a File</title>
          <para>To save a page to a file, choose 
        <menuchoice> <guimenu>File</guimenu> <guimenuitem>Save As</guimenuitem> 
            </menuchoice>. 
        Enter a name for the file in the <guilabel>Save
        As</guilabel> dialog box, then click <guibutton>OK</guibutton>. </para>
        </sect2>
    <sect2 id="to-print-page">
          <title>To Print a Page</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-bookmark-page">
          <title>To Bookmark a Page</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-find-text-in-page">
          <title>To Find Text in a Page</title>
      <para>To search a page for a string, perform the following steps:</para>
        <orderedlist> 
          <listitem><para>Choose 
                <menuchoice> <guimenu>Edit</guimenu>
                  <guimenuitem>Find</guimenuitem> </menuchoice>
                to display the <guilabel>Find</guilabel> dialog.</para>
          </listitem>
          <listitem><para>Type the string that you want to find, in the
                <guilabel>Find</guilabel> field.</para>
          </listitem>
          <listitem><para>Select the <guilabel>Case sensitive</guilabel> option
                to only find occurrences of the string that match the case of the text that you
                type. </para>
          </listitem>
          <listitem><para>Select the <guilabel>Wrap around</guilabel> option to search to the end of the page and then continue the search from the beginning of the page. </para>
          </listitem>
          <listitem><para>Click <guibutton>Next</guibutton> to search the page
                for the first occurrence of the string. If the string is found, the cursor is moved to the string, and the string is selected.</para>
          </listitem>
          <listitem><para>To find the next occurrence of the string, click
                <guibutton>Next</guibutton>.</para>
          </listitem>
          <listitem><para>To find the previous occurrence of the string, click
                <guibutton>Previous</guibutton>.</para>
          </listitem>
          <listitem><para>To finish the search, click
                <guibutton>Close</guibutton>. </para>
          </listitem>
        </orderedlist>
        </sect2>    
    <sect2 id="to-change-zoom">
      <title>To Change the Zoom Factor</title>
      <para>You can use the following methods to resize the view of a page</para>
      <itemizedlist>
        <listitem><para>To enlarge the view of a page, choose 
        <menuchoice>
        <guimenu>View</guimenu>
        <guimenuitem>Zoom In</guimenuitem>
        </menuchoice>.</para>
        </listitem>
        <listitem><para>To shrink the view of a page, choose 
        <menuchoice>
        <guimenu>View</guimenu>
        <guimenuitem>Zoom Out</guimenuitem>
        </menuchoice>.</para>
        </listitem>
        <listitem><para>To view the page at its actual size, choose 
        <menuchoice>
        <guimenu>View</guimenu>
        <guimenuitem>Normal Size</guimenuitem>
        </menuchoice>. </para>
        </listitem>
      </itemizedlist>
        </sect2>
    <sect2 id="to-view-page-source">
          <title>To View the Source of a Page</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-open-link">
          <title>To Open a Link</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-open-link-in-window">
          <title>To Open a Link in a New window</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-open-link-in-tab">
          <title>To Open a Link in a New Tab</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-download-link">
          <title>To Download a Link</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-bookmark-link">
          <title>To Bookmark a Link</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-switch-between-tab">
          <title>To Switch in Between Tabs</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-move-tabs">
          <title>To Move Tabs</title>
          <para>
          </para>
        </sect2>
  </sect1>

<!-- ============= Managing Your Bookmarks ================ -->
  <sect1 id="ephy-managing-bookmarks">
      <title>Managing Your Bookmarks</title>
      <para>
      </para>
    <sect2 id="overview-of-bookmarks">
          <title>Overview of the Epiphany Bookmarks System</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-creating-new-bookmark">
      <title>To Create a New Bookmark</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-select-bookmarks">
          <title>To Select Bookmarks and Topics</title>
          <para>You can select bookmarks and topics in several
ways.  <xref linkend="epiphany-TBL-2"/> describes how to select items in the bookmark window.</para>
            <table frame="topbot" id="epiphany-TBL-2">
            <title>Selecting Items in the Bookmarks Window</title>
            <tgroup cols="2" colsep="0" rowsep="0">
            <colspec colname="colspec0" colwidth="36.36*"/>
            <colspec colname="colspec2" colwidth="63.64*"/>
            <thead>
                <row rowsep="1">
                <entry valign="top">
                <para>Task</para>
                </entry>
                <entry colname="colspec2" valign="top">
                <para>Action</para>
                </entry>
                </row>
            </thead>
            <tbody>
                <row>
                <entry colname="colspec0" valign="top">
                <para>Select a bookmark or topic</para>
                </entry>
                <entry colname="colspec2" valign="top">
                <para>Click on the bookmark or topic.</para>
                </entry>
                </row>
                <row>
                <entry colname="colspec0" valign="top">
                <para>Select a group of contiguous bookmarks</para>
                </entry>
                <entry colname="colspec2" valign="top">
                <para>Press-and-hold <keycap>Shift</keycap>. Click on the first bookmark in the group, then click on the last bookmark in the group.</para>
                </entry>
                </row>
                <row>
                <entry colname="colspec0" valign="top">
                <para>Select multiple bookmarks</para>
                </entry>
                <entry colname="colspec2" valign="top">
                <para>Press-and-hold <keycap>Ctrl</keycap>.
Click on the bookmark that you want to select.</para>
                </entry>
                </row>
                <row>
                <entry colname="colspec0" valign="top">
                <para>Select all bookmarks in a topic</para>
                </entry>
                <entry colname="colspec2" valign="top">
                <para>Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Select All</guimenuitem></menuchoice>.</para>
                </entry>
                </row>
            </tbody>
            </tgroup>
            </table>
        </sect2>
    <sect2 id="to-open-bookmark">
          <title>To Open a Bookmark in a New Window or Tab</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-create-new-topic">
          <title>To Create a New Topic</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-add-bookmark-to-topic">
          <title>To Add a Bookmark to a Topic</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-remove-bookmark-from-topic">
          <title>To Remove a Bookmark From a Topic</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-rename-bookmark-or-topic">
          <title>To Rename a Bookmark or Topic</title>
          <para>To rename a bookmark or Topic perform the following steps:</para>
            <orderedlist>
            <listitem>
            <para>Select the bookmark or topic that you want to rename in the bookmarks window.</para>
            </listitem>
            <listitem>
            <para>Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Rename...</guimenuitem>
        </menuchoice>. Alternatively, right-click on the bookmark
        or topic in the view pane, then choose <guimenuitem>Rename...</guimenuitem>.
            The name of the bookmark or topic is selected.</para>
            </listitem>
            <listitem>
            <para>Type a new name for the topic or bookmark, then press <keycap>Return</keycap>.</para>
            </listitem>
            </orderedlist>
        </sect2>
    <sect2 id="to-delete-bookmark-or-topic">
          <title>To Delete a Bookmark or Topic</title>
          <para>To delete a bookmarks or topic perform the following steps:</para>
            <orderedlist>
            <listitem>
            <para>Select the bookmark or topic that you want to delete the bookmarks window.</para>
            </listitem>
            <listitem>
            <para>Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Delete</guimenuitem></menuchoice>. Alternatively, right-click on the
bookmarks or topic in the bookmarks window, then choose <guimenuitem>Delete</guimenuitem>.</para>
            </listitem>
            </orderedlist>
        </sect2>
    <sect2 id="to-edit-bookmark-properties">
      <title>To Edit a Bookmark's Properties</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-search-bookmarks">
          <title>To Search Your Bookmarks</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-copy-bookmark-address">
          <title>To Copy the Address of a Bookmark</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-add-bookmark-or-topic-to-bookmarks-bar">
          <title>To Add a Bookmark or Topic to the Bookmarks Bar</title>
          <para>You can add a bookmark or topic to the bookmarks bar in the following ways:</para>
        <variablelist>
            <varlistentry>
            <term><guimenu>File</guimenu> menu</term>
            <listitem>
            <para>Select the bookmark or topic you wish to add, and choose 
            <menuchoice>
            <guisubmenu>File</guisubmenu>
            <guimenuitem>Show in Bookmarks Bar</guimenuitem>
            </menuchoice>. </para>
            </listitem>
            </varlistentry>
            <varlistentry>
            <term>Drag and Drop</term>
            <listitem>
            <para>You can drag and drop bookmarks and topics from the bookmarks window onto the bookmarks bar.</para>
            </listitem>
            </varlistentry>
            </variablelist>
        </sect2>
    <sect2 id="to-remove-bookmark-or-topic-from-bookmarks-bar">
          <title>To Remove a Bookmark or Topic From the Bookmarks Bar</title>
          <para>You can remove a bookmark or topic from the bookmarks bar in the following ways:</para>
        <variablelist>
            <varlistentry>
            <term><guimenu>File</guimenu> menu</term>
            <listitem>
            <para>Select the bookmark or topic you wish to remove, and choose 
            <menuchoice>
            <guisubmenu>File</guisubmenu>
            <guimenuitem>Show in Bookmarks Bar</guimenuitem>
            </menuchoice>.</para>
            </listitem>
            </varlistentry>
            <varlistentry>
            <term>Toolbar Editor</term>
            <listitem>
            <para>You can remove bookmarks and topics from the bookmarks bar 
              using the toolbar editor as described in the section
              <xref linkend="to-edit-toolbars"/>.</para>
            </listitem>
            </varlistentry>
            </variablelist>
        </sect2>
    <sect2 id="smart-bookmarks">
          <title>Smart Bookmarks</title>
          <para>
          </para>
        </sect2>
  </sect1>

<!-- ============= Managing Your History Links ================ -->
  <sect1 id="ephy-managing-history">
      <title>Managing Your History Link</title>
      <para>
      </para>
    <sect2 id="overview-of-history">
          <title>Overview of the Epiphany History System</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-select-history">
          <title>To Select History Links</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-open-history-link">
          <title>To Open a History Link in a New Window or Tab</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-delete-history-link">
          <title>To Delete a History Link</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-search-history">
          <title>To Search Your History Links</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-copy-history-link-address">
          <title>To Copy the Address of a History Link</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-bookmark-history-link">
          <title>To Bookmark a History Link</title>
          <para>
          </para>
        </sect2>
  </sect1>

<!-- ============= Managing Your Passwords and Cookies ==== -->
  <sect1 id="ephy-managing-passwords-cookies">
      <title>Managing Your Passwords and Cookies</title>
      <para>
      </para>
  </sect1>

<!-- ============= Using the Download Manager ==== -->
  <sect1 id="ephy-download-manager">
      <title>Using the Download Manager</title>
      <para>
      </para>
  </sect1>

<!-- ============= Customizing Epiphany ==== -->
  <sect1 id="ephy-customiz">
      <title>Customizing &fr;</title>
      <para>
      </para>
    <sect2 id="setting-preferences">
          <title>Setting Your Preferences</title>
          <para>
          </para>
        </sect2>
    <sect2 id="to-show-hide-window-components">
          <title>To Show and Hide Browser Window Components</title>
            <para>You can show and hide browser window components as follows: </para>
            <itemizedlist>
            <listitem>
            <para>To hide the toolbars, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Toolbars</guimenuitem></menuchoice>. To display the
toolbar again, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Toolbars</guimenuitem></menuchoice> again. </para>
            </listitem>
            <listitem>
            <para>To hide the bookmarks bar, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Bookmarks Bar</guimenuitem></menuchoice>. To display
the bookmarks bar again, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Bookmarks Bar</guimenuitem></menuchoice> again.</para>
            </listitem>
            <listitem>
            <para>To hide the statusbar, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Statusbar</guimenuitem></menuchoice>. To display the
statusbar again, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Statusbar</guimenuitem></menuchoice> again. </para>
           </listitem> 
           </itemizedlist>
        </sect2>
    <sect2 id="to-edit-toolbars">
          <title>To Edit Your Toolbars</title>
          <para>
          </para>
        </sect2>
  </sect1>

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

    <para> &fr; was written by Marco Presenti Gritti 
      (<email>marco@it.gnome.org</email>). To find more information
      about &fr;, please visit the <ulink
      url="http://epiphany.mozdev.org" type="http">Epiphany 
      Web page</ulink>. 
    </para>
    <para>
      This manual was written by David Bordoley (<email>bordoley@msu.edu</email>) and Patanjali Somayaji (<email>patanjali@codito.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>