Function: eww-mode

eww-mode is an autoloaded and byte-compiled function defined in eww.el.gz.

Signature

(eww-mode)

Documentation

Mode for browsing the web.

In addition to any hooks its parent mode special-mode might have run, this mode runs the hook eww-mode-hook, as the final or penultimate step during initialization.

& eww-browse-with-external-browser
<backtab> shr-previous-link
<delete> scroll-down-command
<mouse-8> eww-back-url
<mouse-9> eww-forward-url
A eww-copy-alternate-url
B eww-list-bookmarks
C url-cookie-list
C-M-i shr-previous-link
C-c C-x C-w org-eww-copy-for-org-mode
C-c C-x M-w org-eww-copy-for-org-mode
D eww-toggle-paragraph-direction
E eww-set-character-encoding
F eww-toggle-fonts
G eww
H eww-list-histories
M-C eww-toggle-colors
M-I eww-toggle-images
M-RET eww-open-in-new-buffer
M-n eww-next-bookmark
M-p eww-previous-bookmark
R eww-readable
S eww-list-buffers
TAB shr-next-link
b eww-add-bookmark
d eww-download
g eww-reload
l eww-back-url
n eww-next-url
p eww-previous-url
r eww-forward-url
s eww-switch-to-buffer
t eww-top-url
u eww-up-url
v eww-view-source
w eww-copy-page-url

Source Code

;; Defined in /usr/src/emacs/lisp/net/eww.el.gz
;; Autoload cookie needed by desktop.el.
;;;###autoload
(define-derived-mode eww-mode special-mode
  `("eww"
    (:eval (when (plist-get eww-data :readable)
             '(:propertize ":readable"
               help-echo "Showing only human-readable text of page"))))
  "Mode for browsing the web."
  :interactive nil
  (setq-local eww-data (list :title ""))
  (setq-local browse-url-browser-function #'eww-browse-url)
  (add-hook 'context-menu-functions #'eww-context-menu 5 t)
  (setq-local eww-history nil)
  (setq-local eww-history-position 0)
  (when (boundp 'tool-bar-map)
    (setq-local tool-bar-map eww-tool-bar-map))
  ;; desktop support
  (setq-local desktop-save-buffer #'eww-desktop-misc-data)
  (setq truncate-lines t)
  ;; visual-wrap-prefix-mode support
  (setq-local adaptive-fill-function #'shr-adaptive-fill-function)
  ;; thingatpt support
  (setq-local thing-at-point-provider-alist
              (cons '(url . eww--url-at-point)
                    thing-at-point-provider-alist))
  (setq-local forward-thing-provider-alist
              (cons '(url . eww--forward-url)
                    forward-thing-provider-alist))
  (setq-local bounds-of-thing-at-point-provider-alist
              (cons '(url . eww--bounds-of-url-at-point)
                    bounds-of-thing-at-point-provider-alist))
  (setq-local bookmark-make-record-function #'eww-bookmark-make-record)
  (buffer-disable-undo)
  (setq-local shr-url-transformer #'eww--transform-url)
  ;; Also rescale images when rescaling the text.
  (add-hook 'text-scale-mode-hook #'eww--rescale-images nil t)
  (setq-local outline-search-function #'shr-outline-search
              outline-level 'shr-outline-level)
  (add-hook 'post-command-hook #'eww-check-text-conversion nil t)
  (setq buffer-read-only t)
  ;; Insertion at the first character of a field should inherit the
  ;; field's face, form and field, not the previous character's.
  (setq text-property-default-nonsticky '((face . t) (eww-form . t)
                                          (field . t))))