<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its"
      xmlns:e="http://projectmallard.org/experimental/"
      xmlns:if="http://projectmallard.org/if/1.0/"
      type="topic" id="default-browser">

  <info>
    <desc>Opening links from an email in a browser and opening the mail composer from an email link on a website.</desc>
    
    <link type="guide" xref="index#common-other-problems" />

    <revision pkgversion="3.8.3" version="0.8" date="2013-07-19" status="final"/>
    <credit type="author">
      <name its:translate="no">Andre Klapper</name>
      <email its:translate="no">ak-47@gmx.net</email>
    </credit>
    
    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
    

  </info>

<title>Opening links in and from the web browser</title>

<!-- For GNOME2 the steps are to define the gconf keys /desktop/gnome/url-handlers/http and /https -->

<section id="browser-to-use">
<title>Change which web browser websites are opened in</title>

<if:choose>
  <if:when test="!platform:gnome-shell !platform:gnome-classic !platform:unity">
<p>In case you use <app>Evolution</app> under a different environment from GNOME,</p>
 <steps>
   <item>
     <p>Open a terminal application.</p>
   </item>
   <item>
<p>Find out the name of the <cmd>.desktop</cmd> file for your preferred browser. Depending on your browser and distribution, the file might be called for example <cmd>epiphany.desktop</cmd>, <cmd>firefox.desktop</cmd>, <cmd>google-chrome.desktop</cmd>, <cmd>konqbrowser.desktop</cmd>, or <cmd>opera-browser.desktop</cmd>. If you are unsure you can look up most <cmd>.desktop</cmd> files in the folder <cmd>/usr/share/applications/</cmd>.</p>
   </item>
   <item>
     <p>Type this command, replace <cmd>browser.desktop</cmd> by the actual filename, and press <key>Enter</key>:</p>
     <p><cmd its:translate="no">
       xdg-settings set default-url-scheme-handler https browser.desktop
     </cmd></p>
   </item>
   <item>
     <p>Type this command, replace <cmd>browser.desktop</cmd> by the actual filename, and press <key>Enter</key>:</p>
     <p><cmd its:translate="no">
       xdg-settings set default-url-scheme-handler http browser.desktop
     </cmd></p>
   </item>
   <item>
     <p><app>Evolution</app> may need to be restarted for the settings to take effect.</p>
   </item>
 </steps>
<note style="tip">
  <p>If the error message "xdg-settings: command not found" is shown, you need to install the package <sys>xdg-utils</sys>.</p>
  <if:choose xmlns:if="http://projectmallard.org/if/1.0/">
    <if:when test="action:install">
      <p><link action="install:xdg-utils" style="button">Install xdg-utils</link></p>
    </if:when>
  </if:choose>
</note>
  </if:when>
<p>Please see <link xref="help:gnome-help/net-default-browser" href="https://help.gnome.org/users/gnome-help/stable/net-default-browser">the GNOME Desktop Help</link>.</p>

<p>If the preferred browser is set as default application but still does not work correctly please contact your distribution via their forum or bug tracker.</p>

<note style="tip">
  <p>If the error message "Could not open the link: Operation not supported" is shown, you need to install the package <sys>gvfs</sys>.</p>
  <if:choose xmlns:if="http://projectmallard.org/if/1.0/">
    <if:when test="action:install">
      <p><link action="install:gvfs" href="https://ftp.gnome.org/pub/gnome/sources/gvfs/" style="button">Install gvfs</link></p>
    </if:when>
  </if:choose>
</note>
</if:choose>
</section>


<section id="email-application-to-use">
<title>Change which mail application is used to write emails</title>

<p>Please see <link xref="help:gnome-help/net-default-email" href="https://help.gnome.org/users/gnome-help/stable/net-default-email">the GNOME Desktop Help</link>.</p>

</section>

<section id="advanced-options">
<title>Advanced options</title>
<note style="advanced"><p>If you have a technical background you can also tweak these settings by defining scheme-handlers in <file>$HOME/.local/share/applications/mimeapps.list</file>.</p></note>
</section>

</page>
