GNOME/Document viewer

From ArchWiki
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Document viewer is specifically designed to support the following file formats: PDF, PostScript, DjVu, tiff, dvi, XPS, SyncTex support with gedit, comics books (cbr,cbz,cb7 and cbt). For a comprehensive list of formats supported, see Supported Document Formats.

Document viewer uses the poppler library as a backend.

Note: Document viewer was previously known as Evince until the application was given new descriptive names, one for each supported language. The name Evince is still used in numerous places such as the executable name, some package names, some desktop entries, and some GSettings schemas.

Installation

Install the evince package, or evince-gitAUR for the development version. Evince installs the gnome-desktop as a dependency.

For a standalone version, install evince-no-gnomeAUR or the light version evince-lightAUR for PDF support only.

Troubleshooting

Printer does not show up

Upgrade gtk3 to version 3.22.26+47+g3a1a7135a2-1 or higher. In previous GTK 3 versions, the GTK printer backends were included in a separate package.

Zoom-in is limited

Increasing Evince's page cache size allows you to zoom in further, which is handy for large documents. By default the setting is set to 50MiB. Increasing the page cache size obviously increases Evince's memory consumption when zoomed-in.

The following command increases the page cache size to one gigabyte:

$ gsettings set org.gnome.Evince page-cache-size 'uint32 1000'

PDF texts is not show correctly

Try setting override-restrictions parameter to false:

$ gsettings set org.gnome.Evince override-restrictions false

Inverse search with SyncTeX does not work

Check that dbus-python is installed. After that Ctrl+click should work.

WebP comic book support

Some comic books files (cbr, cbz etc.) use WebP images. Install webp-pixbuf-loader for WebP comic book support.

Annotations

Certain annotations created with Adobe Acrobat Reader are not displayed correctly. For annotations of type "insert text at cursor position" and "notice to replace text" only the visual part is displayed, while the text content of the comment appears wrongly to be empty. There currently is no solution for this problem.

Tips and Tricks

Annotation handling

Evince v3.31.0 adds keyboard hotkeys s for adding note text annotations and Ctrl+h for adding a highlight text annotation.

The default author for note text animations is equal to the GECOS comment for the current user, to change this:

# usermod -c "Your full new Real Name" yourusername

Use as default PDF viewer

To set the default association for xdg-open,

$ xdg-mime default org.gnome.Evince.desktop application/pdf

Other resource openers can be configured similarly.

See also