Difference between revisions of "Docview"

From WikEmacs
Jump to navigation Jump to search
Line 1: Line 1:
Emacs includes functionality to act as an image and document viewer via its Docview feature.
+
'''Docview''' is the document viewer within Emacs.  Use this library to view non-text files like pdf, odt etc without leaving Emacs.  It works by converting a file to an image and then displaying the image in an Emacs buffer.
  
Most usually the way to use this feature is to simply find a file of an appropriate type, e.g. a PNG image or a PDF document.
+
; {{Keys|C-x C-f}} myfile.pdf
 +
: This should display the pdf file.  On GNU/Linux systems, this works out of the box.  If this command doesn't work, install or configure the various programs.
  
When in Docview-mode {{Keys|C-c C-c}} (or {{Command|image-toggle-display}}) will toggle between viewing the image or document graphically and viewing it in text format. This can be useful for directly modifying PDF files, for instance.
+
; {{CommandKeys|C-c C-c|image-toggle-display}}
 
+
: When in Docview-mode, this will toggle between text format and it's image representation. This can be useful for directly modifying PDF files, for instance.
Docview mode typically works out of the box on GNU/Linux systems. If you are running Emacs on Windows it likely requires some additional libraries to be manually installed.
 

Revision as of 02:35, 28 March 2012

Docview is the document viewer within Emacs. Use this library to view non-text files like pdf, odt etc without leaving Emacs. It works by converting a file to an image and then displaying the image in an Emacs buffer.

[C-x C-f] myfile.pdf
This should display the pdf file. On GNU/Linux systems, this works out of the box. If this command doesn't work, install or configure the various programs.
[C-c C-c] (or M-x image-toggle-display)
When in Docview-mode, this will toggle between text format and it's image representation. This can be useful for directly modifying PDF files, for instance.