X-Git-Url: https://gitweb.stoutner.com/?a=blobdiff_plain;f=doc%2Findex.docbook;h=c9bc6b41d28f114da92b6a8e75b64ebba3fb3e6d;hb=ace098e8677ac0d6468b825c73e65b82c0d6993e;hp=6974073dbd3803477bf5ea404cbe13a864608018;hpb=77a3805e3b7c6ee7daeb2db660bb4b2789b33da2;p=PrivacyBrowserPC.git diff --git a/doc/index.docbook b/doc/index.docbook index 6974073..c9bc6b4 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -48,10 +48,10 @@ &FDLNotice; - 2023-02-22 + 2023-05-08 - &privacybrowser; version 0.1 + &privacybrowser; version 0.3 @@ -59,6 +59,10 @@ &privacybrowser; is a web browser that respects your privacy. + + + The only way to prevent data from being abused is to prevent it from being collected in the first place. + @@ -101,8 +105,8 @@ The current Qt 5 packages are in long-term support mode. - Qt WebEngine 5.15.x is based on Chromium 87.0.4280.144 from a feature perspective. - Security fixes are backported with each release every couple of months. + From a feature perspective, Qt WebEngine 5.15.x is based on Chromium 87.0.4280.144. + Security fixes are backported every few months with each release. @@ -141,7 +145,7 @@ - + Screenshot @@ -182,6 +186,14 @@ Cookies + + Cookies + 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 180 cookies with a maximum size of 4096 bytes per cookie 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. + + @@ -194,14 +206,7 @@ - Cookies - 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 180 cookies with a maximum size of 4096 bytes per cookie 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. - - - + The cookies dialog is opened from . 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. @@ -293,7 +298,41 @@ 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 . When domain settings are active, the URL line edit will have a green background. + + + + + + HTTP Pings + + + HTTP hyperlinks can have an extra ping attribute that sends a POST request to a different URL. + These HTTP pings are commonly used for tracking. + Most browsers send HTTP pings without informing the user + in any way + (despite what The Register article says, current versions of FireFox also happily send HTTP pings). + + + + 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. + + + + + + Spell Checking + + + Privacy Browser uses the binary .bdic Hunspell dictionary format utilized by Qt WebEngine + which was created by Google for Chromium. + Debian’s Hunspell dictionary language packages are slowly adding support for the .bdic format. Those which have are listed by Privacy Browser as suggested packages. + + + + Once a .bdic dictionary is installed, it can be enabled in Privacy Browser’s settings. @@ -304,167 +343,957 @@ - The main &privacybrowser; window + Main Window + + + + File + + + + + + + + &Ctrl;T + + File + New Tab + + + + + + Create a new tab. + + + + + + + + + + &Ctrl;N + + File + New Window + + + + + + Create a new window. + + + + + + + + + + &Ctrl;P + + File + Print + + + + + + Print the document. + + + + + + + + + + &Ctrl;&Shift;P + + File + Print Preview + + + + + + Display the print preview dialog. + + + + + + + + + + &Ctrl;Q + + File + Quit + + + + + + Quit &privacybrowser;. + + + + + - + - The File Menu + Edit + + + + + + + + &Ctrl;F + + Edit + Find + + + + + + 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. + + + + + + + + + + + F3 + + Edit + Find Next + + + + + + Find the next entry on the page that matches the specified text. This action is only displayed if the find toolbar is visible. + + + + + + + + + + &Shift;F3 + + Edit + Find Previous + + + + + + Find the previous entry on the page that matches the specified text. This action is only displayed if the find toolbar is visible. + + + + + + + + + View + + + + + + + + F5 + + View + Refresh + + + + + + Reload the website in the current tab. + + + + + + + + + + &Ctrl;&Shift;F + + View + Full Screen Mode + + + + + + Toggle full screen mode. This performs the same action as . + + + + + + + + + Go + + + + + + + + &Alt;Left + + Go + Back + + + + + + Navigate back one step in the current tab’s history. The action is disabled if it is not possible to go back. + + + + + + + + + + &Alt;Right + + Go + Forward + + + + + + Navigate forward one step in the current tab’s history. The action is disabled if it is not possible to go forward. + + + + + + + + + + &Alt;Home + + Go + Home + + + + + + Load the home page in the current tab. + + + + + + + + + On-The-Fly Settings + + + + User Agent - - - + + + + + + &Ctrl;&Alt;P + + On-The-Fly Settings + User Agent + Privacy Browser + + + + + + Use the Privacy Browser user agent for the current tab. + + + + + + - &Ctrl;T + &Ctrl;&Alt;W - File - New Tab + On-The-Fly Settings + User Agent + WebEngine Default - Create a new tab. + Use the WebEngine Default user agent for the current tab. - - + + - &Ctrl;N + &Ctrl;&Alt;F - File - New Window + On-The-Fly Settings + User Agent + Firefox on Linux - Create a new window. + Use the Firefox on Linux user agent for the current tab. - + + - &Ctrl;S + &Ctrl;&Alt;C - File - Save + On-The-Fly Settings + User Agent + Chromium on Linux - Saves the document + Use the Chromium on Linux user agent for the current tab. - + + - &Ctrl;Q + &Ctrl;&Alt;&Shift;F - File - Quit + On-The-Fly Settings + User Agent + Firefox on Windows - Quits &privacybrowser; + Use the Firefox on Windows user agent for the current tab. + + + + + + + + + + &Ctrl;&Alt;&Shift;C + + On-The-Fly Settings + User Agent + Chrome on Windows + + + + + + Use the Chrome on Windows user agent for the current tab. + + + + + + + + + + &Ctrl;&Alt;E + + On-The-Fly Settings + User Agent + Edge on Windows + + + + + + Use the Edge on Windows user agent for the current tab. + + + + + + + + + + &Ctrl;&Alt;S + + On-The-Fly Settings + User Agent + Safari on macOS + + + + + + Use the Safari on macOS user agent for the current tab. + + + + + + + + + + &Alt;&Shift;C + + On-The-Fly Settings + User Agent + Custom + + + + + + Use the custom user agent for the current tab. This action is only active if a custom user agent is set in the settings. - - + - - - The Settings and Help Menu + + + Zoom - - &privacybrowser; has the common &kde; Settings and Help - menu items, for more information read the sections about the Settings Menu and Help Menu - of the &kde; Fundamentals. - + + + + + + + &Ctrl;&Alt;Z + + On-The-Fly Settings + Zoom Factor + + + + + + Display the zoom factor dialog. + + + + + + + + + Search Engine + + + + + + + + &Ctrl;&Shift;M + + On-The-Fly Settings + Search Engine + Mojeek + + + + + + Use Mojeek as the search engine. + + + + + + + + + + &Ctrl;&Shift;O + + On-The-Fly Settings + Search Engine + Monocles + + + + + + Use Mojeek as the search engine. + + + + + + + + + + &Ctrl;&Shift;E + + On-The-Fly Settings + Search Engine + MetaGer + + + + + + Use MetaGer as the search engine. + + + + + + + + + + &Ctrl;&Shift;G + + On-The-Fly Settings + Search Engine + Google + + + + + + Use Google as the search engine. + + + + + + + + + + &Ctrl;&Shift;B + + On-The-Fly Settings + Search Engine + Bing + + + + + + Use Bing as the search engine. + + + + + + + + + + &Ctrl;&Shift;Y + + On-The-Fly Settings + Search Engine + Yahoo + + + + + + Use Yahoo as the search engine. + + + + + + + + + + &Ctrl;&Shift;C + + On-The-Fly Settings + Search Engine + Custom + + + + + + Use the custom search engine. This action is only active if a custom search engine is set in the settings. + + + + + + + + + + Settings + + + + + + + + &Ctrl;D + + Settings + Domain Settings + + + + + + Display the domain settings dialog. + + + + + + + + + + + &Ctrl;; + + Settings + Cookies + + + + + + Display the cookies dialog. + + + + - - The Help Menu + + + Common Settings and Help Entries - &privacybrowser; has the common &kde; Help menu item, for more information read the section - about the Help Menu of the &kde; Fundamentals. + &privacybrowser; has many common &kde; Settings and Help menu items. + For more information read the sections about the Settings Menu + and Help Menu. - - Menu Items + + + Other Commands + + + + + + + F11 + + + + + + Toggle full screen mode. This performs the same action as . + + + + + + + + + &Esc; + + + + + + Escape runs the first command that applies from the following list. + + + + + + Exit full screen browsing. + + + + + + Clear the find text line edit and the find text highlights. + + + + + + Hide the find text toolbar. + + + + + + + + - - Apart from the common &kde; menus described in the Menu - chapter of the &kde; Fundamentals documentation &privacybrowser; has these application specific menu entries: - + + + Cookies Dialog + + + The cookies dialog is accessed through (see ). + + + + Commands + + + + + + + A + + + + + + Open the add cookie dialog. + + + + + + + + + E + + + + + + Open the edit cookie dialog. This command is only valid if a cookie is currently selected. + + + + + + + + + D or + + + + + + Delete the currently selected cookies. A dialog will confirm the deletion before it is processed. + + + + + + + + + L + + + + + + Delete all the cookies. A dialog will confirm the deletion before it is processed. + + + + + + + + + C or &Ctrl;Q + + + + + + Close the cookies dialog. + + + + + - - The Help Menu + + + Save Dialog - - &privacybrowser; has a default &kde; Help menu as described in the - &kde; Fundamentals - with two additional entries: - + + The save dialog pops up when a download is initiated. + + + + Commands + + + + + + + S + + + + + + Save the file. + + + + + + + + + C or &Ctrl;Q + + + + + + Close the save dialog without saving the file. + + + + + + + Changelog + + + + 0.3 - 8 May 2023 + + + Add the changelog to the Handbook. + Add the missing current domain settings icon on Gnome and Xfce. + Make changes to build on Guix. + + + + + + <ulink url="https://www.stoutner.com/privacy-browser-pc-0-2/">0.2</ulink> - + <ulink url="https://gitweb.stoutner.com/?p=PrivacyBrowserPC.git;a=commitdiff;h=44b5d3a1f6a5e7fc2aa8530845f26eba7bc26f9a">17 April 2023</ulink> + + + Fix a crash on GNOME when downloading a file with local storage disabled. + Fix problems with missing + icons on GNOME. + Display an animated favorite icon while a webpage is loading. + Fix the Handbook on non-KDE systems. + Change the order of entries in the WebEngine context menu. + Make spellcheck languages easier to click on. + Only generate a HTTP ping dialog if the request is made by the current tab. + Add a section to the Handbook about HTTP pings. + + + + + + <ulink url="https://www.stoutner.com/privacy-browser-pc-0-1/">0.1</ulink> - + <ulink url="https://gitweb.stoutner.com/?p=PrivacyBrowserPC.git;a=commitdiff;h=73459c6685ec5e58d776f2594c9b587802363b1c">11 March 2023</ulink> + + + Initial release. + + + + Questions and Answers - - + - My Mouse doesn't work. How do I quit &privacybrowser;? + Why are there no questions? - You silly goose! Check out the Commands Section for the answer. - - - - - - Why can I not twiddle my documents? - - - - - You can only twiddle your documents if you have the foobar.lib installed. - + Because Privacy Browser is so perfectly designed that none have ever been asked. Also, because this is an alpha release and nobody has had a chance to ask them yet. ;) @@ -475,24 +1304,94 @@ Credits and License - Program copyright 2016-2017,2021-2023 Soren Stoutner soren@stoutner.com. + Privacy Browser PC copyright 2016-2017,2021-2023 Soren Stoutner soren@stoutner.com. - - Translators: - - Translations will be added in a future release. - - + + + Program + + + The source code is available at gitweb.stoutner.com + or by running git clone https://git.stoutner.com/PrivacyBrowserPC.git. + - - &underGPL; + + Translators: + + Translations will be added in a future release. + + - - Documentation copyright 2023 Soren Stoutner soren@stoutner.com. - + + &underGPL; + + + + + Documentation - - &underFDL; + + doc/index.docbook and src/com.stoutner.privacybrowser.appdata.xml are released under the + GFDL-1.3 license with no Front-Cover or Back-Cover Texts or Invariant Sections. + All other documentation is released under the GPLv3+ license. + + + + &underFDL; + + + + + Icons + + + + + + + + Privacy Browser + + + + + + + + + JavaScript + + + + + + + + + Privacy Browser Monochrome + + + + are derived from security and language, which are part of the Android Material icon set + and are released under the Apache License 2.0. Modifications copyright 2016-2017,2021-2023 Soren Stoutner. + The resulting images are released under the GPLv3+ license. + + + + + + + + + Loading + + + + comes from FlutterLoadingGIFs + where it is named cupertino_activity_indicator_selective.gif. + It is released under the Zero-Clause BSD License. + +