1 ;;; mm-view.el --- functions for viewing MIME objects
2 ;; Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004
3 ;; Free Software Foundation, Inc.
5 ;; Author: Lars Magne Ingebrigtsen <larsi@gnus.org>
6 ;; This file is part of GNU Emacs.
8 ;; GNU Emacs is free software; you can redistribute it and/or modify
9 ;; it under the terms of the GNU General Public License as published by
10 ;; the Free Software Foundation; either version 2, or (at your option)
13 ;; GNU Emacs is distributed in the hope that it will be useful,
14 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
15 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 ;; GNU General Public License for more details.
18 ;; You should have received a copy of the GNU General Public License
19 ;; along with GNU Emacs; see the file COPYING. If not, write to the
20 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
21 ;; Boston, MA 02111-1307, USA.
27 (eval-when-compile (require 'cl))
29 (require 'gnus-mailcap)
34 (autoload 'gnus-article-prepare-display "gnus-art")
35 (autoload 'vcard-parse-string "vcard")
36 (autoload 'vcard-format-string "vcard")
37 (autoload 'fill-flowed "flow-fill")
38 (autoload 'html2text "html2text"))
40 (defvar mm-text-html-renderer-alist
41 '((w3 . mm-inline-text-html-render-with-w3)
42 (w3m . mm-inline-text-html-render-with-w3m)
43 (w3m-standalone mm-inline-render-with-stdin nil
44 "w3m" "-dump" "-T" "text/html")
45 (links mm-inline-render-with-file
46 mm-links-remove-leading-blank
48 (lynx mm-inline-render-with-stdin nil
49 "lynx" "-dump" "-force_html" "-stdin" "-nolist")
50 (html2text mm-inline-render-with-function html2text))
51 "The attributes of renderer types for text/html.")
53 (defvar mm-text-html-washer-alist
54 '((w3 . gnus-article-wash-html-with-w3)
55 (w3m . gnus-article-wash-html-with-w3m)
56 (w3m-standalone mm-inline-wash-with-stdin nil
57 "w3m" "-dump" "-T" "text/html")
58 (links mm-inline-wash-with-file
59 mm-links-remove-leading-blank
61 (lynx mm-inline-wash-with-stdin nil
62 "lynx" "-dump" "-force_html" "-stdin" "-nolist")
63 (html2text html2text))
64 "The attributes of washer types for text/html.")
66 (defcustom mm-fill-flowed t
67 "If non-nil a format=flowed article will be displayed flowed."
71 ;;; Internal variables.
74 ;;; Functions for displaying various formats inline
77 (defun mm-inline-image-emacs (handle)
78 (let ((b (point-marker))
80 (put-image (mm-get-image handle) b)
82 (mm-handle-set-undisplayer
88 (delete-region b (+ b 2)))))))
90 (defun mm-inline-image-xemacs (handle)
93 (let ((annot (make-annotation (mm-get-image handle) nil 'text))
95 (mm-handle-set-undisplayer
98 (let ((b ,(point-marker))
100 (delete-annotation ,annot)
101 (delete-region (- b 2) b))))
102 (set-extent-property annot 'mm t)
103 (set-extent-property annot 'duplicable t)))
106 (if (featurep 'xemacs)
107 (defalias 'mm-inline-image 'mm-inline-image-xemacs)
108 (defalias 'mm-inline-image 'mm-inline-image-emacs)))
110 (defvar mm-w3-setup nil)
111 (defun mm-setup-w3 ()
118 (setq mm-w3-setup t)))
120 (defun mm-inline-text-html-render-with-w3 (handle)
122 (let ((text (mm-get-part handle))
124 (url-standalone-mode t)
125 (url-gateway-unplugged t)
126 (w3-honor-stylesheets nil)
128 (url-generic-parse-url (format "cid:%s" (mm-handle-id handle))))
129 (width (window-width))
130 (charset (mail-content-type-get
131 (mm-handle-type handle) 'charset)))
133 (insert (if charset (mm-decode-string text charset) text))
135 (narrow-to-region b (point))
137 (goto-char (point-min))
138 (when (or (and (boundp 'w3-meta-content-type-charset-regexp)
140 w3-meta-content-type-charset-regexp nil t))
141 (and (boundp 'w3-meta-charset-content-type-regexp)
143 w3-meta-charset-content-type-regexp nil t)))
145 (let ((bsubstr (buffer-substring-no-properties
148 (if (fboundp 'w3-coding-system-for-mime-charset)
149 (w3-coding-system-for-mime-charset bsubstr)
150 (mm-charset-to-coding-system bsubstr))))
151 (delete-region (point-min) (point-max))
152 (insert (mm-decode-string text charset))))
153 (save-window-excursion
155 (let ((w3-strict-width width)
156 ;; Don't let w3 set the global version of
158 (fill-column fill-column))
159 (if (or debug-on-error debug-on-quit)
160 (w3-region (point-min) (point-max))
162 (w3-region (point-min) (point-max))
164 (delete-region (point-min) (point-max))
166 (charset (mail-content-type-get
167 (mm-handle-type handle) 'charset)))
168 (if (or (eq charset 'gnus-decoded)
169 (eq mail-parse-charset 'gnus-decoded))
171 (narrow-to-region (point) (point))
172 (mm-insert-part handle)
173 (goto-char (point-max)))
174 (insert (mm-decode-string (mm-get-part handle)
177 "Error while rendering html; showing as text/plain")))))))
178 (mm-handle-set-undisplayer
181 (let (buffer-read-only)
182 (if (functionp 'remove-specifier)
183 (mapcar (lambda (prop)
185 (face-property 'default prop)
187 '(background background-pixmap foreground)))
188 (delete-region ,(point-min-marker)
189 ,(point-max-marker)))))))))
191 (defvar mm-w3m-setup nil
192 "Whether gnus-article-mode has been setup to use emacs-w3m.")
194 (defun mm-setup-w3m ()
195 "Setup gnus-article-mode to use emacs-w3m."
198 (unless (assq 'gnus-article-mode w3m-cid-retrieve-function-alist)
199 (push (cons 'gnus-article-mode 'mm-w3m-cid-retrieve)
200 w3m-cid-retrieve-function-alist))
201 (setq mm-w3m-setup t))
202 (setq w3m-display-inline-images mm-inline-text-html-with-images))
204 (defun mm-w3m-cid-retrieve-1 (url handle)
205 (if (mm-multiple-handles handle)
206 (dolist (elem handle)
207 (mm-w3m-cid-retrieve-1 url elem))
208 (when (and (listp handle)
209 (equal url (mm-handle-id handle)))
210 (mm-insert-part handle)
211 (throw 'found-handle (mm-handle-media-type handle)))))
213 (defun mm-w3m-cid-retrieve (url &rest args)
214 "Insert a content pointed by URL if it has the cid: scheme."
215 (when (string-match "\\`cid:" url)
217 (mm-w3m-cid-retrieve-1 (concat "<" (substring url (match-end 0)) ">")
218 (with-current-buffer w3m-current-buffer
219 gnus-article-mime-handles)))))
221 (defun mm-inline-text-html-render-with-w3m (handle)
222 "Render a text/html part using emacs-w3m."
224 (let ((text (mm-get-part handle))
226 (charset (mail-content-type-get (mm-handle-type handle) 'charset)))
228 (insert (if charset (mm-decode-string text charset) text))
230 (narrow-to-region b (point))
232 (goto-char (point-min))
233 (when (setq charset (w3m-detect-meta-charset))
234 (delete-region (point-min) (point-max))
235 (insert (mm-decode-string text charset))))
236 (let ((w3m-safe-url-regexp mm-w3m-safe-url-regexp)
238 (w3m-region (point-min) (point-max) nil charset))
239 (when (and mm-inline-text-html-with-w3m-keymap
240 (boundp 'w3m-minor-mode-map)
243 (point-min) (point-max)
244 (list 'keymap w3m-minor-mode-map
245 ;; Put the mark meaning this part was rendered by emacs-w3m.
246 'mm-inline-text-html-with-w3m t))))
247 (mm-handle-set-undisplayer
250 (let (buffer-read-only)
251 (if (functionp 'remove-specifier)
252 (mapcar (lambda (prop)
254 (face-property 'default prop)
256 '(background background-pixmap foreground)))
257 (delete-region ,(point-min-marker)
258 ,(point-max-marker))))))))
260 (defun mm-links-remove-leading-blank ()
261 ;; Delete the annoying three spaces preceding each line of links
263 (goto-char (point-min))
264 (while (re-search-forward "^ " nil t)
265 (delete-region (match-beginning 0) (match-end 0))))
267 (defun mm-inline-wash-with-file (post-func cmd &rest args)
268 (let ((file (mm-make-temp-file
269 (expand-file-name "mm" mm-tmp-directory))))
270 (let ((coding-system-for-write 'binary))
271 (write-region (point-min) (point-max) file nil 'silent))
272 (delete-region (point-min) (point-max))
274 (apply 'call-process cmd nil t nil (mapcar 'eval args))
276 (and post-func (funcall post-func))))
278 (defun mm-inline-wash-with-stdin (post-func cmd &rest args)
279 (let ((coding-system-for-write 'binary))
280 (apply 'call-process-region (point-min) (point-max)
282 (and post-func (funcall post-func)))
284 (defun mm-inline-render-with-file (handle post-func cmd &rest args)
285 (let ((source (mm-get-part handle)))
288 (mm-with-unibyte-buffer
290 (apply 'mm-inline-wash-with-file post-func cmd args)
293 (defun mm-inline-render-with-stdin (handle post-func cmd &rest args)
294 (let ((source (mm-get-part handle)))
297 (mm-with-unibyte-buffer
299 (apply 'mm-inline-wash-with-stdin post-func cmd args)
302 (defun mm-inline-render-with-function (handle func &rest args)
303 (let ((source (mm-get-part handle))
304 (charset (mail-content-type-get (mm-handle-type handle) 'charset)))
307 (mm-with-multibyte-buffer
309 (mm-decode-string source charset)
314 (defun mm-inline-text-html (handle)
315 (let* ((func (or mm-inline-text-html-renderer mm-text-html-renderer))
316 (entry (assq func mm-text-html-renderer-alist))
319 (setq func (cdr entry)))
322 (funcall func handle))
324 (apply (car func) handle (cdr func))))))
326 (defun mm-inline-text-vcard (handle)
327 (let (buffer-read-only)
332 (if (fboundp 'vcard-pretty-print)
333 (vcard-pretty-print (mm-get-part handle))
335 (vcard-parse-string (mm-get-part handle)
336 'vcard-standard-filter))))))))
338 (defun mm-inline-text (handle)
340 (type (mm-handle-media-subtype handle))
341 (charset (mail-content-type-get
342 (mm-handle-type handle) 'charset))
344 (if (or (eq charset 'gnus-decoded)
345 ;; This is probably not entirely correct, but
346 ;; makes rfc822 parts with embedded multiparts work.
347 (eq mail-parse-charset 'gnus-decoded))
349 (narrow-to-region (point) (point))
350 (mm-insert-part handle)
351 (goto-char (point-max)))
352 (insert (mm-decode-string (mm-get-part handle) charset)))
353 (when (and mm-fill-flowed
355 (equal (cdr (assoc 'format (mm-handle-type handle)))
358 (narrow-to-region b (point))
361 (goto-char (point-max))))
363 (narrow-to-region b (point))
364 (set-text-properties (point-min) (point-max) nil)
365 (when (or (equal type "enriched")
366 (equal type "richtext"))
368 (enriched-decode (point-min) (point-max))))
369 (mm-handle-set-undisplayer
372 (let (buffer-read-only)
373 (delete-region ,(point-min-marker)
374 ,(point-max-marker))))))))
376 (defun mm-insert-inline (handle text)
377 "Insert TEXT inline from HANDLE."
380 (mm-handle-set-undisplayer
383 (let (buffer-read-only)
384 (delete-region ,(set-marker (make-marker) b)
385 ,(set-marker (make-marker) (point))))))))
387 (defun mm-inline-audio (handle)
388 (message "Not implemented"))
390 (defun mm-view-sound-file ()
391 (message "Not implemented"))
393 (defun mm-w3-prepare-buffer ()
395 (let ((url-standalone-mode t)
396 (url-gateway-unplugged t)
397 (w3-honor-stylesheets nil))
398 (w3-prepare-buffer)))
400 (defun mm-view-message ()
401 (mm-enable-multibyte)
403 (let (gnus-article-mime-handles)
404 ;; Double decode problem may happen. See mm-inline-message.
405 (run-hooks 'gnus-article-decode-hook)
406 (gnus-article-prepare-display)
407 (setq handles gnus-article-mime-handles))
409 (setq gnus-article-mime-handles
410 (mm-merge-handles gnus-article-mime-handles handles))))
412 (goto-char (point-min)))
414 (defun mm-inline-message (handle)
417 (charset (mail-content-type-get
418 (mm-handle-type handle) 'charset))
419 gnus-displaying-mime handles)
422 (setq charset (intern (downcase charset)))
423 (when (eq charset 'us-ascii)
427 (narrow-to-region b b)
428 (mm-insert-part handle)
429 (let (gnus-article-mime-handles
430 ;; disable prepare hook
431 gnus-article-prepare-hook
432 (gnus-newsgroup-charset
433 (or charset gnus-newsgroup-charset)))
434 (let ((gnus-original-article-buffer (mm-handle-buffer handle)))
435 (run-hooks 'gnus-article-decode-hook))
436 (gnus-article-prepare-display)
437 (setq handles gnus-article-mime-handles))
438 (goto-char (point-min))
441 (goto-char (point-max))
444 (insert "----------\n\n")
446 (setq gnus-article-mime-handles
447 (mm-merge-handles gnus-article-mime-handles handles)))
448 (mm-handle-set-undisplayer
451 (let (buffer-read-only)
452 (if (fboundp 'remove-specifier)
453 ;; This is only valid on XEmacs.
454 (mapcar (lambda (prop)
456 (face-property 'default prop) (current-buffer)))
457 '(background background-pixmap foreground)))
458 (delete-region ,(point-min-marker) ,(point-max-marker)))))))))
460 (defun mm-display-inline-fontify (handle mode)
462 ;; XEmacs @#$@ version of font-lock refuses to fully turn itself
463 ;; on for buffers whose name begins with " ". That's why we use
464 ;; save-current-buffer/get-buffer-create rather than
467 (set-buffer (generate-new-buffer "*fontification*"))
470 (buffer-disable-undo)
471 (mm-insert-part handle)
474 (let ((font-lock-verbose nil))
475 ;; I find font-lock a bit too verbose.
476 (font-lock-fontify-buffer))
477 ;; By default, XEmacs font-lock uses non-duplicable text
478 ;; properties. This code forces all the text properties
479 ;; to be copied along with the text.
480 (when (fboundp 'extent-list)
481 (map-extents (lambda (ext ignored)
482 (set-extent-property ext 'duplicable t)
484 nil nil nil nil nil 'text-prop))
485 (setq text (buffer-string)))
486 (kill-buffer (current-buffer))))
487 (mm-insert-inline handle text)))
489 ;; Shouldn't these functions check whether the user even wants to use
490 ;; font-lock? At least under XEmacs, this fontification is pretty
491 ;; much unconditional. Also, it would be nice to change for the size
492 ;; of the fontified region.
494 (defun mm-display-patch-inline (handle)
495 (mm-display-inline-fontify handle 'diff-mode))
497 (defun mm-display-elisp-inline (handle)
498 (mm-display-inline-fontify handle 'emacs-lisp-mode))
500 (defun mm-display-dns-inline (handle)
501 (mm-display-inline-fontify handle 'dns-mode))
503 ;; id-signedData OBJECT IDENTIFIER ::= { iso(1) member-body(2)
504 ;; us(840) rsadsi(113549) pkcs(1) pkcs7(7) 2 }
505 (defvar mm-pkcs7-signed-magic
506 (mm-string-as-unibyte
507 (mapconcat 'char-to-string
508 (list ?\x30 ?\x5c ?\x28 ?\x80 ?\x5c ?\x7c ?\x81 ?\x2e ?\x5c
509 ?\x7c ?\x82 ?\x2e ?\x2e ?\x5c ?\x7c ?\x83 ?\x2e ?\x2e
510 ?\x2e ?\x5c ?\x29 ?\x06 ?\x09 ?\x5c ?\x2a ?\x86 ?\x48
511 ?\x86 ?\xf7 ?\x0d ?\x01 ?\x07 ?\x02) "")))
513 ;; id-envelopedData OBJECT IDENTIFIER ::= { iso(1) member-body(2)
514 ;; us(840) rsadsi(113549) pkcs(1) pkcs7(7) 3 }
515 (defvar mm-pkcs7-enveloped-magic
516 (mm-string-as-unibyte
517 (mapconcat 'char-to-string
518 (list ?\x30 ?\x5c ?\x28 ?\x80 ?\x5c ?\x7c ?\x81 ?\x2e ?\x5c
519 ?\x7c ?\x82 ?\x2e ?\x2e ?\x5c ?\x7c ?\x83 ?\x2e ?\x2e
520 ?\x2e ?\x5c ?\x29 ?\x06 ?\x09 ?\x5c ?\x2a ?\x86 ?\x48
521 ?\x86 ?\xf7 ?\x0d ?\x01 ?\x07 ?\x03) "")))
523 (defun mm-view-pkcs7-get-type (handle)
524 (mm-with-unibyte-buffer
525 (mm-insert-part handle)
526 (cond ((looking-at mm-pkcs7-enveloped-magic)
528 ((looking-at mm-pkcs7-signed-magic)
531 (error "Could not identify PKCS#7 type")))))
533 (defun mm-view-pkcs7 (handle)
534 (case (mm-view-pkcs7-get-type handle)
535 (enveloped (mm-view-pkcs7-decrypt handle))
536 (signed (mm-view-pkcs7-verify handle))
537 (otherwise (error "Unknown or unimplemented PKCS#7 type"))))
539 (defun mm-view-pkcs7-verify (handle)
540 ;; A bogus implementation of PKCS#7. FIXME::
541 (mm-insert-part handle)
542 (goto-char (point-min))
543 (if (search-forward "Content-Type: " nil t)
544 (delete-region (point-min) (match-beginning 0)))
545 (goto-char (point-max))
546 (if (re-search-backward "--\r?\n?" nil t)
547 (delete-region (match-end 0) (point-max)))
548 (goto-char (point-min))
549 (while (search-forward "\r\n" nil t)
550 (replace-match "\n"))
551 (message "Verify signed PKCS#7 message is unimplemented.")
555 (defun mm-view-pkcs7-decrypt (handle)
556 (insert-buffer-substring (mm-handle-buffer handle))
557 (goto-char (point-min))
558 (insert "MIME-Version: 1.0\n")
559 (mm-insert-headers "application/pkcs7-mime" "base64" "smime.p7m")
560 (smime-decrypt-region
561 (point-min) (point-max)
562 (if (= (length smime-keys) 1)
564 (smime-get-key-by-email
566 (concat "Decipher using which key? "
567 (if smime-keys (concat "(default " (caar smime-keys) ") ")
569 smime-keys nil nil nil nil (car-safe (car-safe smime-keys))))))
570 (goto-char (point-min))
571 (while (search-forward "\r\n" nil t)
572 (replace-match "\n"))
573 (goto-char (point-min)))
577 ;;; mm-view.el ends here