# Atril Document Viewer Manual

The Atril Document Viewer application enables you to view documents of various formats like Portable Document Format (PDF) files and PostScript files

2015
MATE Documentation Project
2005
Nickolay V. Shmyrev
2004
Sun Microsystems
MATE Documentation Project
GNOME Documentation Project

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation Licence (GFDL), Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You can find a copy of the GFDL at this link or in the file COPYING-DOCS distributed with this manual.

This manual is part of a collection of MATE manuals distributed under the GFDL. If you want to distribute this manual separately from the collection, you can do so by adding a copy of the licence to the manual, as described in section 6 of the licence.

Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any MATE documentation, and the members of the MATE Documentation Project are made aware of those trademarks, then the names are in capital letters or initial capital letters.

DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE WITH THE FURTHER UNDERSTANDING THAT:

1. DOCUMENT IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS DISCLAIMER; AND

2. UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE), CONTRACT, OR OTHERWISE, SHALL THE AUTHOR, INITIAL WRITER, ANY CONTRIBUTOR, OR ANY DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR LOSSES ARISING OUT OF OR RELATING TO USE OF THE DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT, EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES.

MATE Documentation Project
MATE Desktop
Sun
GNOME Documentation Team
Sun Microsystems
Nickolay V.
Shmyrev
GNOME Documentation Project

     nshmyrev@yandex.ru

Atril Document Viewer Manual V1.2
July 2015

MATE Documentation Team

MATE Documentation Project

Atril Document Viewer Manual V1.1
2008-04-05

Niels Giesen

Claude Paroz

GNOME Documentation Project

Atril Document Viewer Manual V1.0
2005-04-06

Nickolay V. Shmyrev

GNOME Documentation Project

This manual describes version 1.10.1 of Atril Document Viewer

## Feedback

To report a bug or make a suggestion regarding the Atril Document Viewer application or this manual, follow the directions in the MATE Feedback Page.

## Introduction

The Atril Document Viewer application enables you to view documents of various formats like Portable Document Format (PDF) files and PostScript files. The Atril Document Viewer follows Freedesktop.org and MATE standards to provide integration with Desktop Environment.

## Getting Started

### To Start Atril Document Viewer

Atril Document Viewer starts when you open a document such as a PDF or PostScript file.

Alternatively, you can start Atril Document Viewer from the command line, with the command: `atril`.

### When You Start Atril Document Viewer

When you start Atril Document Viewer, the following window is displayed.

#### Atril Document Viewer Window

Shows Atril Document Viewer main window. Contains titlebar, menubar, toolbar and display area. Menubar contains File, Edit, View, Go and Help menus.

The Atril Document Viewer window contains the following elements:

Menubar

  The menus on the menubar contain all of the commands that you need to work with documents in Atril Document Viewer.

Toolbar

  The toolbar contains a subset of the commands that you can access from the menubar.

Display area

  The display area displays the document.

In Atril Document Viewer, you can perform the same action in several ways. For example, you can open a document in the following ways:

UI Component | Action
--- | ---

Window

- Drag a file into the Atril Document Viewer window from another application such as a file manager.

- Double-click on the file name in the file manager

Menubar | Choose File Open.
Shortcut keys | Press Ctrl O.

This manual documents functionality from the menubar.

## Usage

### To Open A Document

To open a document, perform the following steps:

1. Choose File Open .

2. In the Open Document dialogue, select the file you want to open.

3. Click Open. Atril Document Viewer displays the name of the document in the titlebar of the window.

To open another document, choose File Open again. Atril Document Viewer opens each file in a new window.

If you try to open a document with format that Atril Document Viewer does not recognise, the application displays an error message.

### To Navigate Through a Document

You can navigate through a file as follows:

- To view the next page, choose Go Next Page .

- To view the previous page, choose Go Previous Page .

- To view the first page in the document, choose Go First Page .

- To view the last page in the document, choose Go Last Page .

- To view a particular page, enter the page number or page label in the text box on the toolbar, then press Return.

### To Scroll a Page

To display the page contents that are not currently displayed in the display area, use the following methods:

- Use the arrow keys or space key on the keyboard.

- Drag the display area by clicking with the middle mouse button somewhere in the document and then moving the mouse. For example, to scroll down the page, drag the display area upwards in the window.

- Use the scrollbars on the window.

### To Change the Page Size

You can use the following methods to resize a page in the Atril Document Viewer display area:

- To increase the page size, choose View Zoom In .

- To decrease the page size, choose View Zoom Out .

- To resize a page to have the same width as the Atril Document Viewer display area, choose View Fit page width .

- To resize a page to fit within the Atril Document Viewer display area, choose View Best Fit .

- To resize the Atril Document Viewer window to have the same width and height as the screen, choose View Full Screen . To resize the Atril Document Viewer window to the original size, click on the Exit Full Screen button.

### To View Pages or Document Structure

To view bookmarks or pages, perform the following steps:

1. Choose View Sidebar or press F9.

2. Use the drop-down list in the side-pane header to select whether to display document structure or pages in the side pane.

3. Use the side-pane scrollbars to display the required item or page in the side pane.

4. Click on an entry to navigate to that location in the document. Click on a page to navigate to that page in the document.

### To View the Properties of a Document

To view the properties of a document, choose File Properties .

The Properties dialogue displays all information available

### To Print a Document

To print a Document, choose File Print .

If you cannot choose the Print menu item, the author of the document has disabled the print option for this document. To enable the print option, you must enter the master password when you open the document. See for more information about password-protected files.

The Print dialogue has the following tabbed sections:

- Job

- Printer

- Paper

#### Job

Print range

  Select one of the following options to determine how many pages to print:

  - All

    Select this option to print all of the pages in the document.

  - Pages From

    Select this option to print the selected range of pages in the document. Use the spin boxes to specify the first page and last page of the range.

#### Printer

Printer

  Use this drop-down list to select the printer to which you want to print the document.

  The Create a PDF document option is not supported in this version of Atril Document Viewer.

Settings

  Use this drop-down list to select the printer settings.

  To configure the printer, click Configure. For example, you can enable or disable duplex printing, or schedule delayed printing, if this functionality is supported by the printer.

Location

  Use this drop-down list to select one of the following print destinations:

  CUPS

    Print the document to a CUPS printer.

    If the selected printer is a CUPS printer, CUPS is the only entry in this drop-down list.

  lpr

    Print the document to a printer.

  File

    Print the document to a PostScript file.

    Click Save As to display a dialogue where you specify the name and location of the PostScript file.

  Custom

    Use the specified command to print the document.

    Type the name of the command in the text box. Include all command-line arguments.

State

  This functionality is not supported in this version of Atril Document Viewer.

Type

  This functionality is not supported in this version of Atril Document Viewer.

Comment

  This functionality is not supported in this version of Atril Document Viewer.

#### Paper

Paper size

  Use this drop-down list to select the size of the paper to which you want to print the document.

Width

  Use this spin box to specify the width of the paper. Use the adjacent drop-down list to change the measurement unit.

Height

  Use this spin box to specify the height of the paper.

Feed orientation

  Use this drop-down list to select the orientation of the paper in the printer.

Page orientation

  Use this drop-down list to select the page orientation.

Layout

  Use this drop-down list to select the page layout. A preview of each layout that you select is displayed in the Preview area.

Paper Tray

  Use this drop-down list to select the paper tray.

### To Copy a Document

To copy a file, perform the following steps:

1. Choose File Save a Copy .

2. Type the new filename in the Filename text box in the Save a Copy dialogue.

   If necessary, specify the location of the copied document. By default, copies are saved in your home directory.

3. Click Save.

### To Work With Password-Protected Documents

An author can use the following password levels to protect a document:

- User password that allows others only to read the document.

- Master password that allows others to perform additional actions, such as print the document.

When you try to open a password-protected document, Atril Document Viewer displays a security dialogue. Type either the user password or the master password in the Enter document password text box, then click Open Document.

### To Close a Document

To close a document, choose File Close .

If the window is the last Atril Document Viewer window open, the application exits.

## Shortcuts

Below is a list of all shortcuts present in Atril Document Viewer:

Shortcut | Action
--- | ---
Ctrl O | Open an existing document
Ctrl S | Save a copy of the current document
Ctrl P | Print document
Ctrl W | Close window
Ctrl C | Copy selection
Ctrl A | Select All
Ctrl F / (slash) | Find a word or phrase in the document
Ctrl G F3 | Find next
Ctrl+ (plus sign) + = | Zoom in
Ctrl- (minus sign) - | Zoom out
Ctrl R | Reload the document
Page Up | Go to the previous page
Page Down | Go to the next page
Space Shift Backspace Return | Scroll forward
Shift Space Backspace Shift Return | Scroll backward
Shift Page Up | Go a bunch of pages up
Shift Page Down | Go a bunch of pages down
Home | Go to the first page
End | Go to the last page
Ctrl L | Go to page by number or label
F1 | Help
F5 | Run document as presentation
F9 | Show or hide the side pane
F11 | Toggle fullscreen mode