PDF Tools README

Prerequisites

• GNU/Linux OS
• convert

  See http://www.imagemagick.org .

• GNU Emacs 24

  Preferably with imagemagick support.

• poppler-glib (>= 0.16)

  Some features require a more recent version.

  >= 0.19.4

  Creating and modifying text-annotations.

  >= 0.22

  Searching case-sensitive.

• glib

  This is obviously a prerequisite for poppler-glib and the version should match it.

Building

First run autogen.sh, then

./configure && make

which compiles the c source and creates a ELPA package.

Installation

Assuming the epdfinfo server build correctly and a Emacs package was created. The next step is to install this package, with make via

make install

or

make EMACS=/path/to/emacs install

Alternatively from within Emacs via

M-x package-install-file RET pdf-tools-${VERSION}.tar RET

Finally put

(pdf-tools-install)

somewhere in your .emacs. Try

M-x pdf-tools-help RET

for a overview of most features.

Features

Render

Display search results, links and annotations directly on the page, with customizable styles.

Isearch

Interactively search PDF documents like any other buffer, though there is currently no regexp support.

Following links

Click on highlighted links, moving to some part of a different page, some external file, a website or any other URI. Links may also be followed by keyboard commands.

Annotations

Display and list text-annotations, edit their contents and some attributes, move them around, delete them or create new ones and then save the modifications back to the PDF file.

Attachments

Save files attached to the PDF-file or list them in a dired buffer.

Outline

Use imenu or a special buffer to examine and navigate the PDF’s outline.

SyncTeX

Jump from a position on a page directly to the TeX source and vice-versa.

Misc

• Display PDF’s metadata.
• Select and copy text from the PDF.
• Search for occurences of a string.
• Keep track of visited pages via a history.
• Auto-fit pages to the current window size.
• View multiple pages in multiple windows.