<!-- <!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"> -->
<chapter id="preferences">
  <title>Setting Galeon Preferences</title>
  <para>
    <application>Galeon</application> is very configurable.  The
    preferences window is where you will find all the options available to
    customize your browser.  You can open it by clicking the
    <guimenuitem>Preferences</guimenuitem> item in the <link
    linkend="menubar-edit"><guimenu>Edit</guimenu> menu</link>.  On
    the left side, there is a listing of several different categories of
    options.  When you click a subcategory, its
    page will be displayed in the window.
  </para>

  <para>
  <application>Galeon</application> uses the GNOME settings to control the
  theme for the toolbar, icons and spinner. You should alter these settings
  using the <application>GNOME Control Center</application>.
  </para>

  <sect1 id="prefs-general">
    <title>General</title>

      <para>
        <variablelist>

          <varlistentry>
	    <term>Home Page</term>
	    <listitem><para>
	      When <application>Galeon</application> first starts up, it
	      will automatically load the page specified here. Type an
	      address into the entry bar or, if you are currently viewing a
	      page you would like to set as your permanent home page, click
	      the <guibutton>Set to Current</guibutton> button.  If you want
              the "My Portal" page your home page by, type in <userinput>myportal:</userinput>.
       	    </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>On New Page</term>
	    <listitem><para>
	      When opening a new window (or tab), you can have a page
	      loaded automatically.  You can choose to open your home page,
	      the page you last viewed, or a blank page.
       	    </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Save Session on Quit</term>
	    <listitem><para>
	      If the <guibutton>Save session on quit</guibutton>
	      button is checked, your session will always be saved when you
	      exit <application>Galeon</application>.
       	    </para></listitem>
	  </varlistentry>

        </variablelist>
      </para>
    </sect1>

    <sect1 id="prefs-language">
    <title>Language</title>
      <para>
        <variablelist>
          <varlistentry>

	    <term>Languages</term>
	    <listitem><para>
	      This section lets you manage the languages that
	      <application>Galeon</application> requests from Web Sites.
              This option helps a web site return the correct language.
            </para>
            <para>
              To alter the list of languages, choose <guibutton>Edit</guibutton>.
              This opens a dialog that allows the list to be re-ordered, and 
              new languages added and removed.
       	    </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Charsets</term>
	    <listitem><para>
	      You can select the default character set that will be used
	      for text here, and whether this setting should be
	      autodetected.
       	    </para></listitem>
	  </varlistentry>
        </variablelist>
      </para>
    </sect1>

    <sect1 id="prefs-fonts">
    <title>Fonts</title>
      <para>
        <variablelist>

          <varlistentry>
	    <term>Fonts</term>
	    <listitem><para>
	      In this section, you can customize the fonts that the
	      <application>Mozilla</application> rendering engine will use
	      when displaying pages in <application>Galeon</application>.
	      If the <guibutton>Always use these fonts</guibutton> button
	      is checked, these fonts will be used on all pages; otherwise,
	      they will only be used by pages that do not specify their own
	      fonts.  The font sizes selected in the dialog boxes opened by
	      the <guibutton>Serif</guibutton> and
	      <guibutton>Monospace</guibutton> buttons determine the
	      default sizes for all variable- and fixed-width fonts,
	      respectively.  The <guibutton>Min. Size</guibutton>
	      spinbutton allows you to specify the minimum point size for
	      fonts that are displayed.  The default font type, either
	      Serif or Sans Serif, can be selected.  All of these options
	      can be set for each of the encodings listed in the
	      <guilabel>Language encoding</guilabel> box.
	      <tip>
	        <title>Tip</title>
		<para>
		  Make sure you select the appropriate character set in the
		  font browsers for the language that you're using
		  (<literal>iso8859-1</literal> for Western European
		  languages)!  If you don't, your settings may be ignored.
		</para>
	      </tip>
       	    </para></listitem>
	  </varlistentry>
        </variablelist>
      </para>
    </sect1>

    <sect1 id="prefs-tabs">
    <title>Tabs</title>
      <para>
        <variablelist>

          <varlistentry>
	    <term>Tabbed Browsing</term>
	    <listitem>
	    <para>
	      <application>Galeon</application> operates in a "hybrid"
	      browsing mode.  Each browser window contains a notebook which
	      itself can display multiple pages.  You can find more
	      information about this feature in <xref
	      linkend="tabbed-browsing"/>.
	    </para>
	    <para>
	      The <guibutton>Open in tabs by default</guibutton> option
	      causes middle-clicked links to open in new tabs, rather than
	      new windows.  The <guibutton>Jump to new tabs
	      automatically</guibutton> option causes
	      <application>Galeon</application> to automatically switch to
	      newly created tabs.
              The <guibutton>Show tab bar if only one tab is open</guibutton> option
	      causes the tab listing to be shown even when only one tab
	      exists in the window.
	    </para>
	    <para>
	      The <guibutton>Open popups in tabs</guibutton> option causes
	      popup windows opened by pages to appear in tabs, rather than
	      in new windows.  
	    </para>
	    </listitem>
	  </varlistentry>

        </variablelist>
      </para>
    </sect1>

    <sect1 id="prefs-mouse">
    <title>Mouse</title>
      <para>
        <variablelist>

          <varlistentry>
	    <term>Mouse buttons</term> 
            <listitem><para> 
            When you click on a link with the middle mouse button, the link will
	    be opened in a new window or tab.  Middle-button clicks
	    elsewhere in the browser window, though, can be configured
	    to activate mouse gestures, load a URL contained in the
	    clipboard, activate manual scroll, or automatic scroll
	    (like <application>Internet Explorer</application> or to
	    do nothing.  The second option allows you to highlight a
	    URL in, for example, a terminal window and then simply
	    middle click in the browser window to load the URL. Information
            about available mouse gestures can be found in <xref linkend="mouse-gestures"/>.
	    </para>
           </listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Mouse wheel</term>
	    <listitem>
            <para>
	      By default, the mouse wheel scrolls by 1 line.  This can be
              customized to scrollwithin the range of 1 to 100 lines.
            </para>
            </listitem>
	  </varlistentry>

        </variablelist>
      </para>
    </sect1>
    
    <sect1 id="prefs-web-content">
    <title>Web Content</title>
      <para>
        <variablelist>

          <varlistentry>
	    <term>Enable Java</term> 
             <listitem><para> This will enable Java support, assuming that
              you have the appropriate plugin installed.
             </para></listitem>
	  </varlistentry>
          <varlistentry>
	    <term>Javascript</term> 
             <listitem><para> 
             Javascript is a simple language that can be embedded into web pages
             to allow advanced interaction with the user. You can turn off support
             by unchecking the <guibutton>Enable javascript</guibutton> checkbox.
             </para>
             <para>
             Javascript can also open popup windows, most unrequested popup windows
             contain unwanted adverts, so it is advised that you leave the <guibutton>
             Allow unrequested popup windows</guibutton> checkbox empty. You can manage
             which sites are allowed to open unrequested popup windows using the <guibutton>
             Manage popups</guibutton> button, this opens the 
             <link linkend="pdm-popup-sites">Popup Sites page 
             of the Personal Data Manager</link>
             </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Image loading</term>
	    <listitem><para>
	      When images are present in a page, you can choose to always
	      load them, load them only if they come from the current
	      server, or never load them.  Images for banner ads are
	      usually loaded from a different server than the page you are
	      viewing, so selecting "Load from current server only" will
	      often block these banner ads from displaying.  To open the
	      <link linkend="pdm-image-sites">Image Sites page of the
	      Persistent Data Manager</link>, allowing you to block images
	      from specific sites, click the <guibutton>Image
	      Sites</guibutton> button.
       	    </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Animated Images</term>
	    <listitem>
            <para>
              Animated images can be very annoying, and so you can choose
              to continuously animated images, only animate them once, 
              or never animated images.
            </para>
      <note>
        <title>Other techniques</title>
        <para>
        There are techniques for displaying animated images (e.g. flash or javascript) that
        aren't covered by this option.
        </para>
      </note>

            </listitem>
	  </varlistentry>

        </variablelist>
      </para>
    </sect1>
    

    <sect1 id="prefs-privacy">
      <title>Privacy</title>
      <para>
        <variablelist>

          <varlistentry>
	    <term>Cookies</term>
	    <listitem>
	    <para>
	      You can choose to accept all cookies, accept cookies from the
	      current server only, or to not accept any cookies. If you
	      want to be notified when a site attempts to store a cookie on
	      your computer, select the <guibutton>Warn before accepting a
	      cookie</guibutton> checkbox.
       	    </para>
	    <para>
	      Clicking the <guibutton>Cookies...</guibutton> or
	      <guibutton>Cookie Sites...</guibutton> buttons will open the
	      corresponding pages of the <link linkend="pdm">Persistent
	      Data Manager</link>, allowing you to manage the cookies that
	      are being stored and the site-specific cookie policies.
	    </para>
	    </listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Passwords</term>
	    <listitem>
	    <para>
	      <application>Galeon</application> can automatically remember
	      username/password combinations that you enter.  To enable
	      this functionality, check the <guibutton>Remember passwords
	      for sites that require logins</guibutton> button.
       	    </para>
	    <para>
	      Clicking the <guibutton>Passwords...</guibutton> or
	      <guibutton>Password Sites...</guibutton> buttons will open
	      the corresponding pages of the <link linkend="pdm">Persistent
	      Data Manager</link>, allowing you to manage the
	      username/password combinations that are being stored and the
	      listing of sites for which combinations should not be stored.
	    </para>
	    </listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Certificate</term>
	    <listitem>
	    <para>
             Use the <guibutton>Certificates</guibutton> to manage user 
             certificates (such as those used for online banking), and
             Certificate Authorities.
            </para>
           </listitem>
          </varlistentry>
      </variablelist>
     </para>
   </sect1>

  <sect1 id="prefs-network">
  <title>Network</title>
   <para>
       <variablelist>

          <varlistentry>
	    <term>Network Proxy</term>
	    <listitem><para>
              Galeon uses the GNOME proxy setting. Clicking the <guibutton>Configure
              Network Proxy</guibutton> will open the <application>GNOME Network
              preferences</application> program, where you can edit the proxy
              details.
       	    </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Cache</term>
	    <listitem><para>

	      The disk cache stores a local copy of pages and images
	      you have viewed on your hard drive, in order to make
	      browsing of pages that you've already visited faster.
	      If you would like to delete all stored items, click the
	      <guibutton>Clear cache</guibutton> button.
       	    </para></listitem>
	  </varlistentry>

        </variablelist>
      </para>
    </sect1>
</chapter>
