Difference between revisions of "GNOME/Web"

From ArchWiki
Jump to: navigation, search
(update Pkg/AUR templates)
(Tag: wiki-scripts)
 
(51 intermediate revisions by 16 users not shown)
Line 1: Line 1:
[[Category:Web Browser]]
+
[[Category:GNOME]]
 +
[[Category:Web browser]]
 +
[[ja:GNOME Web]]
 +
{{Related articles start}}
 +
{{Related|GNOME}}
 +
{{Related articles end}}
 +
Web is the default web browser for [https://live.gnome.org/ 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 from the [[official repositories]]. 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
+
You can enable filtering by unchecking "Allow advertisements" in application preferences. By default, this will enable the [https://easylist-downloads.adblockplus.org/easylist.txt EasyList] list and is periodically refreshed.
 +
{{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.}}
  
==Flash==
+
==== Managing Subscriptions ====
Adobe Flash Player is a little buggy and an external utility like nspluginwrapper has to be used.
+
Create the file {{ic|~/.config/epiphany/adblock/filters.list}} and populate it with URLs (see [https://easylist.to/ EasyList] and [https://adblockplus.org/en/subscriptions Known Adblock Plus subscriptions]) in a semicolon formatted list:
 +
{{hc|/home/archie/.config/epiphany/adblock/filters.list|<nowiki>
 +
https://easylist.to/easylist/easylist.txt;
 +
https://easylist-downloads.adblockplus.org/easylistdutch.txt;
 +
https://easylist.to/easylist/easyprivacy.txt;
 +
https://easylist.to/easylist/fanboy-annoyance.txt;
 +
https://easylist-downloads.adblockplus.org/antiadblockfilters.txt;
 +
https://easylist-downloads.adblockplus.org/adwarefilters.txt;
 +
https://easylist-downloads.adblockplus.org/malwaredomains_full.txt;
 +
https://raw.githubusercontent.com/liamja/Prebake/master/obtrusive.txt;
 +
https://www.fanboy.co.nz/enhancedstats.txt;</nowiki>
 +
}}
  
$ pacman -S nspluginwrapper flashplugin
+
On next startup, the application fetches the subscriptions and should create a file for each entry as {{ic|~/.config/epiphany/adblock/''32-hex''}}.
$ nspluginwrapper -v -n -a -i
+
  
Epiphany should now be able to echo flash content.
+
=== Web Apps ===
  
== Manage Web Apps ==
+
Web can add ''web app'' launchers to GNOME Shell. To manage and remove them, navigate to {{ic|about:applications}} in Web.
  
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.
+
== Plugins ==
 +
See the main article: [[Browser plugins]]
  
==See also==
+
To find out what plugins are installed/enabled, enter {{ic|about:plugins}} in the address bar.
The appearance of Epiphany's menu entry may vary depending on the DE, so please see their articles for further information:
+
 
*[[GNOME]]
+
=== Flash ===
*[[KDE]]
+
The {{AUR|freshplayerplugin}} package provides an experimental adapter to use {{AUR|chromium-pepper-flash}} with Web, see [[Browser plugins#Flash Player]] for details.
*[[Xfce]]
+
 
 +
== Troubleshooting ==
 +
 
 +
=== Pixelated fonts ===
 +
 
 +
Some websites such as github.com tend to use a bitmap font from X11, named {{ic|Clean}}. To disable bitmap fonts, run:
 +
 
 +
# ln -s /etc/fonts/conf.avail/70-no-bitmaps.conf /etc/fonts/conf.d/
 +
 
 +
=== Font hinting ===
 +
 
 +
Web does not respect GNOME hinting settings, but respects Fontconfig one. Check [[Font configuration]] for further instructions.
 +
 
 +
=== Ad-blocking does not work ===
 +
Close Web and delete the current filters configuration:
 +
rm -r ~/.config/epiphany/adblock/
 +
On restart, the filter should be reset.
 +
 
 +
== See also ==
 +
 
 +
* [https://wiki.gnome.org/Apps/Web Apps/Web - GNOME Wiki!]

Latest revision as of 06:24, 22 August 2016

Related articles

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 from the official repositories. If you want to save login passwords, install gnome-keyring.

Configuration

Blocking advertisements

You can enable filtering by unchecking "Allow advertisements" in application preferences. By default, this will enable the EasyList list and is 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.

Managing Subscriptions

Create the file ~/.config/epiphany/adblock/filters.list and populate it with URLs (see EasyList and Known Adblock Plus subscriptions) in a semicolon formatted list:

/home/archie/.config/epiphany/adblock/filters.list
https://easylist.to/easylist/easylist.txt;
https://easylist-downloads.adblockplus.org/easylistdutch.txt;
https://easylist.to/easylist/easyprivacy.txt;
https://easylist.to/easylist/fanboy-annoyance.txt;
https://easylist-downloads.adblockplus.org/antiadblockfilters.txt;
https://easylist-downloads.adblockplus.org/adwarefilters.txt;
https://easylist-downloads.adblockplus.org/malwaredomains_full.txt;
https://raw.githubusercontent.com/liamja/Prebake/master/obtrusive.txt;
https://www.fanboy.co.nz/enhancedstats.txt;

On next startup, the application fetches the subscriptions and should create a file for each entry as ~/.config/epiphany/adblock/32-hex.

Web Apps

Web can add web app launchers to GNOME Shell. To manage and remove them, navigate to about:applications in Web.

Plugins

See the main article: Browser plugins

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

Flash

The freshplayerpluginAUR package provides an experimental adapter to use chromium-pepper-flashAUR with Web, see Browser plugins#Flash Player for details.

Troubleshooting

Pixelated fonts

Some websites such as github.com tend to use a bitmap font from X11, named Clean. To disable bitmap fonts, run:

# ln -s /etc/fonts/conf.avail/70-no-bitmaps.conf /etc/fonts/conf.d/

Font hinting

Web does not respect GNOME hinting settings, but respects Fontconfig one. Check Font configuration for further instructions.

Ad-blocking does not work

Close Web and delete the current filters configuration:

rm -r ~/.config/epiphany/adblock/

On restart, the filter should be reset.

See also