README
1Dillo Viewer: HTML mail viewing in Claws Mail
2-------------------------------------------------
3
4This plugin uses the Dillo (http://www.dillo.org) browser to
5view text/html MIME parts inside Claws Mail.
6
7When the plugin is loaded, if the MIME part to be viewed is of
8text/html type, then the MIME part is saved in a temporary file and
9Dillo is started with special options to embed it inside
10Claws Mail' message view and to "safely" view the part. Dillo is
11also run in the fullwindow mode, where the toolbar, menubar and the
12statusbar are hidden so the message is viewed in a larger area. The
13fullwindow mode is toggled on and off by double clicking on an empty
14part of the page or by clicking on the icon in the lower right corner.
15
16The "safe" viewing of text/html message parts is achieved by using the
17-l (or --local) option of Dillo. This option prevents Dillo from
18retrieving remote web resources, like images. Thus, no connection
19to the Internet is done. If the user wants to view the message
20without this restriction, s/he just reloads the page by clicking on
21the "Reload" button in Dillo's toolbar.
22
23WARNING: This plugin is provided as is. The author does not guarantee
24safe viewing of text/html messages although he tried hard to achieve
25this goal.
26
27What Dillo version should be used?
28----------------------------------
29
30Dillo 0.7.0 was the first version that included the features needed by
31Claws, but it had a small bug where remote resources could be
32accessed even with the --local option (when a BASE element is present
33in the message).
34
35Since 2002-03-16, the CVS tree of Dillo fixed that bug.
36
37Dillo 0.7.2 and newer (up to 3.0.5) do not have that bug, and are the
38recommended versions to be used.
39
40Acknowledgment:
41---------------
42
43The author of this plugin thanks the author of Dillo, Jorge Arellano
44Cid, who accepted to integrate and improve the different patches
45needed for this functionality.
46
47--
48Melvin Hadasht
49