emenel/doomemacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
doomemacs/modules/tools/pdf
History
Henrik Lissner 261f94c768
bump: :tools 
NicolasPetton/pass@5651da5313 -> NicolasPetton/pass@c721604b3b
Olivia5k/makefile-executor.el@170d14d834 -> Olivia5k/makefile-executor.el@d1d98eaf52
Silex/docker.el@cc0046e6a5 -> Silex/docker.el@6997c86a24
cjohansson/emacs-ssh-deploy@94b56c0428 -> cjohansson/emacs-ssh-deploy@95fb076c9b
editorconfig/editorconfig-emacs@6f6b5c1a95 -> editorconfig/editorconfig-emacs@2fed9599bc
emacs-lsp/dap-mode@de41d62fc4 -> emacs-lsp/dap-mode@096070aacf
emacs-lsp/lsp-mode@0dfe214573 -> emacs-lsp/lsp-mode@266945b3e4
emacs-pe/docker-tramp.el@930d7b46c1 -> emacs-pe/docker-tramp.el@19d0771db4
emacs-straight/eglot@a399fc0d03 -> emacs-straight/eglot@8ccec6532e
emacs-straight/rainbow-mode@8e96388fb4 -> emacs-straight/rainbow-mode@24437ec2c6
emacs-tree-sitter/tree-sitter-langs@944a734b7c -> emacs-tree-sitter/tree-sitter-langs@2f0f97abbd
emacsfodder/kurecolor@ac67ceba85 -> emacsfodder/kurecolor@fbf98e1e38
emacsorphanage/quickrun@7a89313c07 -> emacsorphanage/quickrun@6f96318930
meain/evil-textobj-tree-sitter@e8bb9d63de -> meain/evil-textobj-tree-sitter@19979843f5
millejoh/emacs-ipython-notebook@b2410dc96f -> millejoh/emacs-ipython-notebook@998ba22660
nicolaisingh/saveplace-pdf-view@54ed966b84 -> nicolaisingh/saveplace-pdf-view@abfb5e1f46
purcell/envrc@1954e8c0b5 -> purcell/envrc@33d01388ce
vedang/pdf-tools@bc2ba117e8 -> vedang/pdf-tools@c69e7656a4
xiongtx/eros@dd89102792 -> xiongtx/eros@a9a92bdc6b
zx2c4/password-store@26d2dae04b -> zx2c4/password-store@28cec11f1d

I've intentionally omitted magit from this list while I resolve
incompatibilities between code-review and later versions of
closql (emacsql).

I've also omitted treemacs b/c of #7410.
2023-09-12 21:30:56 +02:00
..
config.el refactor(pdf): better epdfinfo check on pdf-view-mode 2022-07-24 13:16:02 +02:00
packages.el bump: :tools 2023-09-12 21:30:56 +02:00
README.org docs: change link format 2022-10-05 01:01:19 +02:00

README.org

:tools pdf

Description   unfold

This module improves support for reading and interacting with PDF files in Emacs.

It uses doom-package: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 doom-package:pdf-tools. See its project website for details and videos.

Maintainers

This module has no dedicated maintainers. Become a maintainer?

Module flags

This module has no flags.

Packages

TODO Hacks

🔨 This module's hacks haven't been documented yet. Document them?

TODO Changelog

This module does not have a changelog yet.

Installation

Enable this module in your doom! block.

This module requires the epdfinfo program. Unless you're on Windows, the doom-package:pdf-tools plugin will (re)build this program for you, if you issue the M-x pdf-tools-install command. See the next section for instructions on how to build the epdfinfo program on Windows.

Building epdfinfo on Windows

  1. Install MSYS2 and update the package database and core packages using the instructions provided.

  2. 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

  3. 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
  4. Open mingw64 shell (Note: You must use mingw64.exe and not msys2.exe)

  5. 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
  6. This should produce a file server/epdfinfo.exe. Copy this file into the $HOME/.emacs.d/.local/straight/build/pdf-tools/.
  7. Start Emacs.
  8. Open a pdf file (or run M-x pdf-tools-install)
  9. Test it out: M-x pdf-info-check-epdfinfo

TODO Usage

🔨 This module has no usage documentation yet. Write some?

TODO Configuration

🔨 This module has no configuration documentation yet. Write some?

Troubleshooting

There are no known problems with this module. Report one?

Frequently asked questions

This module has no FAQs yet. Ask one?

TODO Appendix

🔨 This module has no appendix yet. Write one?