summaryrefslogtreecommitdiff
path: root/help/C/atril.md
blob: 2eb428e26e47e2499fe4c2e093516b63ced42fcf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
% Atril
% Oz Nahum (2012); Nickolay V. Shmyrev; Niels Giesen; Claude Paroz (2004)
% 18 September 2012


Introduction
============

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

Getting Started
===============

To Start atril
----------------

atril starts when you open a document such as a PDF or PostScript file.

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

When You Start atril
----------------------

When you start atril, the following window is displayed.

![ Shows atril main window. Contains titlebar, menubar, toolbar and
display area. Menubar contains File, Edit, View, Go and Help menus.
](figures/atril_start_window.png)

Atril window contains the following elements:

Menubar
:   The menus on the menubar contain all of the commands that you need
    to work with documents in APP.

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, 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 APP window
                                           from another application such as
                                           a file manager.
                                       
                                       -   Double-click on the file name in
                                           the file manager
                                       
                                       

  Menubar                              Choose FileOpen.

  Shortcut keys                        Press CtrlO.
  -------------------------------------------------------------------------

This manual documents functionality from the menubar.

Usage
=====

To Open A Document
------------------

To open a document, perform the following steps:

1.  Choose FileOpen.

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

3.  Click Open. atril displays the name of the document in the titlebar of
    the window.

To open another document, choose FileOpen again. atril opens each file in
a new window.

If you try to open a document with format that atril does not recognize,
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 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 display area,
    choose View Fit page width.

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

-   To resize the atril window to have the same width and height as the
    screen, choose View Full Screen. To resize the atril 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 dialog displays all information available

To Print a Document
-------------------

To print a Document, choose File Print.

> **Note**
>
> 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.

The Print dialog has the following tabbed sections:

-   [Job](#print-dialog-job)

-   [Printer](#print-dialog-printer)

-   [Paper](#print-dialog-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.

    > **Note**
    >
    > The Create a PDF document option is not supported in this version
    > of APP.

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.

        > **Note**
        >
        > 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 dialog 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.

Type
:   This functionality is not supported in this version of atril.

Comment
:   This functionality is not supported in this version of atril.

### 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
    dialog.

    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 displays a
security dialog. 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 window open, the application exits.

List of Keyboard Shortcuts
==========================

Below is a table of all shortcuts present in atril:


+-----------------------+---------------------------+
|  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 ,              | Find a word or phrase in the |
|                       | document                     |
|  / (slash)            |                              |    
+-----------------------+------------------------------+
|  Ctrl-G               |  Find next                   |
|  F3                   |                              |
+-----------------------+------------------------------+
|  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, j             |  Scroll forward           |
|                       |                           |
|  Shift Backspace      |                           |
|                       |                           |
|  Return               |                           |
+-----------------------+---------------------------+
|  Shift Space, k       | Scroll backward           |
|  Backspace            |                           |
+-----------------------+---------------------------+
|  Shift Return         |                           |
|  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    |
+-----------------------+---------------------------+