<legalnotice>&FDLNotice;</legalnotice>
<!-- Last update. -->
- <date>2023-02-22</date>
+ <date>2023-04-17</date>
<!-- The version of Privacy Browser this documentation is written for. -->
- <releaseinfo>&privacybrowser; version 0.1</releaseinfo>
+ <releaseinfo>&privacybrowser; version 0.2</releaseinfo>
<!-- Abstract about this handbook -->
<para>
&privacybrowser; is a web browser that respects your privacy.
</para>
+
+ <para>
+ The only way to prevent data from being abused is to prevent it from being collected in the first place.
+ </para>
</abstract>
<!-- This is a set of Keywords for indexing by search engines. -->
<para>
The current Qt 5 packages are in long-term support mode.
- Qt WebEngine 5.15.x is based on <ulink url="https://wiki.qt.io/QtWebEngine/ChromiumVersions">Chromium 87.0.4280.144</ulink> from a feature perspective.
- Security fixes are backported with <ulink url="https://wiki.qt.io/Qt_5.15_Release#Release_Plan">each release</ulink> every couple of months.
+ From a feature perspective, Qt WebEngine 5.15.x is based on <ulink url="https://wiki.qt.io/QtWebEngine/ChromiumVersions">Chromium 87.0.4280.144</ulink>.
+ Security fixes are backported every few months with <ulink url="https://wiki.qt.io/Qt_5.15_Release#Release_Plan">each release</ulink>.
</para>
</sect1>
<para>
<mediaobject>
<imageobject>
- <imagedata fileref="privacybrowser.png" format="PNG"/>
+ <imagedata fileref="privacybrowser-window.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Screenshot</phrase>
<sect2 id="cookies">
<title>Cookies</title>
+ <para>
+ <ulink url="https://en.wikipedia.org/wiki/HTTP_cookie">Cookies</ulink>
+ allow websites to store small pieces of information for a specific host that are sent in the HTTP header every time the browser connects to that host.
+ Privacy Browser allows a maximum of <ulink url="http://browsercookielimits.iain.guru/">180 cookies with a maximum size of 4096 bytes per cookie</ulink> to be set per domain.
+ Cookies are often used to track users across the web, particularly third-party cookies (which are completely blocked in Privacy Browser).
+ They are also used as a security mechanism on websites where you log in to identify it is you as you browse from page to page on a site.
+ </para>
+
<para>
<mediaobject>
<imageobject>
</para>
<para>
- <ulink url="https://en.wikipedia.org/wiki/HTTP_cookie">Cookies</ulink>
- allow websites to store small pieces of information for a specific host that are sent in the HTTP header every time the browser connects to that host.
- Privacy Browser allows a maximum of <ulink url="http://browsercookielimits.iain.guru/">180 cookies with a maximum size of 4096 bytes per cookie</ulink> to be set per domain.
- Cookies are often used to track users across the web, particularly third-party cookies (which are completely blocked in Privacy Browser).
- They are also used as a security mechanism on websites where you log in to identify it is you as you browse from page to page on a site.
- </para>
-
- <para>
+ The cookies dialog is opened from <xref linkend="settings-cookies"/>.
Durable cookies are shared with all tabs that are opened after they are made durable and are preserved even when Privacy Browser is restarted.
This allows users to stay logged in to sites of their choosing. No cookies are durable by default. Making a cookie durable requires specific user interaction.
</para>
<para>
Domain setting make it easy to automatically change JavaScript, local storage, user agent, and other settings when the domain changes.
Domain settings for the current domain can be accessed through the domain settings button at the far right of the URL line edit.
- Domain settings for all domains can be accessed through the settings menu. When domain settings are active, the URL line edit will have a green background.
+ Domain settings for all domains can be accessed through <xref linkend="settings-domain-settings"/>. When domain settings are active, the URL line edit will have a green background.
+ </para>
+ </sect1>
+
+ <!-- HTTP Pings. -->
+ <sect1 id="http-pings">
+ <title>HTTP Pings</title>
+
+ <para>
+ HTTP hyperlinks can have an extra <ulink url="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#ping">ping attribute</ulink> that sends a POST request to a different URL.
+ These HTTP pings are commonly used for tracking.
+ <ulink url="https://www.theregister.com/2019/04/06/apple_safari_changes/">Most browsers</ulink> send HTTP pings without informing the user
+ <ulink url="https://lists.w3.org/Archives/Public/public-html/2018May/0027.html">in any way</ulink>
+ (despite what The Register article says, current versions of FireFox also happily send HTTP pings).
+ </para>
+
+ <para>
+ Privacy Browser blocks all HTTP pings and presents a dialog informing the user every time the current tab attempts to send one.
+ Hopefully, as more people become aware of what HTTP pings are, web sites will become more embarrassed about using them.
+ This is a classic example of how those who wrote the HTTP specs do not have the best interests of internet users at heart. I would like the day to come where they are removed from the specs.
+ </para>
+ </sect1>
+
+ <!-- Spell Checking. -->
+ <sect1 id="spell-checking">
+ <title>Spell Checking</title>
+
+ <para>
+ Privacy Browser uses the binary <filename>.bdic</filename> Hunspell dictionary format <ulink url="https://doc.qt.io/qt-5/qtwebengine-features.html#spellchecker">utilized by Qt WebEngine</ulink>
+ which was <ulink url="https://sites.google.com/a/chromium.org/dev/developers/how-tos/editing-the-spell-checking-dictionaries">created by Google for Chromium</ulink>.
+ Debian’s Hunspell dictionary language packages are slowly adding support for the <filename>.bdic</filename> format. Those which have are listed by Privacy Browser as suggested packages.
+ </para>
+
+ <para>
+ Once a <filename>.bdic</filename> dictionary is installed, it can be enabled in Privacy Browser’s settings.
</para>
</sect1>
</chapter>
<!-- Main Window. -->
<sect1 id="main-window">
- <title>The main &privacybrowser; window</title>
+ <title>Main Window</title>
- <!-- File Menu. -->
+ <!-- File. -->
<sect2>
- <title>The File Menu</title>
+ <title>File</title>
+
+ <variablelist>
+ <!-- New Tab. -->
+ <varlistentry id="file-new-tab">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo>
+ </shortcut>
+ <guimenu>File</guimenu>
+ <guimenuitem>New Tab</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Create a new tab.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- New Window. -->
+ <varlistentry id="file-new-window">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
+ </shortcut>
+ <guimenu>File</guimenu>
+ <guimenuitem>New Window</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Create a new window.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- Print. -->
+ <varlistentry id="file-print">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo>
+ </shortcut>
+ <guimenu>File</guimenu>
+ <guimenuitem>Print</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Print the document.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- Print Preview. -->
+ <varlistentry id="file-print-preview">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Ctrl;&Shift;<keycap>P</keycap></keycombo>
+ </shortcut>
+ <guimenu>File</guimenu>
+ <guimenuitem>Print Preview</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Display the print preview dialog.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- Quit. -->
+ <varlistentry id="file-quit">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
+ </shortcut>
+ <guimenu>File</guimenu>
+ <guimenuitem>Quit</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Quit &privacybrowser;.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect2>
+
+ <!-- Edit. -->
+ <sect2>
+ <title>Edit</title>
+
+ <variablelist>
+ <!-- Find. -->
+ <varlistentry id="edit-find">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo>
+ </shortcut>
+ <guimenu>Edit</guimenu>
+ <guimenuitem>Find</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Display the find toolbar and focus the find text line edit. If the toolbar is already displayed, the find text line edit is refocused and the text it contains is selected.
+ </para>
+ </listitem>
+ </varlistentry>
+
+
+ <!-- Find Next. -->
+ <varlistentry id="edit-find-next">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycap>F3</keycap>
+ </shortcut>
+ <guimenu>Edit</guimenu>
+ <guimenuitem>Find Next</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Find the next entry on the page that matches the specified text. This action is only displayed if the find toolbar is visible.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- Find Previous. -->
+ <varlistentry id="edit-find-previous">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Shift;<keycap>F3</keycap></keycombo>
+ </shortcut>
+ <guimenu>Edit</guimenu>
+ <guimenuitem>Find Previous</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Find the previous entry on the page that matches the specified text. This action is only displayed if the find toolbar is visible.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect2>
+
+ <!-- View. -->
+ <sect2>
+ <title>View</title>
+
+ <variablelist>
+ <!-- Refresh. -->
+ <varlistentry id="view-refresh">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycap>F5</keycap>
+ </shortcut>
+ <guimenu>View</guimenu>
+ <guimenuitem>Refresh</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Reload the website in the current tab.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- Full Screen Mode. -->
+ <varlistentry id="view-full-screen-mode">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo>
+ </shortcut>
+ <guimenu>View</guimenu>
+ <guimenuitem>Full Screen Mode</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Toggle full screen mode. This performs the same action as <xref linkend="f11"/>.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect2>
+
+ <!-- Go. -->
+ <sect2>
+ <title>Go</title>
+
+ <variablelist>
+ <!-- Back. -->
+ <varlistentry id="go-back">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Alt;<keycap>Left</keycap></keycombo>
+ </shortcut>
+ <guimenu>Go</guimenu>
+ <guimenuitem>Back</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Navigate back one step in the current tab’s history. The action is disabled if it is not possible to go back.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- Forward. -->
+ <varlistentry id="go-forward">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Alt;<keycap>Right</keycap></keycombo>
+ </shortcut>
+ <guimenu>Go</guimenu>
+ <guimenuitem>Forward</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Navigate forward one step in the current tab’s history. The action is disabled if it is not possible to go forward.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- Home. -->
+ <varlistentry id="go-home">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Alt;<keycap>Home</keycap></keycombo>
+ </shortcut>
+ <guimenu>Go</guimenu>
+ <guimenuitem>Home</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Load the home page in the current tab.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect2>
+
+ <!-- On-The-Fly Settings. -->
+ <sect2>
+ <title>On-The-Fly Settings</title>
+
+ <!-- User Agent. -->
+ <sect3>
+ <title>User Agent</title>
- <para>
<variablelist>
- <!-- File > New Tab. -->
- <varlistentry id="file-new-tab">
+ <!-- Privacy Browser. -->
+ <varlistentry id="user-agent-privacy-browser">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Ctrl;&Alt;<keycap>P</keycap></keycombo>
+ </shortcut>
+ <guimenu>On-The-Fly Settings</guimenu>
+ <guisubmenu>User Agent</guisubmenu>
+ <guimenuitem>Privacy Browser</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Use the Privacy Browser user agent for the current tab.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- WebEngine Default. -->
+ <varlistentry id="user-agent-webengine-default">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Ctrl;&Alt;<keycap>W</keycap></keycombo>
+ </shortcut>
+ <guimenu>On-The-Fly Settings</guimenu>
+ <guisubmenu>User Agent</guisubmenu>
+ <guimenuitem>WebEngine Default</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Use the WebEngine Default user agent for the current tab.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- Firefox on Linux. -->
+ <varlistentry id="user-agent-firefox-linux">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Ctrl;&Alt;<keycap>F</keycap></keycombo>
+ </shortcut>
+ <guimenu>On-The-Fly Settings</guimenu>
+ <guisubmenu>User Agent</guisubmenu>
+ <guimenuitem>Firefox on Linux</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Use the Firefox on Linux user agent for the current tab.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- Chromium on Linux. -->
+ <varlistentry id="user-agent-chromium-linux">
<term>
<menuchoice>
<shortcut>
- <keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo>
+ <keycombo action="simul">&Ctrl;&Alt;<keycap>C</keycap></keycombo>
</shortcut>
- <guimenu>File</guimenu>
- <guimenuitem>New Tab</guimenuitem>
+ <guimenu>On-The-Fly Settings</guimenu>
+ <guisubmenu>User Agent</guisubmenu>
+ <guimenuitem>Chromium on Linux</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
- <action>Create a new tab.</action>
+ Use the Chromium on Linux user agent for the current tab.
</para>
</listitem>
</varlistentry>
- <!-- File > New Window. -->
- <varlistentry id="file-new-window">
+ <!-- Firefox on Windows. -->
+ <varlistentry id="user-agent-firefox-windows">
<term>
<menuchoice>
<shortcut>
- <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
+ <keycombo action="simul">&Ctrl;&Alt;&Shift;<keycap>F</keycap></keycombo>
</shortcut>
- <guimenu>File</guimenu>
- <guimenuitem>New Window</guimenuitem>
+ <guimenu>On-The-Fly Settings</guimenu>
+ <guisubmenu>User Agent</guisubmenu>
+ <guimenuitem>Firefox on Windows</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
- <action>Create a new window.</action>
+ Use the Firefox on Windows user agent for the current tab.
</para>
</listitem>
</varlistentry>
- <varlistentry id="file-save">
+ <!-- Chrome on Windows. -->
+ <varlistentry id="user-agent-chrome-windows">
<term>
<menuchoice>
<shortcut>
- <keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
+ <keycombo action="simul">&Ctrl;&Alt;&Shift;<keycap>C</keycap></keycombo>
</shortcut>
- <guimenu>File</guimenu>
- <guimenuitem>Save</guimenuitem>
+ <guimenu>On-The-Fly Settings</guimenu>
+ <guisubmenu>User Agent</guisubmenu>
+ <guimenuitem>Chrome on Windows</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
- <action>Saves the document</action>
+ Use the Chrome on Windows user agent for the current tab.
</para>
</listitem>
</varlistentry>
- <varlistentry id="file-quit">
+ <!-- Edge on Windows. -->
+ <varlistentry id="user-agent-edge-windows">
<term>
<menuchoice>
<shortcut>
- <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
+ <keycombo action="simul">&Ctrl;&Alt;<keycap>E</keycap></keycombo>
</shortcut>
- <guimenu>File</guimenu>
- <guimenuitem>Quit</guimenuitem>
+ <guimenu>On-The-Fly Settings</guimenu>
+ <guisubmenu>User Agent</guisubmenu>
+ <guimenuitem>Edge on Windows</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
- <action>Quits</action> &privacybrowser;
+ Use the Edge on Windows user agent for the current tab.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- Safari on macOS. -->
+ <varlistentry id="user-agent-safari-macOS">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Ctrl;&Alt;<keycap>S</keycap></keycombo>
+ </shortcut>
+ <guimenu>On-The-Fly Settings</guimenu>
+ <guisubmenu>User Agent</guisubmenu>
+ <guimenuitem>Safari on macOS</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Use the Safari on macOS user agent for the current tab.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- Custom User Agent. -->
+ <varlistentry id="user-agent-custom">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Alt;&Shift;<keycap>C</keycap></keycombo>
+ </shortcut>
+ <guimenu>On-The-Fly Settings</guimenu>
+ <guisubmenu>User Agent</guisubmenu>
+ <guimenuitem>Custom</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Use the custom user agent for the current tab. This action is only active if a custom user agent is set in the settings.
</para>
</listitem>
</varlistentry>
</variablelist>
- </para>
- </sect2>
+ </sect3>
- <!-- Examples how to use the common menus Settings and Help -->
- <sect2 id="settings-help-menu">
- <title>The Settings and Help Menu</title>
+ <!-- Zoom. -->
+ <sect3>
+ <title>Zoom</title>
- <para>
- &privacybrowser; has the common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu>
- menu items, for more information read the sections about the <ulink url="help:/fundamentals/ui.html#menus-settings"
- >Settings Menu</ulink> and <ulink url="help:/fundamentals/ui.html#menus-help">Help Menu</ulink>
- of the &kde; Fundamentals.
- </para>
+ <variablelist>
+ <!-- Zoom Factor. -->
+ <varlistentry id="on-the-fly-settings-zoom-factor">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Ctrl;&Alt;<keycap>Z</keycap></keycombo>
+ </shortcut>
+ <guimenu>On-The-Fly Settings</guimenu>
+ <guimenuitem>Zoom Factor</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Display the zoom factor dialog.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect3>
+
+ <!-- Search Engine. -->
+ <sect3>
+ <title>Search Engine</title>
+
+ <variablelist>
+ <!-- Mojeek. -->
+ <varlistentry id="search-engine-mojeek">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Ctrl;&Shift;<keycap>M</keycap></keycombo>
+ </shortcut>
+ <guimenu>On-The-Fly Settings</guimenu>
+ <guisubmenu>Search Engine</guisubmenu>
+ <guimenuitem>Mojeek</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Use Mojeek as the search engine.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- Monocles. -->
+ <varlistentry id="search-engine-monocles">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Ctrl;&Shift;<keycap>O</keycap></keycombo>
+ </shortcut>
+ <guimenu>On-The-Fly Settings</guimenu>
+ <guisubmenu>Search Engine</guisubmenu>
+ <guimenuitem>Monocles</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Use Mojeek as the search engine.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- MetaGer. -->
+ <varlistentry id="search-engine-metager">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Ctrl;&Shift;<keycap>E</keycap></keycombo>
+ </shortcut>
+ <guimenu>On-The-Fly Settings</guimenu>
+ <guisubmenu>Search Engine</guisubmenu>
+ <guimenuitem>MetaGer</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Use MetaGer as the search engine.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- Google. -->
+ <varlistentry id="search-engine-google">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Ctrl;&Shift;<keycap>G</keycap></keycombo>
+ </shortcut>
+ <guimenu>On-The-Fly Settings</guimenu>
+ <guisubmenu>Search Engine</guisubmenu>
+ <guimenuitem>Google</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Use Google as the search engine.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- Bing. -->
+ <varlistentry id="search-engine-bing">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Ctrl;&Shift;<keycap>B</keycap></keycombo>
+ </shortcut>
+ <guimenu>On-The-Fly Settings</guimenu>
+ <guisubmenu>Search Engine</guisubmenu>
+ <guimenuitem>Bing</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Use Bing as the search engine.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- Yahoo. -->
+ <varlistentry id="search-engine-yahoo">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Ctrl;&Shift;<keycap>Y</keycap></keycombo>
+ </shortcut>
+ <guimenu>On-The-Fly Settings</guimenu>
+ <guisubmenu>Search Engine</guisubmenu>
+ <guimenuitem>Yahoo</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Use Yahoo as the search engine.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- Custom Search Engine. -->
+ <varlistentry id="search-engine-custom">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Ctrl;&Shift;<keycap>C</keycap></keycombo>
+ </shortcut>
+ <guimenu>On-The-Fly Settings</guimenu>
+ <guisubmenu>Search Engine</guisubmenu>
+ <guimenuitem>Custom</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Use the custom search engine. This action is only active if a custom search engine is set in the settings.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect3>
</sect2>
- <sect2 id="help-menu1">
- <title>The Help Menu</title>
+ <!-- Settings. -->
+ <sect2>
+ <title>Settings</title>
+
+ <variablelist>
+ <!-- Domain Settings. -->
+ <varlistentry id="settings-domain-settings">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo>
+ </shortcut>
+ <guimenu>Settings</guimenu>
+ <guimenuitem>Domain Settings</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Display the domain settings dialog.
+ </para>
+ </listitem>
+ </varlistentry>
+
+
+ <!-- Cookies. -->
+ <varlistentry id="settings-cookies">
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo action="simul">&Ctrl;<keycap>;</keycap></keycombo>
+ </shortcut>
+ <guimenu>Settings</guimenu>
+ <guimenuitem>Cookies</guimenuitem>
+ </menuchoice>
+ </term>
+
+ <listitem>
+ <para>
+ Display the cookies dialog.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect2>
+
+ <!-- Common Settings and Help Entries. -->
+ <sect2 id="common-settings-help-menus">
+ <title>Common Settings and Help Entries</title>
<para>
- &privacybrowser; has the common &kde; <guimenu>Help</guimenu> menu item, for more information read the section
- about the <ulink url="help:/fundamentals/ui.html#menus-help">Help Menu</ulink> of the &kde; Fundamentals.
+ &privacybrowser; has many common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu> menu items.
+ For more information read the sections about the <ulink url="help:/fundamentals/ui.html#menus-settings">Settings Menu</ulink>
+ and <ulink url="help:/fundamentals/ui.html#menus-help">Help Menu</ulink>.
</para>
</sect2>
- <sect2 id="menu-commands">
- <title>Menu Items</title>
+ <!-- Other Commands. -->
+ <sect2>
+ <title>Other Commands</title>
+
+ <variablelist>
+ <!-- F11. -->
+ <varlistentry id="f11">
+ <term>
+ <command>
+ <keycap>F11</keycap>
+ </command>
+ </term>
+
+ <listitem>
+ <para>
+ Toggle full screen mode. This performs the same action as <xref linkend="view-full-screen-mode"/>.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- Escape. -->
+ <varlistentry id="escape">
+ <term>
+ <command>
+ <keycap>&Esc;</keycap>
+ </command>
+ </term>
+
+ <listitem>
+ <para>
+ Escape runs the first command that applies from the following list.
+ </para>
+
+ <itemizedlist>
+ <listitem>
+ <para>
+ Exit full screen browsing.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Clear the find text line edit and the find text highlights.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Hide the find text toolbar.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect2>
+ </sect1>
+
+ <!-- Cookies Dialog. -->
+ <sect1 id="cookies-dialog">
+ <title>Cookies Dialog</title>
- <para>
- Apart from the common &kde; menus described in the <ulink url="help:/fundamentals/ui.html#menus">Menu</ulink>
- chapter of the &kde; Fundamentals documentation &privacybrowser; has these application specific menu entries:
- </para>
+ <para>
+ The cookies dialog is accessed through <xref linkend="settings-cookies"/> (see <xref linkend="cookies"/>).
+ </para>
+
+ <sect2 id="cookies-dialog-commands">
+ <title>Commands</title>
+
+ <variablelist>
+ <!-- Add Cookie. -->
+ <varlistentry id="add-cookie">
+ <term>
+ <command>
+ <keycap>A</keycap>
+ </command>
+ </term>
+
+ <listitem>
+ <para>
+ Open the add cookie dialog.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- Edit Cookie. -->
+ <varlistentry id="edit-cookie">
+ <term>
+ <command>
+ <keycap>E</keycap>
+ </command>
+ </term>
+
+ <listitem>
+ <para>
+ Open the edit cookie dialog. This command is only valid if a cookie is currently selected.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- Delete Cookies. -->
+ <varlistentry id="delete-cookies">
+ <term>
+ <command>
+ <keycap>D</keycap> or <keycap>∇</keycap>
+ </command>
+ </term>
+
+ <listitem>
+ <para>
+ Delete the currently selected cookies. A dialog will confirm the deletion before it is processed.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- Delete All Cookies. -->
+ <varlistentry id="delete-all-cookie">
+ <term>
+ <command>
+ <keycap>L</keycap>
+ </command>
+ </term>
+
+ <listitem>
+ <para>
+ Delete all the cookies. A dialog will confirm the deletion before it is processed.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- Close. -->
+ <varlistentry id="close-cookies-dialog">
+ <term>
+ <command>
+ <keycap>C</keycap> or <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
+ </command>
+ </term>
+
+ <listitem>
+ <para>
+ Close the cookies dialog.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</sect2>
+ </sect1>
- <sect2 id="help-menu2">
- <title>The Help Menu</title>
+ <!-- Save Dialog. -->
+ <sect1 id="save-dialog">
+ <title>Save Dialog</title>
- <para>
- &privacybrowser; has a default &kde; <guimenu>Help</guimenu> menu as described in the
- <ulink url="help:/fundamentals/ui.html#menus-help">&kde; Fundamentals</ulink>
- with two additional entries:
- </para>
+ <para>
+ The save dialog pops up when a download is initiated.
+ </para>
+
+ <sect2 id="save-dialog-commands">
+ <title>Commands</title>
+
+ <variablelist>
+ <!-- Save. -->
+ <varlistentry id="save-dialog-save">
+ <term>
+ <command>
+ <keycap>S</keycap>
+ </command>
+ </term>
+
+ <listitem>
+ <para>
+ Save the file.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <!-- Close. -->
+ <varlistentry id="save-dialog-close">
+ <term>
+ <command>
+ <keycap>C</keycap> or <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
+ </command>
+ </term>
+
+ <listitem>
+ <para>
+ Close the save dialog without saving the file.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</sect2>
</sect1>
</chapter>
<chapter id="faq">
<title>Questions and Answers</title>
- <!-- (OPTIONAL but recommended) This chapter should include all of the silly
- (and not-so-silly) newbie questions that fill up your mailbox. This chapter
- should be reserved for BRIEF questions and answers! If one question uses more
- than a page or so then it should probably be part of the
- "Using this Application" chapter instead. You should use links to
- cross-reference questions to the parts of your documentation that answer them.
- This is also a great place to provide pointers to other FAQ's if your users
- must do some complicated configuration on other programs in order for your
- application work. -->
-
<qandaset id="faqlist">
<qandaentry>
+ <!-- Why are there no questions. -->
<question>
- <para>My Mouse doesn't work. How do I quit &privacybrowser;?</para>
+ <para>Why are there no questions?</para>
</question>
<answer>
- <para>You silly goose! Check out the <link linkend="commands">Commands Section</link> for the answer.</para>
- </answer>
- </qandaentry>
-
- <qandaentry>
- <question>
- <para>Why can I not twiddle my documents?</para>
- </question>
-
- <answer>
- <para>
- You can only twiddle your documents if you have the foobar.lib installed.
- </para>
+ <para>Because Privacy Browser is so perfectly designed that none have ever been asked. Also, because this is the first release and nobody has had a chance to ask them yet. ;)</para>
</answer>
</qandaentry>
</qandaset>
<title>Credits and License</title>
<para>
- Pr
ogram copyright 2016-2017,2021-2023 Soren Stoutner <ulink url="mailto:soren@stoutner.com">soren@stoutner.com</ulink>.
+ Pr
ivacy Browser PC copyright 2016-2017,2021-2023 Soren Stoutner <ulink url="mailto:soren@stoutner.com">soren@stoutner.com</ulink>.
</para>
- <para>
- Translators:
- <itemizedlist>
- <listitem><para>Translations will be added in a future release.</para></listitem>
- </itemizedlist>
- </para>
+ <!-- Program. -->
+ <sect1 id="program">
+ <title>Program</title>
- <!-- The program license. -->
- &underGPL;
+ <para>
+ The source code is available at <ulink url="https://gitweb.stoutner.com/?p=PrivacyBrowserPC.git;a=summary">gitweb.stoutner.com</ulink>
+ or by running <filename>git clone https://git.stoutner.com/PrivacyBrowserPC.git</filename>.
+ </para>
- <para>
- Documentation copyright 2023 Soren Stoutner <ulink url="mailto:soren@stoutner.com">soren@stoutner.com</ulink>.
- </para>
+ <para>
+ Translators:
+ <itemizedlist>
+ <listitem><para>Translations will be added in a future release.</para></listitem>
+ </itemizedlist>
+ </para>
+
+ <!-- The program license. -->
+ &underGPL;
+ </sect1>
+
+ <!-- Documentation. -->
+ <sect1 id="documentation">
+ <title>Documentation</title>
- <!-- The documentation license. -->
- &underFDL;
+ <para>
+ <filename>doc/index.docbook</filename> and <filename>src/com.stoutner.privacybrowser.appdata.xml</filename> are released under the
+ <ulink url="https://www.gnu.org/licenses/fdl-1.3.html">GFDL-1.3 license</ulink> with no Front-Cover or Back-Cover Texts or Invariant Sections.
+ All other documentation is released under the <ulink url="https://www.gnu.org/licenses/gpl-3.0.html">GPLv3+ license</ulink>.
+ </para>
+
+ <!-- The documentation license. -->
+ &underFDL;
+ </sect1>
+
+ <!-- Icons. -->
+ <sect1 id="icons">
+ <title>Icons</title>
+
+ <para>
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="privacybrowser.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Privacy Browser</phrase>
+ </textobject>
+ </inlinemediaobject>
+
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="javascript.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>JavaScript</phrase>
+ </textobject>
+ </inlinemediaobject>
+
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="privacybrowser-monochrome.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Privacy Browser Monochrome</phrase>
+ </textobject>
+ </inlinemediaobject>
+
+ are derived from <filename>security</filename> and <filename>language</filename>, which are part of the <ulink url="https://fonts.google.com/icons">Android Material icon set</ulink>
+ and are released under the <ulink url="https://www.apache.org/licenses/LICENSE-2.0">Apache License 2.0</ulink>. Modifications copyright 2016-2017,2021-2023 Soren Stoutner.
+ The resulting images are released under the <ulink url="https://www.gnu.org/licenses/gpl-3.0.html">GPLv3+ license</ulink>.
+ </para>
+
+ <para>
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="loading.gif" format="GIF"/>
+ </imageobject>
+ <textobject>
+ <phrase>Loading</phrase>
+ </textobject>
+ </inlinemediaobject>
+
+ comes from <ulink url="https://github.com/Codelessly/FlutterLoadingGIFs/blob/master/packages/cupertino_activity_indicator_selective.gif">FlutterLoadingGIFs</ulink>
+ where it is named <filename>cupertino_activity_indicator_selective.gif</filename>.
+ It is released under the <ulink url="https://opensource.org/license/0bsd/">Zero-Clause BSD License</ulink>.
+ </para>
+ </sect1>
</chapter>
</book>
projects / PrivacyBrowserPC.git / blobdiff