X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/9a51ab3848614bb0c55a87ed74fb16a391c4d428..0e7b901b905fb8db3c7e391661f1510e96ff3814:/doc/misc/eww.texi diff --git a/doc/misc/eww.texi b/doc/misc/eww.texi index fde7774598..afb1cafb74 100644 --- a/doc/misc/eww.texi +++ b/doc/misc/eww.texi @@ -1,14 +1,14 @@ \input texinfo @c -*-texinfo-*- @c %**start of header -@setfilename ../../info/eww +@setfilename ../../info/eww.info @settitle Emacs Web Wowser -@documentencoding UTF-8 +@include docstyle.texi @c %**end of header @copying This file documents the GNU Emacs Web Wowser (EWW) package. -Copyright @copyright{} 2014 Free Software Foundation, Inc. +Copyright @copyright{} 2014--2016 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -97,6 +97,24 @@ and the web page is rendered in it. You can leave EWW by pressing web page hit @kbd{g} (@code{eww-reload}). Pressing @kbd{w} (@code{eww-copy-page-url}) will copy the current URL to the kill ring. +@findex eww-readable +@kindex R + The @kbd{R} command (@code{eww-readable}) will attempt to determine +which part of the document contains the ``readable'' text, and will +only display this part. This usually gets rid of menus and the like. + +@findex eww-toggle-fonts +@findex shr-use-fonts +@kindex F + The @kbd{F} command (@code{eww-toggle-fonts}) toggles whether to use +variable-pitch fonts or not. This sets the @code{shr-use-fonts} variable. + +@findex eww-toggle-colors +@findex shr-use-colors +@kindex F + The @kbd{C} command (@code{eww-toggle-colors}) toggles whether to use +HTML-specified colors or not. This sets the @code{shr-use-colors} variable. + @findex eww-download @vindex eww-download-directory @kindex d @@ -114,12 +132,27 @@ specified in @code{eww-download-directory} (Default: @file{~/Downloads/}). @cindex History EWW remembers the URLs you have visited to allow you to go back and forth between them. By pressing @kbd{l} (@code{eww-back-url}) you go -to the previous URL. You can go forward again with @kbd{r} +to the previous URL@. You can go forward again with @kbd{r} (@code{eww-forward-url}). If you want an overview of your browsing history press @kbd{H} (@code{eww-list-histories}) to open the history buffer @file{*eww history*}. The history is lost when EWW is quit. If you want to remember websites you can use bookmarks. +@vindex eww-history-limit + Along with the URLs visited, EWW also remembers both the rendered +page (as it appears in the buffer) and its source. This can take a +considerable amount of memory, so EWW discards the history entries to +keep their number within a set limit, as specified by +@code{eww-history-limit}; the default being 50. This variable could +also be set to @code{nil} to allow for the history list to grow +indefinitely. + +@cindex PDF + PDFs are viewed inline, by default, with @code{doc-view-mode}, but +this can be customized by using the mailcap (@pxref{mailcap,,, +emacs-mime, Emacs MIME Manual}) +mechanism, in particular @code{mailcap-mime-data}. + @findex eww-add-bookmark @findex eww-list-bookmarks @kindex b @@ -131,6 +164,17 @@ You can view stored bookmarks with @kbd{B} (@code{eww-list-bookmarks}). This will open the bookmark buffer @file{*eww bookmarks*}. +@findex eww-switch-to-buffer +@findex eww-list-buffers +@kindex s +@kindex S +@cindex Multiple Buffers + To get summary of currently opened EWW buffers, press @kbd{S} +(@code{eww-list-buffers}). The @file{*eww buffers*} buffer allows you +to quickly kill, flip through and switch to specific EWW buffer. To +switch EWW buffers through a minibuffer prompt, press @kbd{s} +(@code{eww-switch-to-buffer}). + @findex eww-browse-with-external-browser @vindex shr-external-browser @vindex eww-use-external-browser-for-content-type @@ -198,11 +242,45 @@ specific images completely by customizing @code{shr-blocked-images}. @vindex shr-color-visible-distance-min @vindex shr-color-visible-luminance-min @cindex Contrast - EWW (or rather its HTML renderer @code{shr}) use the colors declared -in the HTML page but adjust them if needed to keep a certain minimum -contrast. If that is still to low for you, have a look at the + EWW (or rather its HTML renderer @code{shr}) uses the colors declared +in the HTML page, but adjusts them if needed to keep a certain minimum +contrast. If that is still too low for you, you can customize the variables @code{shr-color-visible-distance-min} and -@code{shr-color-visible-luminance-min}. +@code{shr-color-visible-luminance-min} to get a better contrast. + +@cindex Desktop Support +@cindex Saving Sessions + In addition to maintaining the history at run-time, EWW will also +save the partial state of its buffers (the URIs and the titles of the +pages visited) in the desktop file if one is used. @xref{Saving Emacs +Sessions, , emacs, The GNU Emacs Manual}. + +@vindex eww-desktop-remove-duplicates + EWW history may sensibly contain multiple entries for the same page +URI@. At run-time, these entries may still have different associated +point positions or the actual Web page contents. +The latter, however, tend to be overly large to preserve in the +desktop file, so they get omitted, thus rendering the respective +entries entirely equivalent. By default, such duplicate entries are +not saved. Setting @code{eww-desktop-remove-duplicates} to nil will +force EWW to save them anyway. + +@vindex eww-restore-desktop + Restoring EWW buffers' contents may prove to take too long to +finish. When the @code{eww-restore-desktop} variable is set to +@code{nil} (the default), EWW will not try to reload the last visited +Web page when the buffer is restored from the desktop file, thus +allowing for faster Emacs start-up times. When set to @code{t}, +restoring the buffers will also initiate the reloading of such pages. + +@vindex eww-restore-reload-prompt + The EWW buffer restored from the desktop file but not yet reloaded +will contain a prompt, as specified by the +@code{eww-restore-reload-prompt} variable. The value of this variable +will be passed through @code{substitute-command-keys} upon each use, +thus allowing for the use of the usual substitutions, such as +@code{\[eww-reload]} for the current key binding of the +@code{eww-reload} command. @node History and Acknowledgments @appendix History and Acknowledgments @@ -229,6 +307,11 @@ developers started contributing to it as well. @node Variable Index @unnumbered Variable Index +@vindex eww-after-render-hook +After eww has rendered the data in the buffer, +@code{eww-after-render-hook} is called. It can be used to alter the +contents, for instance. + @printindex vr @node Lisp Function Index