NicolasPetton/pass@919d8e3 -> NicolasPetton/pass@a095d24 abo-abo/define-word@3af6825 -> abo-abo/define-word@6e4a427 editorconfig/editorconfig-emacs@da84471 -> editorconfig/editorconfig-emacs@d73333c emacs-lsp/dap-mode@041db8e -> emacs-lsp/dap-mode@612388d emacs-lsp/lsp-mode@61443f3 -> emacs-lsp/lsp-mode@dbfbe1a emacs-lsp/lsp-ui@49bc513 -> emacs-lsp/lsp-ui@94673cd emacs-straight/project@0003fe4 -> emacs-straight/project@a1997af emacsorphanage/terraform-mode@63fafc6 -> emacsorphanage/terraform-mode@a9fa5bd joaotavora/eglot@2172641 -> joaotavora/eglot@4c85df2 k1LoW/emacs-ansible@cf6b8f0 -> k1LoW/emacs-ansible@40af0d2 magit/forge@953764d -> magit/forge@e340c2b magit/magit@acfe22a -> magit/magit@2145477 millejoh/emacs-ipython-notebook@a019ee3 -> millejoh/emacs-ipython-notebook@917f2a0 nicolaisingh/saveplace-pdf-view@88e07be -> nicolaisingh/saveplace-pdf-view@b037091 realgud/realgud@ff66001 -> realgud/realgud@f73c039 spotify/dockerfile-mode@d31f768 -> spotify/dockerfile-mode@6a56c1c tmalsburg/helm-bibtex@8d84d8b -> tmalsburg/helm-bibtex@1bb81d7 tmalsburg/helm-bibtex@8d84d8b -> tmalsburg/helm-bibtex@1bb81d7 tmalsburg/helm-bibtex@8d84d8b -> tmalsburg/helm-bibtex@1bb81d7 tumashu/posframe@e1552c8 -> tumashu/posframe@ae8ac91
tools/pdf
Description
This module improves support for reading and interacting with PDF files in Emacs.
It uses pdf-tools
, which is a replacement for the built-in doc-view-mode
for
PDF files. The key difference being pages are not pre-rendered, but instead
rendered on-demand and stored in memory; a much faster approach, especially for
larger PDFs.
Displaying PDF files is just one function of pdf-tools
. See its project
website for details and videos.
Maintainers
This module has no dedicated maintainers.
Module Flags
This module provides no flags.
Plugins
Hacks
- Added out-of-the-box support for HiDPI or Retina displays.
Prerequisites
This module requires epdfinfo
, a program the the pdf-tools
plugin will build
automatically when you open your first pdf file, unless you're on Windows.
Windows users must build it themselves.
Building epdfinfo
on Windows
- Install MSYS2 and update the package database and core packages using the instructions provided.
-
Update and install dependencies, skipping any you already have
pacman -Syu pacman -S base-devel pacman -S mingw-w64-x86_64-toolchain pacman -S mingw-w64-x86_64-zlib pacman -S mingw-w64-x86_64-libpng pacman -S mingw-w64-x86_64-poppler pacman -S mingw-w64-x86_64-imagemagick
-
Install PDF tools in Emacs, but do not try to compile the server. Instead, get a separate copy of the source somewhere else.
git clone https://github.com/politza/pdf-tools
- Open mingw64 shell (Note: You must use mingw64.exe and not msys2.exe)
-
Compile pdf-tools:
# Cask requires python2 (important: not 3!) pacman -S python2 # Make the mingw-shell aware of your python installation. Adjust the path if # Emacs is installed elsewhere! export PATH="/c/Program Files (x86)/Emacs/bin/:$PATH" # Cask needs to know where git.exe is; change this path if git is installed # elsewhere! export PATH="/c/Program Files/Git/bin:$PATH" # Install cask. Certificate errors can be ignored with (unsafe) -k option. curl -fsSL https://raw.githubusercontent.com/cask/cask/master/go | python # Make sure the build process can see cask export PATH="$HOME/.cask/bin:$PATH" cd /path/to/pdf-tools make -s
- This should produce a file
server/epdfinfo.exe
. Copy this file into the~/.emacs.d/.local/straight/build/pdf-tools/
. - Start Emacs.
- Open a pdf file (or run
M-x pdf-tools-install
) - Test it out:
M-x pdf-info-check-epdfinfo