1.5 Display Customization

mm-inline-media-tests

This is an alist where the key is a MIME type, the second element is a function to display the part inline (i.e., inside Emacs), and the third element is a form to be evaled to say whether the part can be displayed inline.

This variable specifies whether a part can be displayed inline, and, if so, how to do it. It does not say whether parts are actually displayed inline.

mm-inlined-types

This, on the other hand, says what types are to be displayed inline, if they satisfy the conditions set by the variable above. It's a list of MIME media types.

mm-automatic-display

This is a list of types that are to be displayed "automatically", but only if the above variable allows it. That is, only inlinable parts can be displayed automatically.

mm-automatic-external-display

This is a list of types that will be displayed automatically in an external viewer.

mm-keep-viewer-alive-types

This is a list of media types for which the external viewer will not be killed when selecting a different article.

mm-attachment-override-types

Some MIME agents create parts that have a content-disposition of `attachment'. This variable allows overriding that disposition and displaying the part inline. (Note that the disposition is only overridden if we are able to, and want to, display the part inline.)

mm-discouraged-alternatives

List of MIME types that are discouraged when viewing `multipart/alternative'. Viewing agents are supposed to view the last possible part of a message, as that is supposed to be the richest. However, users may prefer other types instead, and this list says what types are most unwanted. If, for instance, `text/html' parts are very unwanted, and `text/richtext' parts are somewhat unwanted, you could say something like:

(setq mm-discouraged-alternatives '("text/html" "text/richtext") mm-automatic-display (remove "text/html" mm-automatic-display))

mm-inline-large-images

When displaying inline images that are larger than the window, XEmacs does not enable scrolling, which means that you cannot see the whole image. To prevent this, the library tries to determine the image size before displaying it inline, and if it doesn't fit the window, the library will display it externally (e.g. with `ImageMagick' or `xv'). Setting this variable to t disables this check and makes the library display all inline images as inline, regardless of their size.

mm-inline-override-types

mm-inlined-types may include regular expressions, for example to specify that all `text/.*' parts be displayed inline. If a user prefers to have a type that matches such a regular expression be treated as an attachment, that can be accomplished by setting this variable to a list containing that type. For example assuming mm-inlined-types includes `text/.*', then including `text/html' in this variable will cause `text/html' parts to be treated as attachments.

mm-text-html-renderer

This selects the function used to render HTML. The predefined renderers are selected by the symbols w3, w3m(1), links, lynx, w3m-standalone or html2text. If nil use an external viewer. You can also specify a function, which will be called with a MIME handle as the argument.

mm-inline-text-html-with-images

Some HTML mails might have the trick of spammers using `<img>' tags. It is likely to be intended to verify whether you have read the mail. You can prevent your personal informations from leaking by setting this option to nil (which is the default). It is currently ignored by Emacs/w3. For emacs-w3m, you may use the command t on the image anchor to show an image even if it is nil.(2)

mm-w3m-safe-url-regexp

A regular expression that matches safe URL names, i.e. URLs that are unlikely to leak personal information when rendering HTML email (the default value is `\\`cid:'). If nil consider all URLs safe.

mm-inline-text-html-with-w3m-keymap

You can use emacs-w3m command keys in the inlined text/html part by setting this option to non-nil. The default value is t.

mm-external-terminal-program

The program used to start an external terminal.