Welcome to Dillo 2.0

Introduction:

We really hope you enjoy using Dillo. Please bear in mind that although it's very stable, it's still beta.

Before you get started exploring the web using this program, take a look at the hints and tricks we've collected here which will probably answer some questions that could come to your mind later. :)

Basic things:

• You can tell a link from plain content by the hand-shaped cursor.
• Besides browsing the web, Dillo also has basic file browsing capabilities included. So, entering file: in your Dillo URL window will give you the contents of your current working directory, and file:~ entered in the same place will point your Dillo browser right to your home directory...
• Dillo, at this stage of development, is not not ready to render pages that use frames. Nevertheless, it comes with a tiny handler (lynx/w3m-like) that will let you choose which frame to visit, one by one.
• Dillo has context sensitive menus using the right mouse button (available on pages, links, images, the Back and Forward buttons, and the bug meter).
• Some of the functions in Dillo are handled by independent processes. For instance, downloads come through wget. If Dillo exits, the download can continue (more details below).

Usage:

• You can scroll around your Dillo main window using CTRL+{PgUp|PgDwn|Home|End} or using the mouse middle button or mouse wheel. If nothing happens when keys are pressed, try focusing your Dillo main window first by clicking it (not on any link!:)).
• You can use the space key as PgDn, and {'b' | 'B'} as PgUp.
• Similarly, you can use "," and "." as shortcuts for forward and backward buttons (mnemonic: those keys are usually labeled "<" and ">").
• Configuration: If you want to change Dillo's appearance or behaviour, look at the options in your dillorc file (if you don't have a copy in your ~/.dillo/ directory, get it here).
• Clicking the "Reload" button always requests an end-to-end reload of the page currently viewed, but it will *not* reload embedded images during this process.
• Dialogs can be closed with the ESC key.
• If you want to try a different control panel, right-click over the search button until you find one that suits your needs, then make it the default in your dillorc file.
• The whole window area can be used to display the page. Just hit Ctrl-Space!

Downloads:

Downloads are made using wget with a FLTK2-based GUI wrapper, through the Dillo plugin (dpi) framework. If you close the Dillo window, downloads will continue.

Find text:

This one is very useful; it can be found in the right-mouse-button menu
Find text is tuned for speed so don't hesitate to use it even for minimal searches.

Semantics:

• You can search for substrings, words and sentences.
• To find a substring or word, just enter its text.
• To find a left-aligned substring, prepend it with a space.
• To find a right-aligned substring, append a space to it.
• To find full words only, prepend and append spaces to them.
• To find a sentence, enter the words and remember that the above rules apply for every word in it.

Dillo will scroll the page and highlight found text!

Shortcut: [CTRL]+"F".

Copy&Paste:

Just hold down the left mouse button and move to select the area to copy. To paste, go to the target application and press the middle mouse button.

If you want to select more than one screen, hold the mouse button down and scroll with PgUp, PgDn or the arrow keys.

If you want to paste an URL into Dillo, do it on the "clear-URL" button (the "X" next to the location bar).

Note: If it doesn't work, please try again. There's a bug lurking there.

Navigation history:

Currently, navigation history supports the navigation-stack model; just right-click on the Back or Forward buttons and they will pop up!

Remember:

• These history menus are relative to the current page.
• They show the page-title but the status bar shows the URL.
• Left-click jumps to the selected item.
• Middle-click opens the item in a new browser tab/window.

Cookies:

Due to privacy concerns, cookies are disabled by default. That is, if you just compile and use dillo, it will reject every single cookie sent to it!

If you want to enable cookies in dillo, please read Cookies.txt. It's very easy -- just a matter of setting up a cookiesrc file).

Tabs:

Dillo has tabbed browsing. Just middle click a link to open a new tab. It will be automatically focused. If you want to customize the behaviour, adjust these dillorc options:

• middle_click_opens_new_tab
• focus_new_tab

Images-off mode:

You can browse without images now:

• Click on the lower-right "IMG ON" toggle button to disable them. A text [IMG] placeholder will appear in the page.
• If you want some page's images. Left click on [IMG] to load that specific image, or right click for the "Page" menu and select "Load Images" to load all the images in the page.
• You can set "no images" as the default mode in dillorc.

Bookmarks:

Bookmarks are handled by the Dillo plugin (dpi) framework. This should be transparent to the end user. Please note that:

• It is a good idea to keep a backup of your ~/.dillo/bm.txt
• The server will stay alive after closing dillo.
• You can stop the server by sending it a KILL signal. Dillo will automatically restart it when it is needed.
• If you don't have root access, install dpid and the dpis inside your ~/.dillo/ directory as explained in the README file.

Bug Meter:

Dillo's Bug meter shows the number of detected bugs inside the page. The bugs are caught at parsing time, so the error messages also show the line where they occur and provide a hint of what was expected instead!

The primary purpose of the bug meter is to help webmasters and page authors to polish the contents of their sites with a view to making them standards-compliant.

The Bug meter is located at the lower right corner of Dillo. Left-click to see the messages, right-click for a menu.

(tell me more).

Keyboard shortcuts:

Shortcut             Mnemonic          Function
------------------------------------------------------------
Ctrl-L              "Ctrl-Location"   (enter a new URL)
Ctrl-F              "Ctrl-Find"       (find text)
Ctrl-S              "Ctrl-Search"     (search the web)
Ctrl-R              "Ctrl-Reload"     (reload current page)
Ctrl-N              "Ctrl-New"        (New browser window)
Ctrl-T              "Ctrl-Tab"        (New tab)
Ctrl-Q              "Ctrl-Quit"       (quit tab/window)
Ctrl-O              "Ctrl-Open"       (Open file)
Ctrl-B              "Ctrl-Bookmarks"  (view bookmarks)
Ctrl-Space          "more space!"     (Hide/show controls)
------------------------------------------------------------
Back       or ","   "<"               (previous page)
Shift-Back or "."   ">"               (next page)
Esc                 "escape"          (close dialog)
Alt-F               "File"            (file menu)
Alt-X               "eXit"            (exit Dillo)
------------------------------------------------------------
Shift-Right         Right             (Next tab)
Shift-Left          Left              (Previous tab)
Ctrl-TabKey         TabKey            (Next tab)
Shift-Ctrl-TabKey   TabKey            (Previous tab)
------------------------------------------------------------