summaryrefslogtreecommitdiff
path: root/old/dillo3-help.html
blob: 3256a74c712a23ee179358af349e3b127b06eb1e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
<!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>
<style type="text/css">
   body {margin: 0}
   .sidebar .items {background: #f8f8f8}
   .sidebar h3 {font-size: 1em; margin: 0.4em 0 0.2em 0}
   h1 {color: #67f; margin-top: 0.25em; margin-bottom: 0.25em}
   h3 {color: #56f; background: #f0f0f0}
   .section {background: #f8f8f8; border-color: #e8e8e8; border-style: solid; border-width: 1px; margin-bottom: 0.5em}
   .section h3 {margin-top: 0; margin-bottom: 0.2em}
   ul li {list-style-type: square}
</style>
</head>

<body text="black" link="blue" vlink="#403090" bgcolor="white"
      style="line-height: 1.3">


<table width="100%" cellspacing="0" cellpadding="0"><tr>
<td><img src="db1.png" alt="The Dillo Web Browser">
<td width="100%">
 <img src="db2.png" alt="The Dillo Web Browser" height="124" width="100%">
</table>

<table border="0" cellpadding="15" cellspacing="5" width="100%">
  <tr valign="top">
    <td class="sidebar">
      <h3>Dillo</h3>
      <div class="items">
      <a href="index.html">Home</a><br>
      <a href="screenshots/index.html">Screenshots</a><br>
      <a href="download.html">Download</a><br>
      <a href="FAQ.html" title="Frequently asked questions">FAQ</a><br>
      <a href="Compatibility.html">Compatibility</a><br>
      <a href="http://hg.dillo.org/dillo/raw-file/default/ChangeLog">
             Changelog</a><br>
      <a href="Plans.html">Current Plans</a><br>
      <a href="MList.html">Mailing List</a><br>
      <a href="conferences.html">Conferences</a><br>
      <a href="donations.html">Donate</a><br>
      </div>
      <h3>Users</h3>
      <div class="items">
      <a href="dillo3-help.html">Help</a><br>
      <a href="Icons/index.html">Icons</a><br>
      <a href="help/bug_meter.html">Bug meter</a><br>
      <br>
      </div>
      <h3>Bug Tracker</h3>
      <div class="items">
        <small>[currently broken]</small><br>
        <!--
        <a href="/bugtrack/Dbugtrack.html">Bug Track Intro</a><br>
        <a href="/bugtrack/Dquery.html">View Entries</a><br>
        <a href="/bugtrack/Dinsert.html">Bug Insertion</a><br>
        <a href="/bugtrack/Dvolunteer.html">Volunteering</a><br>
        -->
      </div>
      <h3>Developers</h3>
      <div class="items">
      <a href="developer.html">New Developer</a><br>
      <a href="documentation.html">Documentation</a>&nbsp;*<br>
      <a href="NC_design.html">Naming&amp;Coding</a><br>
      <a href="source.html">Source&nbsp;repository</a><br>
      <a href="dpi1.html">Dpi1 Spec</a><br>
      <a href="CSS.html">CSS Spec</a><br>
      <a href="D_authors.html">Authors</a><br>
      <a href="authors/jcid-email.html">Security contact</a><br>
      </div>
      <h3>Related</h3>
      <div class="items">
        <a href="press.html">Dillo in the Press!</a><br>
        <a href="interview.html">Interview</a><br>
        <a href="interview.es.html">Entrevista</a>
         <img src="chile.png" alt="*"><br>
        <a href="Links.html">Links</a><br>
        <a href="logos/logos.html">Art</a><br>
      </div>
      <p>
      <a href="authors/webmaster-email.html">Webmaster</a>
      <p>
      <a href="http://www.anybrowser.org/campaign/">
         <img src="abblue.gif" width="80" height="15"
              alt="anybrowser"></a>

  <td valign="top" align="left" width="100%">


<div lang=en>
  <span style="text-align: right"><small>
    [<a href='dillo2-help.html'>Dillo-2.x help</a>]
    [<a href='dillo-help.html'>Dillo-0.8.x help</a>]
    </small></span>

<h1>Welcome to Dillo 3</h1>

<div class=section>
<h3>Introduction:</h3>

    We really hope you enjoy using Dillo. Please bear in mind that
    although it's very stable, it's still <b>incomplete</b>.
    <p>
    Before you get started exploring
    the web using this program, please take a look at the
    <b>hints and tricks</b> we have collected here.
</div>

<div class=section>
<h3>Basics:</h3>

    <ul>
      <li>You can tell a link from plain content by the hand-shaped cursor. </li>

      <li> 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...

      <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>
</div>

<div class=section> 
<h3>Usage:</h3>

    <ul>
      <li> You can scroll around your Dillo main window using
           {PgUp|PgDwn|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='dillorc.html'>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<br>
	   (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>
</div>

<div class=section>
<h3>Downloads:</h3>

    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>
</div>

<div class=section>
<h3>Find text:</h3>

    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>
</div>

<div class=section>
<h3>Copy&amp;Paste:</h3>

    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.
</div>

<div class=section>
<h3>Navigation history:</h3>

    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>
</div>

<div class=section>
<h3>Cookies:</h3>

   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).
</div>

<div class=section>
<h3>Trackers/ads/third-party requests:</h3>

   Beginning with version 3.0.3, you can use a
   <code>~/.dillo/<a href='domainrc.html'>domainrc</a></code>
   file to specify what to do when a page requests images or stylesheets from
   a different site, or wants to redirect to a different site. For instance,
   you may want wikipedia to be able to use resources from wikimedia.org but
   you might not want any site to get anything from doubleclick.net.
   <p>
   Note that the default domainrc file, if one has been installed, is rather
   permissive.
</div>

<div class=section>
<h3>Tabs:</h3>

   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>
</div>

<div class=section>
<h3>Images-off mode:</h3>

   You can browse without images:
   <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>
</div>

<div class=section>
<h3>Bookmarks:</h3>

   Bookmarks are handled by the Dillo plugin
   (<a href='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>
</div>

<div class=section>
<h3>Bug Meter:</h3>

   Dillo's <em><a href='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.
</div>

<div class=section>
<h3>Keyboard shortcuts:</h3>
<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>change</b> the bindings using a
<code>~/.dillo/<a href="keysrc.html">keysrc</a></code> file.
</div>

</div>

  </td>

 </tr>
</table>


</body>
</html>