Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add a backend warning when using QtWebKit
- Loading branch information
1 parent
4cb82af
commit 1c6fd6f
Showing
3 changed files
with
129 additions
and
11 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,90 @@ | ||
{% extends "styled.html" %} | ||
|
||
{% block style %} | ||
{{super()}} | ||
.note { | ||
font-size: smaller; | ||
color: grey; | ||
} | ||
|
||
.mono { | ||
font-family: monospace; | ||
} | ||
{% endblock %} | ||
|
||
{% block content %} | ||
<h1>Legacy QtWebKit backend</h1> | ||
|
||
<span class="note">Note this warning will only appear once. Use <span class="mono">:open | ||
qute://backend-warning</span> to show it again at a later time.</span> | ||
|
||
<p> | ||
You're using qutebrowser with the legacy QtWebKit backend. It's still the | ||
default until a few remaining issues are sorted out. If you can, it's | ||
strongly suggested to switch earlier, as legacy QtWebKit has known security | ||
issues and also breaks things on various websites. | ||
</p> | ||
|
||
<h2>Using QtWebEngine instead</h2> | ||
|
||
<span class="note">This is usually the better choice if you aren't using Nouveau graphics, and | ||
don't need any features which are currently unavailable with QtWebEngine (like | ||
the <span class="mono">qute://settings</span> page or caret browsing).</span> | ||
|
||
{% macro install_webengine(package) -%} | ||
You should be able to install <span class="mono">{{ package }}</span> and start qutebrowser with <span class="mono">--backend webengine</span> to use the new backend. | ||
{%- endmacro %} | ||
|
||
{% macro please_open_issue() -%} | ||
If you know more, please <a href="https://github.com/qutebrowser/qutebrowser/issues/new">open an issue</a>! | ||
{%- endmacro %} | ||
|
||
<p> | ||
{% if distribution.parsed == Distribution.ubuntu %} | ||
{% if distribution.version >= version('17.04') %} | ||
{{ install_webengine('python3-pyqt5.qtwebengine') }} | ||
{% elif distribution.version >= version('16.04') %} | ||
QtWebEngine is only available in Ubuntu's repositories since 17.04, but you can <a href="https://github.com/qutebrowser/qutebrowser/blob/master/INSTALL.asciidoc#installing-qutebrowser-with-tox">install qutebrowser via tox</a> with <span class="mono">tox -e mkvenv-pypi</span> to use the new backend. | ||
{% else %} | ||
Unfortunately, no easy way is known to install QtWebEngine on Ubuntu < 16.04. {{ please_open_issue() }} | ||
{% endif %} | ||
{% elif distribution.parsed == Distribution.debian %} | ||
{% if distribution.version >= version('9') %} | ||
{{ install_webengine('python3-pyqt5.qtwebengine') }} | ||
{% else %} | ||
Unfortunately, no easy way is known to install QtWebEngine on Debian < 9. {{ please_open_issue() }} | ||
{% endif %} | ||
{% elif distribution.parsed in [Distribution.arch, Distribution.manjaro] %} | ||
{{ install_webengine('qt5-webengine') }} | ||
{% elif distribution.parsed == Distribution.void %} | ||
{{ install_webengine('python-PyQt5-webengine') }} | ||
{% elif distribution.parsed == Distribution.fedora %} | ||
{{ install_webengine('qt5-qtwebengine') }} | ||
{% elif distribution.parsed == Distribution.opensuse %} | ||
{{ install_webengine('libqt5-qtwebengine') }} | ||
{% else %} | ||
There's no information available for your system. {{ please_open_issue() }} | ||
{% endif %} | ||
</p> | ||
|
||
<h2>Using QtWebKit-NG instead</h2> | ||
|
||
<span class="note" >This is a drop-in replacement for legacy QtWebKit. Note <b>private browsing won't work with it properly</b> until its next release.</span> | ||
|
||
<p> | ||
{% if distribution.parsed == Distribution.debian and distribution.version >= version('9') %} | ||
There are unofficial QtWebKit-NG packages <a href="http://repo.paretje.be/unstable/">available</a>. | ||
{% elif distribution.parsed in [Distribution.ubuntu, Distribution.debian] %} | ||
No easy way is known to install QtWebKit-NG on your system. | ||
There are unofficial QtWebKit-NG packages <a href="http://repo.paretje.be/unstable/">available</a>, but they are intended for Debian Unstable. | ||
{{ please_open_issue() }} | ||
{% elif distribution.parsed in [Distribution.arch, Distribution.manjaro] %} | ||
You should be able to install <span class="mono">qt5-webkit-ng</span> via <span class="mono">pacman</span>. | ||
{% elif distribution.parsed == Distribution.gentoo %} | ||
There's an unofficial <a href="https://gist.github.com/annulen/309569fb61e5d64a703c055c1e726f71">ebuild</a> available. | ||
{% else %} | ||
There's no information available for your system. {{ please_open_issue() }} | ||
{% endif %} | ||
</p> | ||
|
||
{% endblock %} |