4.3 HTML

If you have w3m installed on your system, Gnus can display HTML articles in the article buffer. There are many Gnus add-ons for doing this, using various approaches, but there's one (sort of) built-in method that's used by default.

For a complete overview, consult See section `Display Customization' in The Emacs MIME Manual. This section only describes the default method.

mm-text-html-renderer

If set to gnus-article-html, Gnus will use the built-in method, that's based on curl and w3m.

gnus-blocked-images

Images that have URLs that match this regexp won't be fetched and displayed. For instance, do block all URLs that have the string "ads" in them, do the following:

(setq gnus-blocked-images "ads")

The default is to block all external images.

gnus-html-cache-directory

Gnus will download and cache images according to how gnus-blocked-images is set. These images will be stored in this directory.

gnus-html-cache-size

When gnus-html-cache-size bytes have been used in that directory, the oldest files will be deleted. The default is 500MB.

gnus-html-frame-width

The width to use when rendering HTML. The default is 70.

gnus-max-image-proportion

How big pictures displayed are in relation to the window they're in. A value of 0.7 (the default) means that they are allowed to take up 70% of the width and height of the window. If they are larger than this, and Emacs supports it, then the images will be rescaled down to fit these criteria.

To use this, make sure that you have w3m and curl installed. If you have, then Gnus should display HTML automatically.