<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> <title> Dillo Web Browser :: Help for New Users </title> </head> <body text="#0f0f0f" link="#2020e0" vlink="#403090" bgcolor="#607cf8"> <table width="100%" bgcolor="#8080f0" cellspacing="4" cellpadding="5" border="0o"> <tr><td><big><font color="#302080">Welcome to Dillo 3</font></big> </table> <p> <table WIDTH="100%" BORDER=1 CELLSPACING=0 CELLPADDING=3> <tr ALIGN=LEFT VALIGN=TOP><td bgcolor="wheat"> <h4><font color="green">Basics:</font></h4> </td></tr> <tr><td WIDTH="100%" bgcolor="#70a0c0"> <ul> <li>You can tell a link from plain content by the hand-shaped cursor. <li> Besides browsing the web, Dillo also has basic file browsing capabilities included. So, entering <code>file:</code> in your Dillo URL window will give you the contents of your current working directory, and <code>file:~</code> entered in the same place will point your Dillo browser right to your home directory... <li> Dillo, at this stage of development, is not ready to render pages that use <b><font color="#5040a0">frames</font></b>. Nevertheless, it comes with a tiny handler (lynx/w3m-like) that will let you choose which frame to visit, one by one. <li> Dillo has <b><font color="#5040a0">context sensitive menus</font></b> using the right mouse button (available on pages, links, images, forms, the Back and Forward buttons, and the bug meter). <li> Some of the functions in Dillo are handled by independent processes. For instance, downloads come through <em><a href="http://www.gnu.org/software/wget/">wget</a></em>. If Dillo exits, the downloads continue (more details below). </ul> </td></tr> </table> <table WIDTH="100%" BORDER=1 CELLSPACING=0 CELLPADDING=3> <tr ALIGN=LEFT VALIGN=TOP><td bgcolor="wheat"> <h4><font color="green">Usage:</font></h4> </td></tr> <tr><td BGCOLOR="#70a0c0"> <ul> <li> You can scroll around your Dillo main window using {PgUp|PgDn|Home|End} or using the mouse middle button or mouse wheel. If nothing happens when keys are pressed, try <b> <font color="#5040a0">focusing</font></b> your Dillo main window first by clicking it (not on any link!:)). <li>You can use the space key as PgDn, and {'b' | 'B'} as PgUp.</li> <li> Similarly, you can use "<b>,</b>" and "<b>.</b>" as shortcuts for forward and backward buttons (mnemonic: those keys are usually labeled "<" and ">"). <li> <b>Configuration:</b> If you want to change Dillo's appearance or behaviour, look at the options in your <b><font color="#5040a0">dillorc</font></b> file (if you don't have a copy in your ~/.dillo/ directory, get it <a href='http://www.dillo.org/dillorc'>here</a>). <li> 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. <li> Dialogs can be closed with the ESC key. (ESC also hides the findbar and control panels) <li> If you want to try a different control panel, right-click over the tools button and select one that suits your needs, then make it the default in your <code>dillorc</code> file. <li> The whole window area can be used to display the page (ESC key). </ul> </td></tr> </table> <table WIDTH="100%" BORDER=1 CELLSPACING=0 CELLPADDING=3> <tr ALIGN=LEFT VALIGN=TOP><td bgcolor="wheat"> <h4><font color="green">Downloads:</font></h4> </td></tr> <tr><td BGCOLOR="#70a0c0"> <p> Downloads are made using <b><font color="#5040a0"> <a href="http://www.gnu.org/software/wget/">wget</a></font></b> with a <a href="http://www.fltk.org">FLTK</a>-based GUI wrapper, through the Dillo plugin (dpi) framework. If you close the browser window, downloads will continue. <p> </td></tr> </table> <table WIDTH="100%" BORDER=1 CELLSPACING=0 CELLPADDING=3> <tr ALIGN=LEFT VALIGN=TOP><td bgcolor="wheat"> <h4><font color="green">Find text:</font></h4> </td></tr> <tr><td bgcolor="#70a0c0"> <p> 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. <p> <u>Semantics:</u> <ul> <li> You can search for substrings, words and sentences. </li> <li> To find a substring or word, just enter its text. </li> <li> To find a left-aligned substring, prepend it with a space. </li> <li> To find a right-aligned substring, append a space to it.</li> <li> To find full words only, prepend and append spaces to them. </li> <li> To find a sentence, enter the words and remember that the above rules apply for every word in it. </li> </ul> <p> Dillo will scroll the page and highlight found text. <p> <small>Default shortcut: [CTRL]+"F".</small> </td></tr> </table> <table WIDTH="100%" BORDER=1 CELLSPACING=0 CELLPADDING=3> <tr ALIGN=LEFT VALIGN=TOP><td bgcolor="wheat"> <h4><font color="green">Copy&Paste:</font></h4> </td></tr> <tr><td bgcolor="#70a0c0"> <p> 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. <p> If you want to select more than one screen, hold the mouse button down and scroll with PgUp, PgDn or the arrow keys. <P> If you want to paste an URL into Dillo, do it on the "clear-URL" button (the "X" next to the location bar). <p> Note: If it doesn't work, please try again. There's a bug lurking there. </td></tr> </table> <table WIDTH="100%" BORDER=1 CELLSPACING=0 CELLPADDING=3> <tr ALIGN=LEFT VALIGN=TOP><td bgcolor="wheat"> <h4><font color="green">Navigation history:</font></h4> </td></tr> <tr><td bgcolor="#70a0c0"> <p> Currently, navigation history supports the navigation-stack model; just right-click on the Back or Forward buttons and they will pop up! <p> <u>Remember:</u> <ul> <li> These history menus are relative to the current page. </li> <li> They show the page-title but the status bar shows the URL. </li> <li> Left-click jumps to the selected item. </li> <li> Middle-click opens the item in a new browser tab/window. </li> </ul> </td></tr> </table> <table WIDTH="100%" BORDER=1 CELLSPACING=0 CELLPADDING=3> <tr ALIGN=LEFT VALIGN=TOP><td bgcolor="wheat"> <h4><font color="green">Cookies:</font></h4> </td></tr> <tr><td bgcolor="#70a0c0"> <p> 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! <p> If you want to enable cookies in dillo, please read <a href="Cookies.txt">Cookies.txt</a>. It's very easy -- just a matter of setting up a <code>cookiesrc</code> file). </td></tr> </table> <table WIDTH="100%" BORDER=1 CELLSPACING=0 CELLPADDING=3> <tr ALIGN=LEFT VALIGN=TOP><td bgcolor="wheat"> <h4><font color="green">Ad blocking:</font></h4> </td></tr> <tr><td bgcolor="#70a0c0"> <p> With a <code>~/.dillo/<a href="http://www.dillo.org/domainrc">domainrc</a></code> file, you can control how dillo handles automatic requests for resources (like images and style sheets) that aren't at the same domain as the original page. </td></tr> </table> <table WIDTH="100%" BORDER=1 CELLSPACING=0 CELLPADDING=3> <tr ALIGN=LEFT VALIGN=TOP><td bgcolor="wheat"> <h4><font color="green">Tabs:</font></h4> </td></tr> <tr><td bgcolor="#70a0c0"> <p> Dillo has tabbed browsing. Just middle click to open a link or submit a form in a new tab. It will be automatically focused. If you want to customize this behaviour, adjust these dillorc options: <ul> <li><code>middle_click_opens_new_tab</code> <li><code>focus_new_tab</code> </ul> Press SHIFT to temporarily reverse the focusing behaviour. <p> You can <b><font color="#5040a0">close</font></b> a tab with middle-click on its label (the default), or with right-click by setting this dillorc option: <ul><li><code>right_click_closes_tab</code></ul> </td></tr> </table> <table WIDTH="100%" BORDER=1 CELLSPACING=0 CELLPADDING=3> <tr ALIGN=LEFT VALIGN=TOP><td bgcolor="wheat"> <h4><font color="green">Images-off mode:</font></h4> </td></tr> <tr><td bgcolor="#70a0c0"> <p> You can browse without images now: <ul> <li>There is an option in the Tools menu to disable automatic image loading. An image's alt text (or <code>[IMG]</code> placeholder) will appear in the page. <li>If you want to load an individual image, left click on its text. <li>You can set "no images" as the default mode in dillorc. </ul> </td></tr> </table> <table WIDTH="100%" BORDER=1 CELLSPACING=0 CELLPADDING=3> <tr ALIGN=LEFT VALIGN=TOP><td bgcolor="wheat"> <h4><font color="green">Bookmarks:</font></h4> </td></tr> <tr><td bgcolor="#70a0c0"> <p> Bookmarks are handled by the Dillo plugin (<a href='http://www.dillo.org/dpi1.html'>dpi</a>) framework. This should be transparent to the end user. Please note that: <ul> <li>It is a good idea to keep a backup of your <code>~/.dillo/bm.txt</code> <li>The server will stay alive after closing dillo. <li>You can stop the server by sending it a KILL signal. Dillo will automatically restart it when it is needed. <li>If you don't have root access, install <em>dpid</em> and the <em>dpis</em> inside your <code>~/.dillo/</code> directory as explained in the README file. </ul> </td></tr> </table> <table WIDTH="100%" BORDER=1 CELLSPACING=0 CELLPADDING=3> <tr ALIGN=LEFT VALIGN=TOP><td bgcolor="wheat"> <h4><font color="green">Bug Meter:</font></h4> </td></tr> <tr><td bgcolor="#70a0c0"> <p> Dillo's <em><a href='http://www.dillo.org/help/bug_meter.html'>Bug meter</a></em> shows the number of <b><font color="#5040a0">detected bugs</font></b> inside the page. The bugs are caught at parsing time, so the error messages also show the line where they occur and provide a <b><font color="#5040a0">hint</font></b> of what was expected instead! <p> The primary purpose of the bug meter is to <b><font color="#5040a0">help</font></b> webmasters and page authors to polish the contents of their sites with a view to making them standards-compliant. <p> The Bug meter is located at the lower right corner of Dillo. Left-click to see the messages, right-click for a menu. </td></tr> </table> <table WIDTH="100%" BORDER=1 CELLSPACING=0 CELLPADDING=3> <tr ALIGN=LEFT VALIGN=TOP><td bgcolor="wheat"> <h4><font color="green">Web search from the Location bar:</font></h4> </td></tr> <tr><td bgcolor="#70a0c0"> <p> Besides the GUI, you can also use the location bar as a CLI for quick web search. You can specify a prefix in <b><font color="#5040a0">dillorc</font></b> for each search engine and use it from the location bar. <p> Example, in dillorc:<br> <blockquote> <code>search_url="dd Duckduckgo http://duckduckgo.com/lite/?kp=-1&q=%s"</code> </blockquote> means you can reach the location bar (CTRL+L), then type: <blockquote> <code>dd dillo browser</code> </blockquote> to web-search with Duckduckgo for the keywords: <code>dillo browser</code>. </td></tr> </table> <table WIDTH="100%" BORDER=1 CELLSPACING=0 CELLPADDING=3> <tr ALIGN=LEFT VALIGN=TOP><td bgcolor="wheat"> <h4><font color="green">Keyboard shortcuts:</font></h4> </td></tr> <tr><td bgcolor="#70a0c0"> <table border=1 width="100%"> <tr><th>Shortcut <th>Mnemonic <th>Function <tr><td>Ctrl-L <td>Location <td>enter a new URL <tr><td>Ctrl-F <td>Find <td>find text <tr><td>Ctrl-S <td>Search <td>search the web <tr><td>Ctrl-R <td>Reload <td>reload current page <tr><td>Ctrl-N <td>New <td>New browser window <tr><td>Ctrl-T <td>Tab <td>New tab <tr><td>Ctrl-W <td>Window <td>quit tab/window <tr><td>Ctrl-O <td>Open <td>Open file <tr><td>Ctrl-U <td>(conventional) <td>view source <tr><td>Ctrl-B <td>Bookmarks <td>view bookmarks <tr><td>Ctrl-Q <td>Quit <td>Quit dillo <tr><td>Back or "<b>,</b>" <td>< <td>previous page <tr><td>Shift-Back or "<b>.</b>" <td>> <td>next page <tr><td>Alt-F <td>File <td>file menu <tr><td>Ctrl-TabKey or Ctrl-PageDown <td>TabKey <td>Next tab <tr><td>Ctrl-Shift-TabKey or Ctrl-PageUp <td>TabKey <td>Previous tab <tr><td>Esc <td>escape <td>close dialog, close findbar,<br> Hide/show control panels </table> <p> You can <b><font color="#5040a0">change</font></b> the bindings using a <code>~/.dillo/<a href="http://www.dillo.org/keysrc">keysrc</a></code> file. </td></tr> </table> </body> </html>