1 ;;; mm-view.el --- functions for viewing MIME objects
2 ;; Copyright (C) 1998, 1999, 2000, 2001, 2002 Free Software Foundation, Inc.
4 ;; Author: Lars Magne Ingebrigtsen <larsi@gnus.org>
5 ;; This file is part of GNU Emacs.
7 ;; GNU Emacs is free software; you can redistribute it and/or modify
8 ;; it under the terms of the GNU General Public License as published by
9 ;; the Free Software Foundation; either version 2, or (at your option)
12 ;; GNU Emacs is distributed in the hope that it will be useful,
13 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
14 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 ;; GNU General Public License for more details.
17 ;; You should have received a copy of the GNU General Public License
18 ;; along with GNU Emacs; see the file COPYING. If not, write to the
19 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 ;; Boston, MA 02111-1307, USA.
26 (eval-when-compile (require 'cl))
33 (autoload 'gnus-article-prepare-display "gnus-art")
34 (autoload 'vcard-parse-string "vcard")
35 (autoload 'vcard-format-string "vcard")
36 (autoload 'fill-flowed "flow-fill")
37 (unless (fboundp 'diff-mode)
38 (autoload 'diff-mode "diff-mode" "" t nil)))
41 ;;; Functions for displaying various formats inline
44 (defun mm-inline-image-emacs (handle)
45 (let ((b (point-marker))
48 (put-image (mm-get-image handle) b)
49 (mm-handle-set-undisplayer
51 `(lambda () (remove-images ,b (1+ ,b))))))
53 (defun mm-inline-image-xemacs (handle)
57 (annot (make-annotation (mm-get-image handle) nil 'text))
59 (mm-handle-set-undisplayer
62 (let (buffer-read-only)
63 (delete-annotation ,annot)
64 (delete-region ,(set-marker (make-marker) b)
65 ,(set-marker (make-marker) (point))))))
66 (set-extent-property annot 'mm t)
67 (set-extent-property annot 'duplicable t)))
70 (if (featurep 'xemacs)
71 (defalias 'mm-inline-image 'mm-inline-image-xemacs)
72 (defalias 'mm-inline-image 'mm-inline-image-emacs)))
74 (defvar mm-w3-setup nil)
82 (setq mm-w3-setup t)))
84 (defun mm-inline-text-html-render-with-w3 (handle)
86 (let ((text (mm-get-part handle))
88 (url-standalone-mode t)
89 (w3-honor-stylesheets nil)
90 (w3-delay-image-loads t)
92 (url-generic-parse-url (format "cid:%s" (mm-handle-id handle))))
93 (width (window-width))
94 (charset (mail-content-type-get
95 (mm-handle-type handle) 'charset)))
99 (narrow-to-region b (point))
100 (goto-char (point-min))
101 (if (or (and (boundp 'w3-meta-content-type-charset-regexp)
103 w3-meta-content-type-charset-regexp nil t))
104 (and (boundp 'w3-meta-charset-content-type-regexp)
106 w3-meta-charset-content-type-regexp nil t)))
108 (or (let ((bsubstr (buffer-substring-no-properties
111 (if (fboundp 'w3-coding-system-for-mime-charset)
112 (w3-coding-system-for-mime-charset bsubstr)
113 (mm-charset-to-coding-system bsubstr)))
115 (delete-region (point-min) (point-max))
116 (insert (mm-decode-string text charset))
117 (save-window-excursion
119 (let ((w3-strict-width width)
120 ;; Don't let w3 set the global version of
122 (fill-column fill-column)
123 (w3-honor-stylesheets nil)
124 (w3-delay-image-loads t)
125 (url-standalone-mode t))
127 (w3-region (point-min) (point-max))
129 (delete-region (point-min) (point-max))
131 (charset (mail-content-type-get
132 (mm-handle-type handle) 'charset)))
133 (if (or (eq charset 'gnus-decoded)
134 (eq mail-parse-charset 'gnus-decoded))
136 (narrow-to-region (point) (point))
137 (mm-insert-part handle)
138 (goto-char (point-max)))
139 (insert (mm-decode-string (mm-get-part handle)
142 "Error while rendering html; showing as text/plain"))))))
143 (mm-handle-set-undisplayer
146 (let (buffer-read-only)
147 (if (functionp 'remove-specifier)
148 (mapcar (lambda (prop)
150 (face-property 'default prop)
152 '(background background-pixmap foreground)))
153 (delete-region ,(point-min-marker)
154 ,(point-max-marker)))))))))
156 (defvar mm-w3m-mode-map nil
157 "Local keymap for inlined text/html part rendered by emacs-w3m. It will
158 be slightly different from `w3m-mode-map' to use in the article buffer.")
160 (defvar mm-w3m-mode-command-alist
168 (w3m-antenna-add-current-url)
169 (w3m-bookmark-add-current-url)
170 (w3m-bookmark-add-this-url)
176 (w3m-edit-current-url)
180 (w3m-goto-url-new-session)
182 (w3m-history-restore-position)
183 (w3m-history-store-position)
186 (w3m-previous-buffer)
188 (w3m-redisplay-with-charset)
189 (w3m-reload-this-page)
190 (w3m-scroll-down-or-previous-url)
191 (w3m-scroll-up-or-next-url)
196 (w3m-view-parent-page)
197 (w3m-view-previous-page)
200 "Alist of commands to use for emacs-w3m in the article buffer. Each
201 element looks like (FROM-COMMAND . TO-COMMAND); FROM-COMMAND should be
202 registered in `w3m-mode-map' which will be substituted by TO-COMMAND
203 in `mm-w3m-mode-map'. If TO-COMMAND is nil, an article command key
204 will not be substituted.")
206 (defvar mm-w3m-setup nil
207 "Whether gnus-article-mode has been setup to use emacs-w3m.")
209 (defun mm-setup-w3m ()
210 "Setup gnus-article-mode to use emacs-w3m."
213 (unless mm-w3m-mode-map
214 (setq mm-w3m-mode-map (copy-keymap w3m-mode-map))
215 (dolist (def mm-w3m-mode-command-alist)
217 (substitute-key-definition (car def) (cdr def) mm-w3m-mode-map)
219 (unless (assq 'gnus-article-mode w3m-cid-retrieve-function-alist)
220 (push (cons 'gnus-article-mode 'mm-w3m-cid-retrieve)
221 w3m-cid-retrieve-function-alist))
222 (setq mm-w3m-setup t)))
224 (defun mm-w3m-cid-retrieve (url &rest args)
225 "Insert a content pointed by URL if it has the cid: scheme."
226 (when (string-match "\\`cid:" url)
227 (setq url (concat "<" (substring url (match-end 0)) ">"))
229 (dolist (handle (with-current-buffer w3m-current-buffer
230 gnus-article-mime-handles))
231 (when (and (listp handle)
232 (equal url (mm-handle-id handle)))
233 (mm-insert-part handle)
234 (throw 'found-handle (mm-handle-media-type handle)))))))
236 (defun mm-inline-text-html-render-with-w3m (handle)
237 "Render a text/html part using emacs-w3m."
239 (let ((text (mm-get-part handle))
241 (charset (mail-content-type-get (mm-handle-type handle) 'charset)))
245 (narrow-to-region b (point))
246 (goto-char (point-min))
247 (when (re-search-forward w3m-meta-content-type-charset-regexp nil t)
248 (setq charset (or (w3m-charset-to-coding-system (match-string 2))
251 (delete-region (point-min) (point-max))
252 (insert (mm-decode-string text charset)))
253 (let ((w3m-safe-url-regexp (if mm-inline-text-html-with-images
256 (w3m-display-inline-images mm-inline-text-html-with-images)
258 (w3m-region (point-min) (point-max)))
259 (when mm-inline-text-html-with-w3m-keymap
261 (point-min) (point-max)
262 (append '(mm-inline-text-html-with-w3m t)
263 (gnus-local-map-property mm-w3m-mode-map)))))
264 (mm-handle-set-undisplayer
267 (let (buffer-read-only)
268 (if (functionp 'remove-specifier)
269 (mapcar (lambda (prop)
271 (face-property 'default prop)
273 '(background background-pixmap foreground)))
274 (delete-region ,(point-min-marker)
275 ,(point-max-marker))))))))
277 (defun mm-inline-text (handle)
278 (let ((type (mm-handle-media-subtype handle))
282 (funcall mm-inline-text-html-renderer handle))
283 ((equal type "x-vcard")
288 (if (fboundp 'vcard-pretty-print)
289 (vcard-pretty-print (mm-get-part handle))
291 (vcard-parse-string (mm-get-part handle)
292 'vcard-standard-filter)))))))
295 (charset (mail-content-type-get
296 (mm-handle-type handle) 'charset)))
297 (if (or (eq charset 'gnus-decoded)
298 ;; This is probably not entirely correct, but
299 ;; makes rfc822 parts with embedded multiparts work.
300 (eq mail-parse-charset 'gnus-decoded))
302 (narrow-to-region (point) (point))
303 (mm-insert-part handle)
304 (goto-char (point-max)))
305 (insert (mm-decode-string (mm-get-part handle) charset)))
306 (when (and (equal type "plain")
307 (equal (cdr (assoc 'format (mm-handle-type handle)))
310 (narrow-to-region b (point))
313 (goto-char (point-max))))
315 (narrow-to-region b (point))
316 (set-text-properties (point-min) (point-max) nil)
317 (when (or (equal type "enriched")
318 (equal type "richtext"))
319 (enriched-decode (point-min) (point-max)))
320 (mm-handle-set-undisplayer
323 (let (buffer-read-only)
324 (delete-region ,(point-min-marker)
325 ,(point-max-marker)))))))))))
327 (defun mm-insert-inline (handle text)
328 "Insert TEXT inline from HANDLE."
331 (mm-handle-set-undisplayer
334 (let (buffer-read-only)
335 (delete-region ,(set-marker (make-marker) b)
336 ,(set-marker (make-marker) (point))))))))
338 (defun mm-inline-audio (handle)
339 (message "Not implemented"))
341 (defun mm-view-sound-file ()
342 (message "Not implemented"))
344 (defun mm-w3-prepare-buffer ()
346 (let ((url-standalone-mode t)
347 (w3-honor-stylesheets nil)
348 (w3-delay-image-loads t))
349 (w3-prepare-buffer)))
351 (defun mm-view-message ()
352 (mm-enable-multibyte)
354 (let (gnus-article-mime-handles)
355 ;; Double decode problem may happen. See mm-inline-message.
356 (run-hooks 'gnus-article-decode-hook)
357 (gnus-article-prepare-display)
358 (setq handles gnus-article-mime-handles))
360 (setq gnus-article-mime-handles
361 (mm-merge-handles gnus-article-mime-handles handles))))
363 (goto-char (point-min)))
365 (defun mm-inline-message (handle)
368 (charset (mail-content-type-get
369 (mm-handle-type handle) 'charset))
370 gnus-displaying-mime handles)
373 (setq charset (intern (downcase charset)))
374 (when (eq charset 'us-ascii)
378 (narrow-to-region b b)
379 (mm-insert-part handle)
380 (let (gnus-article-mime-handles
381 ;; disable prepare hook
382 gnus-article-prepare-hook
383 (gnus-newsgroup-charset
384 (or charset gnus-newsgroup-charset)))
385 (run-hooks 'gnus-article-decode-hook)
386 (gnus-article-prepare-display)
387 (setq handles gnus-article-mime-handles))
388 (goto-char (point-min))
391 (goto-char (point-max))
394 (insert "----------\n\n")
396 (setq gnus-article-mime-handles
397 (mm-merge-handles gnus-article-mime-handles handles)))
398 (mm-handle-set-undisplayer
401 (let (buffer-read-only)
402 (if (fboundp 'remove-specifier)
403 ;; This is only valid on XEmacs.
404 (mapcar (lambda (prop)
406 (face-property 'default prop) (current-buffer)))
407 '(background background-pixmap foreground)))
408 (delete-region ,(point-min-marker) ,(point-max-marker)))))))))
410 (defun mm-display-inline-fontify (handle mode)
412 ;; XEmacs @#$@ version of font-lock refuses to fully turn itself
413 ;; on for buffers whose name begins with " ". That's why we use
414 ;; save-current-buffer/get-buffer-create rather than
417 (set-buffer (generate-new-buffer "*fontification*"))
420 (buffer-disable-undo)
421 (mm-insert-part handle)
424 (let ((font-lock-verbose nil))
425 ;; I find font-lock a bit too verbose.
426 (font-lock-fontify-buffer))
427 ;; By default, XEmacs font-lock uses non-duplicable text
428 ;; properties. This code forces all the text properties
429 ;; to be copied along with the text.
430 (when (fboundp 'extent-list)
431 (map-extents (lambda (ext ignored)
432 (set-extent-property ext 'duplicable t)
434 nil nil nil nil nil 'text-prop))
435 (setq text (buffer-string)))
436 (kill-buffer (current-buffer))))
437 (mm-insert-inline handle text)))
439 ;; Shouldn't these functions check whether the user even wants to use
440 ;; font-lock? At least under XEmacs, this fontification is pretty
441 ;; much unconditional. Also, it would be nice to change for the size
442 ;; of the fontified region.
444 (defun mm-display-patch-inline (handle)
445 (mm-display-inline-fontify handle 'diff-mode))
447 (defun mm-display-elisp-inline (handle)
448 (mm-display-inline-fontify handle 'emacs-lisp-mode))
450 ;; id-signedData OBJECT IDENTIFIER ::= { iso(1) member-body(2)
451 ;; us(840) rsadsi(113549) pkcs(1) pkcs7(7) 2 }
452 (defvar mm-pkcs7-signed-magic
453 (mm-string-as-unibyte
455 (mapcar 'char-to-string
456 (list ?\x30 ?\x5c ?\x28 ?\x80 ?\x5c ?\x7c ?\x81 ?\x2e ?\x5c
457 ?\x7c ?\x82 ?\x2e ?\x2e ?\x5c ?\x7c ?\x83 ?\x2e ?\x2e
458 ?\x2e ?\x5c ?\x29 ?\x06 ?\x09 ?\x5c ?\x2a ?\x86 ?\x48
459 ?\x86 ?\xf7 ?\x0d ?\x01 ?\x07 ?\x02)))))
461 ;; id-envelopedData OBJECT IDENTIFIER ::= { iso(1) member-body(2)
462 ;; us(840) rsadsi(113549) pkcs(1) pkcs7(7) 3 }
463 (defvar mm-pkcs7-enveloped-magic
464 (mm-string-as-unibyte
466 (mapcar 'char-to-string
467 (list ?\x30 ?\x5c ?\x28 ?\x80 ?\x5c ?\x7c ?\x81 ?\x2e ?\x5c
468 ?\x7c ?\x82 ?\x2e ?\x2e ?\x5c ?\x7c ?\x83 ?\x2e ?\x2e
469 ?\x2e ?\x5c ?\x29 ?\x06 ?\x09 ?\x5c ?\x2a ?\x86 ?\x48
470 ?\x86 ?\xf7 ?\x0d ?\x01 ?\x07 ?\x03)))))
472 (defun mm-view-pkcs7-get-type (handle)
473 (mm-with-unibyte-buffer
474 (mm-insert-part handle)
475 (cond ((looking-at mm-pkcs7-enveloped-magic)
477 ((looking-at mm-pkcs7-signed-magic)
480 (error "Could not identify PKCS#7 type")))))
482 (defun mm-view-pkcs7 (handle)
483 (case (mm-view-pkcs7-get-type handle)
484 (enveloped (mm-view-pkcs7-decrypt handle))
485 (otherwise (error "Unknown or unimplemented PKCS#7 type"))))
487 (defun mm-view-pkcs7-decrypt (handle)
488 (insert-buffer (mm-handle-buffer handle))
489 (goto-char (point-min))
490 (insert "MIME-Version: 1.0\n")
491 (mm-insert-headers "application/pkcs7-mime" "base64" "smime.p7m")
492 (smime-decrypt-region
493 (point-min) (point-max)
494 (if (= (length smime-keys) 1)
496 (smime-get-key-by-email
497 (completing-read "Decrypt this part with which key? "
499 (and (listp (car-safe smime-keys))
500 (caar smime-keys)))))))
504 ;;; mm-view.el ends here