pdfjs-viewer

Themed, fully featured PDF viewer for the Atom editor

allefeld

9,140

4

1.3.0

MIT

GitHub

pdfjs-viewer

pdfjs-viewer is a package for the Atom editor that makes it possible to view PDF files in Atom panes. It is a wrapper around Mozilla's PDF.js library including its viewer application, adapted for the Atom environment.

screenshot

Comparison with other PDF viewer packages

pdfjs-viewer has the same purpose as the pdf-view and pdf-view-plus packages, but differs in several respects:

Other than pdf-view, this package features the full viewer UI, including

Other than pdf-view-plus, the viewer has been reskinned in compliance with the request of PDF.js developers not to use it unmodified. UI elements blend in with the current Atom theme. Almost all icons have been replaced with alternatives from Font Awesome.

Moreover, links in the PDF have been made functional (internal and external, including file: links). Some UI elements and associated keyboard shortcuts have been removed because they serve no purpose within Atom.

Installation

Install from Atom's Settings/Install dialog (search for pdfjs-viewer) or via apm install pdfjs-viewer.

Usage

PDF files can be opened from the Atom user interface, e.g. from the project tree view, or programmatically through atom.workspace.open().

The PDF.js viewer supports a number of keyboard shortcuts, the most important ones are:

shortcut function
n or j next page
p or k previous page
ctrl+f find
ctrl+g find next
shift+ctrl+g find previous
ctrl++ zoom in
ctrl+- zoom out
ctrl+0 reset zoom
r rotate clockwise
shift+r rotate counterclockwise
F4 toggle sidebar

Zoom is also possible via ctrl + the mouse wheel. A click on an internal link scrolls to that position in the document, a click on an external link opens it with the associated application. If modified by ctrl or shift, external links are opened in a separate Atom window.

If the PDF has been generated by *TeX with SyncTeX support, a right click opens the source file in Atom at the corresponding line.

The package watches for file changes and reloads the PDF if necessary. Viewer panes are persistent across Atom runs.


This software is copyrighted © 2020 by Carsten Allefeld and released under the terms of the MIT license, except for the included modified copy of the PDF.js library and viewer (pre-built release pdfjs-2.3.200-dist), © Mozilla and individual contributors and released under the terms of the Apache-2.0 license.