Next: Customizing Articles, Previous: Using MIME, Up: Article Buffer

### 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 Display Customization. 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 `w3m`.
`gnus-blocked-images`
  External 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")

  This can also be a function to be evaluated. If so, it will be called with the group name as the parameter. The default value is `gnus-block-private-groups`, which will return ‘`"."`’ for anything that isn't a newsgroup. This means that no external images will be fetched as a result of reading mail, so that nobody can use web bugs (and the like) to track whether you've read email.

  Also see Misc Article for `gnus-inhibit-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.