Difference between revisions of "GNOME/Web"

From ArchWiki
Jump to: navigation, search
m (Blocking advertisements: GUI items should be italic.)
 
(73 intermediate revisions by 20 users not shown)
Line 1: Line 1:
[[Category:Web Browser]]
+
[[Category:GNOME]]
 +
[[Category:Web browser]]
 +
[[ja:GNOME Web]]
 +
Web is the default web browser for [[GNOME]].  Web provides a simple and minimalist interface for accessing the internet. Whilst it is developed primarily for GNOME, Web works acceptably in other [[desktop environments]] as well.
  
{{stub}}
+
{{Note|Web was known as [http://projects.gnome.org/epiphany/ Epiphany] prior to version 3.4.  The application was given new descriptive names, one for each supported language. The name ''Epiphany'' is still used in numerous places such as the executable name, some package names, some desktop entries, and some GSettings schemas.}}
[http://projects.gnome.org/epiphany/ Epiphany] is a simple web browser primarily intended for the [[GNOME]] desktop which works acceptably with other desktop environments as well.
 
  
==Installation==
+
== Installation ==
To install Epiphany from the repositories, run:
 
# pacman -S epiphany
 
  
To install Epiphany extensions:
+
Web can be installed by [[install]]ing the {{Pkg|epiphany}} package. If you want to save login passwords, install {{Pkg|gnome-keyring}}.
# pacman -S epiphany-extensions
 
  
If you want to save login passwords, install gnome-keyring:
+
== Configuration ==
# pacman -S gnome-keyring
 
  
If you are using another [[Desktop Environment|desktop environment]] (DE) other than GNOME, you will probably have to create directory {{ic|~/.gnome2/epiphany}}. To do so, type:
+
=== Blocking advertisements ===
$ mkdir -p ~/.gnome2/epiphany
 
  
==Flash==
+
Enabled by default, you can disable it by unchecking ''Try blocking ads'' in ''Preferences''. EasyList, EasyPrivacy and Fanboy-annoyance are default blocking lists. All lists are periodically refreshed.
Adobe Flash Player is a little buggy and an external utility like nspluginwrapper has to be used.
+
{{Note|1=Due to some missing features, for example element hiding, Web misses to block/hide some ads. See the [https://bugzilla.gnome.org/show_bug.cgi?id=757824 related bugreport] for progress.}}
  
$ pacman -S nspluginwrapper flashplugin
+
To get list of currently enabled filters:
$ nspluginwrapper -v -n -a -i
 
  
Epiphany should now be able to echo flash content.
+
$ gsettings get org.gnome.Epiphany adblock-filters
  
== Manage Web Apps ==
+
To set new list of filters, for example [https://github.com/gorhill/uBlock/wiki/Blocking-mode:-easy-mode uBlock Origin default lists]:
  
Since version 3.0, Epiphany can add "web app" launchers to GNOME Shell. You can manage and remove them by typing "about:applications" into the Epiphany address bar.
+
<nowiki>$ gsettings set org.gnome.Epiphany adblock-filters "['https://easylist.to/easylist/easylist.txt', 'https://easylist.to/easylist/easyprivacy.txt', 'https://easylist.to/easylist/fanboy-annoyance.txt', 'https://pgl.yoyo.org/adservers/serverlist.php?hostformat=hosts&showintro=1&mimetype=plaintext', 'https://www.malwaredomainlist.com/hostslist/hosts.txt', 'https://mirror.cedia.org.ec/malwaredomains/justdomains']"</nowiki>
  
==See also==
+
See [https://easylist.to/ EasyList] and [https://adblockplus.org/en/subscriptions Known Adblock Plus subscriptions]) for some of the popular ad blocking lists.
The appearance of Epiphany's menu entry may vary depending on the DE, so please see their articles for further information:
+
 
*[[GNOME]]
+
=== Web applications ===
*[[KDE]]
+
 
*[[Xfce]]
+
Web can create web applications out of websites and add them to desktop menu. To configure and remove them enter {{ic|about:applications}} in the address bar.
 +
 
 +
=== Plugins ===
 +
 
 +
Web uses NPAPI plugins, see the main article: [[Browser plugins]]
 +
 
 +
{{Note|Epiphany doesn't support 'windowed plugins', which use X11 calls under wayland [https://wiki.gnome.org/Apps/Web/Docs/FrequentlyAskedQuestions#Does_Epiphany_support_plugins.3F].}}
 +
 
 +
To find out what plugins are installed/enabled, enter {{ic|about:plugins}} in the address bar.
 +
 
 +
=== Custom stylesheet ===
 +
 
 +
Web supports custom stylesheet you can enable under '''Fonts and style''' in '''Preferences'''.
 +
 
 +
Use example below to set new tab page layout and colors according to Adwaita dark variant:
 +
 
 +
{{hc|~/.config/epiphany/user-stylesheet.css|
 +
#overview {
 +
  background-color: #2E3436 !important;
 +
  max-width: 100% !important;
 +
  max-height: 100% !important;
 +
  position: fixed !important;
 +
}
 +
 
 +
#overview .overview-title {
 +
  color: white !important;
 +
}
 +
}}
 +
 
 +
=== Fonts ===
 +
 
 +
Web does not check GNOME font settings, but checks [[Font configuration]].
 +
 
 +
=== Video ===
 +
 
 +
See [[GStreamer]] for required plugin installation.
 +
 
 +
== See also ==
 +
 
 +
* [https://wiki.gnome.org/Apps/Web Apps/Web - GNOME Wiki!]

Latest revision as of 22:21, 25 February 2018

Web is the default web browser for GNOME. Web provides a simple and minimalist interface for accessing the internet. Whilst it is developed primarily for GNOME, Web works acceptably in other desktop environments as well.

Note: Web was known as Epiphany prior to version 3.4. The application was given new descriptive names, one for each supported language. The name Epiphany is still used in numerous places such as the executable name, some package names, some desktop entries, and some GSettings schemas.

Installation

Web can be installed by installing the epiphany package. If you want to save login passwords, install gnome-keyring.

Configuration

Blocking advertisements

Enabled by default, you can disable it by unchecking Try blocking ads in Preferences. EasyList, EasyPrivacy and Fanboy-annoyance are default blocking lists. All lists are periodically refreshed.

Note: Due to some missing features, for example element hiding, Web misses to block/hide some ads. See the related bugreport for progress.

To get list of currently enabled filters:

$ gsettings get org.gnome.Epiphany adblock-filters

To set new list of filters, for example uBlock Origin default lists:

$ gsettings set org.gnome.Epiphany adblock-filters "['https://easylist.to/easylist/easylist.txt', 'https://easylist.to/easylist/easyprivacy.txt', 'https://easylist.to/easylist/fanboy-annoyance.txt', 'https://pgl.yoyo.org/adservers/serverlist.php?hostformat=hosts&showintro=1&mimetype=plaintext', 'https://www.malwaredomainlist.com/hostslist/hosts.txt', 'https://mirror.cedia.org.ec/malwaredomains/justdomains']"

See EasyList and Known Adblock Plus subscriptions) for some of the popular ad blocking lists.

Web applications

Web can create web applications out of websites and add them to desktop menu. To configure and remove them enter about:applications in the address bar.

Plugins

Web uses NPAPI plugins, see the main article: Browser plugins

Note: Epiphany doesn't support 'windowed plugins', which use X11 calls under wayland [1].

To find out what plugins are installed/enabled, enter about:plugins in the address bar.

Custom stylesheet

Web supports custom stylesheet you can enable under Fonts and style in Preferences.

Use example below to set new tab page layout and colors according to Adwaita dark variant:

~/.config/epiphany/user-stylesheet.css
#overview {
  background-color: #2E3436 !important;
  max-width: 100% !important;
  max-height: 100% !important;
  position: fixed !important;
}

#overview .overview-title {
  color: white !important;
}

Fonts

Web does not check GNOME font settings, but checks Font configuration.

Video

See GStreamer for required plugin installation.

See also