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
|
<html lang="en">
<head>
<title>HTML - The MH-E Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="The MH-E Manual">
<meta name="generator" content="makeinfo 4.8">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Reading-Mail.html#Reading-Mail" title="Reading Mail">
<link rel="prev" href="Viewing-Attachments.html#Viewing-Attachments" title="Viewing Attachments">
<link rel="next" href="Digests.html#Digests" title="Digests">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
This is version 8.0.3 of `The MH-E
Manual', last updated 2006-11-12.
Copyright (C) 1995, 2001, 2002, 2003, 2005, 2006 Free
Software Foundation, Inc.
The MH-E manual is free documentation; you can redistribute it
and/or modify it under the terms of either:
a. the GNU Free Documentation License, Version 1.2 or any later
version published by the Free Software Foundation; with no
Invariant Sections, no Front-Cover Texts, and no Back-Cover
Texts.
b. the GNU General Public License as published by the Free
Software Foundation; either version 2, or (at your option)
any later version.
The MH-E manual is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License or GNU Free Documentation License for more
details.
The GNU General Public License and the GNU Free Documentation
License appear as appendices to this document. You may also
request copies by writing to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
<p>
<a name="HTML"></a>
Next: <a rel="next" accesskey="n" href="Digests.html#Digests">Digests</a>,
Previous: <a rel="previous" accesskey="p" href="Viewing-Attachments.html#Viewing-Attachments">Viewing Attachments</a>,
Up: <a rel="up" accesskey="u" href="Reading-Mail.html#Reading-Mail">Reading Mail</a>
<hr>
</div>
<h3 class="section">6.3 HTML</h3>
<p><a name="index-HTML-610"></a><a name="index-Gnus-611"></a>
MH-E can display messages that have been sent in HTML<a rel="footnote" href="#fn-1" name="fnd-1"><sup>1</sup></a>. The
content of the message will appear in the MH-Show buffer as you would
expect if the entire message is HTML, or there is an inline HTML body
part. However, if there is an HTML body part that is an attachment,
then you'll see a button like this:
<pre class="smallexample"> [1. text/html; foo.html]...
</pre>
<p>To see how to read the contents of this body part, see <a href="Viewing-Attachments.html#Viewing-Attachments">Viewing Attachments</a>.
<p><a name="index-mm_002dtext_002dhtml_002drenderer-612"></a>
The browser that MH-E uses is determined by the option
<code>mm-text-html-renderer</code>. The default setting is set automatically
based upon the presence of a known browser on your system. If you wish
to use a different browser, then set this option accordingly. See the
documentation for the browser you use for additional information on
how to use it. In particular, find and disable the option to render
images as this can tip off spammers that the email address they have
used is valid.
<p><a name="index-mm_002dtext_002dhtml_002drenderer-613"></a>
If you're confused about which <code>mm-text-html-renderer</code> to use,
here's a brief description of each, sorted by popularity, that
includes the results of a quick poll of MH-E users from 2005-12-23.
<a name="index-browser_002c-_0040samp_007bw3m_007d-614"></a>
<a name="index-g_t_0040samp_007bw3m_007d-615"></a>
<a name="index-Mouse_002d2-616"></a>
<a name="index-S_002dMouse_002d2-617"></a>
<dl><dt>`<samp><span class="samp">w3m</span></samp>' 7<dd>The `<samp><span class="samp">w3m</span></samp>' browser requires an external program. It's quick,
produces pretty nice output, and best of all, it's the only browser
that highlights links. These can be clicked with <kbd>Mouse-2</kbd> to view
the content of the link in `<samp><span class="samp">w3m</span></samp>' or with <kbd>S-Mouse-2</kbd> to view
the content of the link in an external browser. The `<samp><span class="samp">w3m</span></samp>' browser
handles tables well and actually respects the table's width parameter
(which can cause text to wrap if the author didn't anticipate that the
page would be viewed in Emacs).
<!-- -->
<a name="index-browser_002c-_0040samp_007bw3m_002dstandalone_007d-618"></a><a name="index-g_t_0040samp_007bw3m_002dstandalone_007d-619"></a><br><dt>`<samp><span class="samp">w3m-standalone</span></samp>' 3<dd>This browser, along with `<samp><span class="samp">nil</span></samp>' for the external browser, are the
only choices that work without having to download a separate lisp
package or external program. This browser is quick, but does not show
links. It handles simple tables but some tables get rendered much
wider than the Emacs frame. This browser was the only one not to
handle the escape `<samp><span class="samp">&ndash;</span></samp>' (it printed a `<samp><span class="samp">?</span></samp>'), but it did
render `<samp><span class="samp">&reg;</span></samp>'.
<!-- -->
<a name="index-browser_002c-_0040samp_007blinks_007d-620"></a><a name="index-g_t_0040samp_007blinks_007d-621"></a><br><dt>`<samp><span class="samp">links</span></samp>' 1<dd>The `<samp><span class="samp">links</span></samp>' browser requires an external program. It's quick, and
produces nicer output than `<samp><span class="samp">lynx</span></samp>' on single column mails in
tables. However, it doesn't show links and it doesn't do as nice a job
on multi-column tables as some lines wrap. At least it fits in 80
columns and thus seems better than `<samp><span class="samp">w3</span></samp>' and
`<samp><span class="samp">w3m-standalone</span></samp>'. Converts escapes such as `<samp><span class="samp">&reg;</span></samp>' to (R).
<!-- -->
<a name="index-browser_002c-_0040samp_007blynx_007d-622"></a><a name="index-g_t_0040samp_007blynx_007d-623"></a><br><dt>`<samp><span class="samp">lynx</span></samp>' 1<dd>The `<samp><span class="samp">lynx</span></samp>' browser requires an external program. It's quick and
produces pretty decent output but it doesn't show links. It doesn't
seem to do multi-column tables which makes output much cleaner. It
centers the output and wraps long lines more than most. Handles
`<samp><span class="samp">&reg;</span></samp>'.
<!-- -->
<br><dt>`<samp><span class="samp">nil</span></samp>' 1<dd>This choice obviously requires an external browser. Like
`<samp><span class="samp">w3m-standalone</span></samp>', it works out of the box. With this setting,
HTML messages have a button for the body part which you can view with
<kbd>K v</kbd> (<code>mh-folder-toggle-mime-part</code>).
<!-- -->
<a name="index-browser_002c-_0040samp_007bw3_007d-624"></a><a name="index-g_t_0040samp_007bw3_007d-625"></a><br><dt>`<samp><span class="samp">w3</span></samp>' 0<dd>This choice does not require an external program as all of the
rendering is done in lisp. You do need to get the package separately.
This browser is <strong>slow</strong>, and doesn't appear to have been updated
since 2001 and the author hasn't responded to my emails. It displays
unknown tags instead of hiding them, so you get to see all the
Microsoft crap in certain messages. Tends to make multi-column tables
wider than even a full-screen Emacs can handle. Like `<samp><span class="samp">w3m</span></samp>', you
can follow links, but you have to find them first as they are not
highlighted. Performs well on single-column tables and handles escapes
such as `<samp><span class="samp">&reg;</span></samp>'.
<!-- -->
<a name="index-browser_002c-_0040samp_007bhtml2text_007d-626"></a><a name="index-g_t_0040samp_007bhtml2text_007d-627"></a><br><dt>`<samp><span class="samp">html2text</span></samp>' 0<dd>The `<samp><span class="samp">html2text</span></samp>' browser requires an external program. I noticed
that it can do some nasty things with simple HTML mails (like filling
the entire message as if it were one paragraph, including signature).
On another message, it displayed half of the HTML tags for some
reason.
</dl>
<p><a name="index-mm_002dtext_002dhtml_002drenderer-628"></a>
For a couple more sources of information about
<code>mm-text-html-renderer</code>,
see section <a href="http://www.gnus.org/manual/emacs-mime_6.html">Display Customization</a> in the <cite>The Emacs MIME Manual</cite> and the the
documentation for the Gnus command <kbd>W h</kbd> (see section
<a href="http://www.gnus.org/manual/gnus_99.html">Article Washing</a> in the
<cite>The Gnus Manual</cite>).
<div class="footnote">
<hr>
<h4>Footnotes</h4><p class="footnote"><small>[<a name="fn-1" href="#fnd-1">1</a>]</small> This
feature depends on a version of Gnus that is at least 5.10.</p>
<p><hr></div>
</body></html>
|
