From 3d4ee81ee4d46445d45fca6e5f212051fb338421 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pawe=C5=82=20Forysiuk?= Date: Fri, 6 Apr 2012 20:14:01 +0200 Subject: [PATCH] Update FAQ from the wiki faq.html was copied from http://wiki.xfce.org/_export/xhtml/midori/faq and all tags were replaced with . A phrase referring to the source was added to the first paragraph. --- data/faq.html | 335 ++++++++++++++++++++++++++++++++------------------ 1 file changed, 215 insertions(+), 120 deletions(-) diff --git a/data/faq.html b/data/faq.html index e4717731..5714c2f4 100644 --- a/data/faq.html +++ b/data/faq.html @@ -7,7 +7,7 @@ midori:faq - + @@ -19,9 +19,9 @@ - +
@@ -32,31 +32,33 @@ var NS='midori';var SIG=' --- //[[christian@twotoasts.de|Christian Dywan]] 2011/ +
  • Proxy servers
    • +
  • Keyboard Hotkeys
    • +
  • Mouse Gestures
    • +
  • User scripts and styles
    +
    • +
    @@ -131,9 +133,9 @@ Midori and all delivered artwork are licensed under the LGPL2.

    - -

    Common problems

    -
    + +

    Common problems

    +
    @@ -193,6 +195,12 @@ Use a smaller toolbar: 

    gtk-toolbar-icon-size = GTK_ICON_SIZE_SMALL_TOOLBAR
    +

    +Only for those not running a complete DE like Xfce, Elementary, etc…
    + +There is a preference: Preferences → Browsing → Toolbar Style: Small icons +

    +

    Enable changing hotkeys while hovering menu items:

    @@ -209,7 +217,34 @@ There appears to be an issue with Glib 2.16. The recommended solution is to upgr
    -

    Flash/ Netscape plugins don't work

    +

    How can I change the cache folder (to tmpfs)?

    +
    + +

    +On Linux and BSD, you can set XDG_CACHE_HOME for all applications, or just Midori. Midori saves icons and cache files in that location. The default is ~/.cache. +

    + +

    +export XDG_CACHE_HOME=/dev/shm +

    + +
    + +

    Flash doesn't work

    +
    + +
    + +

    Windows support

    +
    + +

    +WebKitGTK+ and thusly Midori on Windows doesn't support Flash or any other plugins. If WebKitGTK+ adds the feature in the future, we will support it. For now there's nothing we can do. +

    + +
    + +

    Netscape plugins on Linux, BSD and OS X

    @@ -266,8 +301,6 @@ You need to have GStreamer plugins installed which implement the codecs.

  • You may need gstreamer0.10-alsa for ALSA, depending on your distribution.
    • -
  • With Arch Linux, you may need to install liboil explicitly if it is not installed already (see this bug report).
    -
  • You need plugins for Theora, gstreamer0.10-base and MPEG-4 incluing aac (e.g. gst-plugins-faad), gstreamer0.10-bad. For WebM, you'll need plugins for vorbis (-base), matroska (-good), and vp8 (-bad). Have a look at http://www.gstreamer.net/documentation/plugins.html for details.
  • For Youtube or Vimeo, you need WebKitGTK+ 1.1.20 or newer.
    @@ -293,36 +326,6 @@ icedtea6 version 1.8 and above has been known to crash midori. If this is the c
    • -

    Are SOCKS proxy servers supported?

    -
    - -

    -Currently only HTTP proxy servers are supported directly. A way to use SOCKS on Unix is to use tsocks with SSH as follows: -

    -
      -
    1. Install 'tsocks'
      -
      2. -
    2. Open /etc/tsocks.conf in an editor
      -
      3. -
    3. Type something like this, you can choose the port freely: 
      server = 127.0.0.1
-server_type = 5
-server_port = 5555
      -
      -
      4. -
    4. Open an SSH connection with the same port: 
       ssh -D localhost:5555 myhost.com
      -
      -
      5. -
    5. Run Midori with “tsocks” in front of it: 
       tsocks midori
      -
      -
      6. -
    6. Now you can use for example http://www.whatsmyip.org/ to verify that you are using a SOCKS connection. The IP address should match the one of your SSH host. Remember to keep the SSH login running, and don't suspend it, otherwise it won't work.
      -
      7. -
    7. If the connection fails for some reason, you should see a connection error.
      -
      8. -
    - -
    -

    How do I get rid of the menubar?

    @@ -431,25 +434,79 @@ As of git 2011-03-05 02:40:00 UTC and Midori 0.3.3 you can

    Add a line to ~/.local/share/applications/mimeapps.list:

    -
      x-scheme-handler/magnet=transmission-gtk.desktop
    +
    x-scheme-handler/magnet=transmission-gtk.desktop

    Or install an application which advertises the scheme like so:

    -
      MimeType=x-scheme-handler/magnet;
    +
    MimeType=x-scheme-handler/magnet;

    Note that incomplete .desktop files will silently fail and it will look as if it doesn't exist.

    - -

    Features

    + +

    Spell check

    +
    + +

    +First enable spell checking: +Edit→Preferences→Behavior and check “Enable Spell Checking”. +

    + +

    +Now while typing any errors should get underlined in red. To get suggestions, highlight the word and right-click. Should see a list of suggestions on the top of the menu. +

    + +
    + +

    Privacy

    - -

    Web Applications

    + +

    Blacklist cookies

    +
    + +

    +As of Midori 0.4.4 you can add a hidden option to ~/.config/midori/config like so: +

    +
    site-data-rules=-google.com,-facebook.com,!bugzilla.gnome.org,+bugs.launchpad.net
    +
      +
    1. Values prefixed with ”-” are always blocked
      +
      2. +
    2. Values prefixed with ”+” are always accepted
      +
      3. +
    3. Values prefixed with ”!” are not cleared in Clear Private Data
      +
      4. +
    4. No wildcards.
      +
      5. +
    5. LSO, local storage and application caches ignore all policies.
      +
      6. +
    + +

    +The feature is currently experimental and will change in future versions. +

    + +
    + +

    Adblock

    +
    + +

    +The Advertisement Blocker can be activated under Extensions. It uses the same lists as Adblock Plus. URLs are blocked completely and never loaded. Lists can be added through the option button on the right side in the extension list. +

    + +
    + +

    Modes

    +
    + +
    + +

    Web Applications

    @@ -469,13 +526,13 @@ There are two closely related features to open websites as dedicated windows of

    - -

    Private Browsing

    + +

    Private Browsing

    -
      -
    1. File menu/ App Menu button → Private Browsing
      -
      2. -
    + +

    +File menu/ App Menu button → Private Browsing +

    A private window is a separate process, so crashes don't affect the normal browser session. No sensitive data such as cookies, history or bookmarks are stored. No extensions are loaded. Panels are not available. @@ -495,10 +552,42 @@ The same options available to -a/ –app can be used for private browsing mode.

    - -

    Proxy servers

    + +

    Kiosk mode

    +

    +There is no specific mode, instead you use several command line switches. A typical fullscreen setup with no toolbar that opens about:blank and resets the session after 2 minutes of inactivity for instance: +

    +
    midori -i 120 -e Fullscreen -e Navigationbar -a about:blank
    + +

    +Available commands for -e can be listed with “midori –help-execute”. +

    + +

    +If needed, a customized profile can be created with “midori -c /path/to/folder”. Using the shortcut editor extension, keyboard shortcuts can be removed as needed. Afterwards just append ”-c /path/to/folder” to the kiosk mode command line. +

    + +

    +To restrict pages that can be opened, you can use a regular expression. The expression is a blacklist. To block undesirable sites you can do something like: +

    +
    -b 'youtube|youporn'
    + +

    +By negating the expression you can also whitelist pages. +

    +
    -b '^(?!.*?(gmail|mail\.google|accounts\.google)).*'
    + +

    +Any links outside end up in an error page. All images and other files won't be loaded. +

    + +
    + +

    Proxy servers

    +
    +

    By running a local proxy you can modify web content even before it has reached Midori. That allows you to do things similar to what user scripts and user styles provide and even others that neither is suitable for.

    @@ -545,14 +634,44 @@ Mousehole is a scriptable proxy server written in Ruby.

    - -

    Using the Keyboard

    -
    + +

    Are SOCKS proxy servers supported?

    +
    + +

    +Currently only HTTP proxy servers are supported directly. A way to use SOCKS on Unix is to use tsocks with SSH as follows: +

    +
      +
    1. Install 'tsocks'
      +
      2. +
    2. Open /etc/tsocks.conf in an editor
      +
      3. +
    3. Type something like this, you can choose the port freely: 
      server = 127.0.0.1
+server_type = 5
+server_port = 5555
      +
      +
      4. +
    4. Open an SSH connection with the same port: 
       ssh -D localhost:5555 myhost.com
      +
      +
      5. +
    5. Run Midori with “tsocks” in front of it: 
       tsocks midori
      +
      +
      6. +
    6. Now you can use for example http://www.whatsmyip.org/ to verify that you are using a SOCKS connection. The IP address should match the one of your SSH host. Remember to keep the SSH login running, and don't suspend it, otherwise it won't work.
      +
      7. +
    7. If the connection fails for some reason, you should see a connection error.
      +
      8. +
    - -

    HJKL

    -
    + +

    Keyboard Hotkeys

    +
    + +
    + +

    HJKL

    +

    You can use the Vim-like key bindings [hjkl] to navigate a page. h=left j=down k=up l=right In a picture: @@ -566,9 +685,9 @@ You can also use the arrow keys to do the same.

    - -

    Following Links

    -
    + +

    Following Links

    +

    To enable Hints in Midori [similar to those vimperator provides in Firefox], press . @@ -579,9 +698,9 @@ With hints enabled, type the link number, and press Enter to open the link in th

    - -

    Use Ctrl(+Shift)+Tab to switch between pages

    -
    + +

    Use Ctrl(+Shift)+Tab to switch between pages

    +

    Since Midori 0.3.5 Ctrl+Tab is supported by default. @@ -592,18 +711,18 @@ In older versions you can enable the History List extension under Tools → Exte

    - -

    Customizing keyboard shortcuts

    -
    + +

    Customizing keyboard shortcuts

    +

    Enable the Shortcuts extension Tools → Extensions. To edit a keybinding Tools → Customize Shortcuts…

    - -

    Using Find

    -
    + +

    Using Find

    +

    Default shortcuts for Find are: @@ -612,7 +731,7 @@ Default shortcuts for Find are:

    Find: Ctrl+f ”/” and ”,”
    -FindNext: Ctrl+g
    +FindNext: Ctrl+g and Enter
    FindPrevious: Shift+Ctrl+g
    @@ -627,9 +746,9 @@ When using Ctrl+f to bring up Find, use Ctrl+f again or ESC. When using ”/”

    - -

    Mouse Gestures

    -
    + +

    Mouse Gestures

    +

    By default the right mouse button initiates gestures. @@ -657,28 +776,9 @@ Additionally, there are programs allowing mouse gestures system-wide, for exampl

    - -

    Spell check

    -
    -

    -First enable spell checking: -Edit→Preferences→Behavior and check “Enable Spell Checking”. -

    - -

    -Now while typing any errors should get underlined in red. To get suggestions, highlight the word and right-click. Should see a list of suggestions on the top of the menu. -

    - -
    - -

    User scripts

    -
    - -
    - -

    Overview

    -
    +

    User scripts and styles

    +

    UserScripts are scripts applied on some, or on all web pages. They can modify pages locally to add or alter functionality. That includes fixing bugs in web pages. User scripts are also available in other browsers, in the form of Mozilla's Greasemonkey or Opera's User JavaScript. @@ -737,15 +837,10 @@ You can also use -

    User styles

    + +

    User styles

    -
    - -

    Overview

    -
    -

    User styles are CSS Cascading Style sheets that are loaded locally and applied on top of web pages, similar to User scripts, in order to add or alter functionality and also fix bugs.