summaryrefslogtreecommitdiff
path: root/help/C/index.docbook
blob: 7ff2e6dc32bdde6b6a00b9161565fc7e28dea439 (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
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY legal SYSTEM "legal.xml">
  <!ENTITY appversion "1.10.1">
  <!ENTITY manrevision "1.2">
  <!ENTITY date "July 2015">
  <!ENTITY app "<application>Atril Document Viewer</application>">
  <!ENTITY appname "Atril Document Viewer">
]>

<!-- 
      (Do not remove this comment block.)
  Maintained by the MATE Documentation Project
  http://wiki.mate-desktop.org/dev-doc:doc-team-guide
  Template version: 2.0 beta
  Template last modified Apr 11, 2002
-->

<!-- =============Document Header ============================= -->
<article id="index" lang="en">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
    <title>&appname; Manual </title>       
    <abstract role="description">
      <para> 
         The Atril Document Viewer application enables you to view documents of various formats like Portable 
         Document Format (PDF) files and PostScript files
      </para>
    </abstract>
    <copyright>
      <year>2021</year>
      <holder>MATE Documentation Project</holder>
    </copyright>
    <copyright>
      <year>2005</year>
      <holder>Nickolay V. Shmyrev</holder>
    </copyright>
    <copyright>
      <year>2004</year>
      <holder>Sun Microsystems</holder>
    </copyright>

<!-- translators: uncomment this:
    <copyright>
      <year>2002</year>
      <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
    </copyright>
-->

    <publisher> 
      <publishername> MATE Documentation Project </publishername> 
    </publisher>
    <publisher>
      <publishername> GNOME Documentation Project </publishername>
    </publisher> 

    &legal;
    <!-- This file  contains link to license for the documentation (GNU FDL), and 
         other legal stuff such as "NO WARRANTY" statement. Please do not change 
	 any of this. -->

    <authorgroup> 
      <author role="maintainer">
        <firstname>MATE Documentation Project</firstname>
        <surname></surname>
        <affiliation><orgname>MATE Desktop</orgname></affiliation>
      </author>
      <author>
        <firstname>Sun</firstname>
        <surname>GNOME Documentation Team</surname>
        <affiliation><orgname>Sun Microsystems</orgname></affiliation>
      </author>
      <author>
	<firstname>Nickolay V. </firstname> 
	<surname>Shmyrev</surname> 
	<affiliation> 
	  <orgname>GNOME Documentation Project</orgname>
	  <address> <email>nshmyrev@yandex.ru</email> </address> 
	</affiliation> 
      </author> 

<!-- This is appropriate place for other contributors: translators,
     maintainers,  etc. Commented out by default.
      <othercredit role="translator">
	<firstname>Latin</firstname> 
	<surname>Translator 1</surname> 
	<affiliation> 
          <orgname>Latin Translation Team</orgname> 
  	  <address> <email>translator@gnome.org</email> </address> 
        </affiliation>
        <contrib>Latin translation</contrib>
      </othercredit>
-->
    </authorgroup>

    <revhistory>
      <revision> 
        <revnumber>&appname; Manual V&manrevision;</revnumber>
	<date>July 2015</date>
        <revdescription>
          <para role="author">MATE Documentation Team</para>
          <para role="publisher">MATE Documentation Project</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>&appname; Manual V1.1</revnumber> 
	<date>2008-04-05</date>
        <revdescription>
          <para role="author">Niels Giesen</para>
          <para role="author">Claude Paroz</para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision> 
      <revision> 
        <revnumber>&appname; Manual V1.0</revnumber> 
	<date>2005-04-06</date>
        <revdescription>
          <para role="author">Nickolay V. Shmyrev</para>
          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision> 
    </revhistory> 

    <releaseinfo>This manual describes version &appversion; of &appname;
    </releaseinfo> 
    <legalnotice> 
      <title>Feedback</title> 
      <para>To report a bug or make a suggestion regarding the &appname; application or this manual, follow the directions in the <ulink url="help:mate-user-guide/feedback" type="help">MATE Feedback Page</ulink>.
      </para>
<!-- Translators may also add here feedback address for translations -->
    </legalnotice> 
  </articleinfo> 

  <indexterm zone="index"> 
    <primary>&appname;</primary> 
  </indexterm> 
  <indexterm zone="index"> 
    <primary>atril</primary> 
  </indexterm>

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
<!-- Use the Introduction section to give a brief overview of what
     the application is and what it does. -->
  <sect1 id="atril-introduction"> 
    <title>Introduction</title> 
    <para>The &app; application enables you to view documents of various formats like Portable Document Format (PDF) files and PostScript files.  &app; follows Freedesktop.org and MATE standards to provide integration with Desktop Environment.
    </para>
  </sect1>

<!-- =========== Getting Started ============================== -->

  <sect1 id="atril-getting-started"> 
    <title>Getting Started</title> 

    <sect2 id="atril-start">
    <title>To Start &appname;</title>
    <para>&app; starts when you open a document such as a PDF or PostScript file.</para>
    <para>Alternatively, you can start &app; from the command line, with the command: <command>atril</command>.</para>
    
    </sect2>

    <sect2 id="atril-when-start">
    <title>When You Start &appname;</title>
    <para>When you start &app;, the following window is displayed.</para>

    <!-- ==== Figure ==== -->
      <figure id="mainwindow-fig"> 
	<title>&appname; Window</title> 
	<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata
		fileref="figures/atril_start_window.png" format="PNG"/> 
	    </imageobject>
	    <textobject> 
	      <phrase>Shows &appname; main window. Contains titlebar, menubar, toolbar and display area. Menubar contains File, Edit, View, Go and Help menus. </phrase> 
	    </textobject> 
	  </mediaobject> 
	</screenshot> 
      </figure>

    <para>The &app; window contains the following elements:
    </para>
      <variablelist>
	<varlistentry>
  	  <term>Menubar</term>
 	  <listitem>
	    <para>The menus on the menubar contain all of the commands that you need to work with documents in &app;.</para>
	  </listitem>
 	</varlistentry>
	<varlistentry>
	  <term>Toolbar</term>
	  <listitem>
	    <para>The toolbar contains a subset of the commands that you can access from the menubar.</para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term>Display area</term>
	  <listitem>
 	    <para>The display area displays the document.</para>
	  </listitem>
	</varlistentry>
      </variablelist>

      <para>
        In &app;, you can perform the same action in several ways. For example, you can open a document in the following ways:
                  <informaltable frame="all">
                    <tgroup cols="2" colsep="1" rowsep="1">
                      <colspec colname="COLSPEC0" colwidth="50*"/>
                      <colspec colname="COLSPEC1" colwidth="50*"/>
                      <thead>
                        <row valign="top">
                          <entry colname="COLSPEC0">
                            <para>UI Component</para></entry>
                          <entry colname="COLSPEC1" align="left"> 
                            <para>Action</para></entry>
                        </row>
                      </thead>
                      <tbody>
                        <row valign="top">               
                          <entry><para>Window</para></entry>
                          <entry>
                            <itemizedlist>
                              <listitem>
                                <para>Drag a file into the &app; window from another application such as a file manager.</para>
                              </listitem>
                              <listitem>
                                <para>Double-click on the file name in the file manager</para>
                              </listitem>
                            </itemizedlist>
                          </entry>
                        </row>
                        <row valign="top">               
                          <entry><para>Menubar</para></entry>
                          <entry><para>Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Open</guimenuitem></menuchoice>.</para>
</entry>
                        </row>
                        <row valign="top">               
                          <entry><para>Shortcut keys</para></entry>
                          <entry><para>Press <keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo>.</para></entry>
                        </row>
                      </tbody>
                    </tgroup>
                  </informaltable>
      </para>
      <para>
      This manual documents functionality from the menubar.
      </para>
    </sect2>
  </sect1>

<!-- ================ Usage ================================ -->
  <sect1 id="atril-usage"> 
    <title>Usage</title> 

    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="atril-open-file"> 
      <title>To Open A Document</title> 
      <para>To open a document, perform the following steps:</para>
      <orderedlist>
        <listitem>
          <para>
            Choose <menuchoice> <guimenu>File</guimenu><guimenuitem>Open</guimenuitem> </menuchoice>.  </para>
        </listitem>
        <listitem>
          <para>
            In the <guilabel>Open Document</guilabel> dialog, select the file you want to open.
          </para>
        </listitem>
        <listitem>
          <para>
            Click <guibutton>Open</guibutton>. &app; displays the name of the document in the titlebar of the window.
          </para>
        </listitem>
      </orderedlist>
      <para> 
	To open another document, choose <menuchoice> <guimenu>File</guimenu><guimenuitem>Open</guimenuitem> </menuchoice> again. &app; opens each file in a new window.
      </para>
      <para>
	If you try to open a document with format that &app; does not recognize, the application displays an error message.
      </para>
    </sect2>

    <sect2 id="atril-navigate-file">
    <title>To Navigate Through a Document</title>
      <para>You can navigate through a file as follows:</para>
      <itemizedlist>
        <listitem>
          <para>To view the next page, choose <menuchoice> <guimenu>Go</guimenu> <guimenuitem>Next Page</guimenuitem> </menuchoice>.
          </para>
        </listitem>
	<listitem>
	  <para>To view the previous page, choose <menuchoice> <guimenu>Go</guimenu> <guimenuitem>Previous Page</guimenuitem> </menuchoice>.
          </para>
        </listitem>
	<listitem>
	  <para>To view the first page in the document, choose <menuchoice> <guimenu>Go</guimenu> <guimenuitem>First Page</guimenuitem> </menuchoice>.
          </para>
        </listitem>
	<listitem>
	  <para>To view the last page in the document, choose <menuchoice> <guimenu>Go</guimenu> <guimenuitem>Last Page</guimenuitem> </menuchoice>.
          </para>
        </listitem>
	<listitem>
	  <para>To view a particular page, enter the page number or page label in the text box on the toolbar, then press <keycap>Return</keycap>.</para>
        </listitem>
      </itemizedlist>
    </sect2>

    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="atril-scroll-page"> 
      <title>To Scroll a Page</title> 
      <para>To display the page contents that are not currently displayed in the display area, use the following methods:</para> 
        <itemizedlist> 
	  <listitem> 
  	    <para>Use the arrow keys or space key on the keyboard.</para> 
  	  </listitem> 
	  <listitem> 
  	    <para>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.</para> 
	  </listitem> 
	  <listitem> 
	    <para>Use the scrollbars on the window.</para> 
  	  </listitem> 
      </itemizedlist> 
    </sect2>

    <!-- ================ Usage Subsection ================================ -->
	 <sect2 id="atril-manipulate-zoom-factor"> 
      <title>To Change the Page Size</title> 
      <para>
        You can use the following methods to resize a page in the &app; display area:
      </para> 
      <itemizedlist> 
	<listitem> 
	  <para>
            To increase the page size, choose <menuchoice> <guimenu>View</guimenu> <guimenuitem>Zoom In</guimenuitem> </menuchoice>.
          </para> 
	</listitem> 
	<listitem> 
	  <para>
            To decrease the page size, choose <menuchoice> <guimenu>View</guimenu> <guimenuitem>Zoom Out</guimenuitem> </menuchoice>.
          </para> 
	</listitem> 
	<listitem> 
	  <para>
            To resize a page to have the same width as the &app; display area, choose <menuchoice> <guimenu>View</guimenu> <guimenuitem>Fit page width</guimenuitem> </menuchoice>.
          </para> 
	</listitem> 
	<listitem> 
	  <para>
            To resize a page to fit within the &app; display area, choose <menuchoice> <guimenu>View</guimenu> <guimenuitem>Best Fit</guimenuitem> </menuchoice>.
          </para> 
	</listitem> 
	<listitem> 
	  <para>
            To resize the &app; window to have the same width and height as the screen, choose <menuchoice> <guimenu>View</guimenu> <guimenuitem>Full Screen</guimenuitem> </menuchoice>. To resize the &app; window to the original size, click on the <guibutton>Exit Full Screen</guibutton> button.
          </para> 
	</listitem> 
      </itemizedlist> 
    </sect2> 

    <sect2 id="atril-view-pages">
      <title>To View Pages or Document Structure</title>
      <para>To view bookmarks or pages, perform the following steps:
      </para>
      <orderedlist>
        <listitem>
          <para>
	    Choose <menuchoice> <guimenu>View</guimenu> <guimenuitem>Sidebar</guimenuitem> </menuchoice> or press <keycap>F9</keycap>.
          </para>
        </listitem>
        <listitem>
          <para>
	    Use the drop-down list in the side-pane header to select whether to display document structure or pages in the side pane.
          </para>
        </listitem>
        <listitem>
          <para>
	    Use the side-pane scrollbars to display the required item or page in the side pane.
          </para>
        </listitem>
        <listitem>
          <para>Click on an entry to navigate to that location in the document. Click on a page to navigate to that page in the document.</para>
        </listitem>
      </orderedlist>
    </sect2> 

    <sect2 id="atril-view-properties">
      <title>To View the Properties of a Document</title>
      <para>To view the properties of a document, choose 
        <menuchoice>
          <guimenu>File</guimenu>
          <guimenuitem>Properties</guimenuitem>
        </menuchoice>. 
      </para>
      <para>
        The <guilabel>Properties</guilabel> dialog displays all information available
      </para>
    </sect2>

    <sect2 id="atril-print-file">
      <title>To Print a Document</title>
      <para>
        To print a Document, choose <menuchoice> <guimenu>File</guimenu> <guimenuitem>Print</guimenuitem> </menuchoice>.
      </para>
      <note>
        <para>
          If you cannot choose the <guimenuitem>Print</guimenuitem> 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 <xref linkend="atril-password"/> for more information about password-protected files.
        </para>
      </note>
      <para>
        The <guilabel>Print</guilabel> dialog has the following tabbed sections:
      </para>
      <itemizedlist>
        <listitem>
          <para>
            <link linkend="print-dialog-job">Job</link>
          </para>
        </listitem>
        <listitem>
          <para>
            <link linkend="print-dialog-printer">Printer</link>
          </para>
        </listitem>
        <listitem>
          <para>
            <link linkend="print-dialog-paper">Paper</link>
          </para>
        </listitem>
      </itemizedlist>

      <sect3 id="print-dialog-job">
      <title>Job</title>
	<variablelist>
	  <varlistentry> <term><guilabel>Print range</guilabel> </term> 
	    <listitem> 
	      <para>Select one of the following options to determine how many pages to print:</para>
	      <itemizedlist>
		<listitem>
		  <para><guilabel>All</guilabel></para>
		  <para>Select this option to print all of the pages in the document.</para>
		</listitem>
		<listitem>
		  <para><guilabel>Pages From</guilabel></para>
		  <para>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.
                  </para>
		</listitem>							
	      </itemizedlist>
	    </listitem>
	  </varlistentry>
        </variablelist>  
      </sect3>
		
	<sect3 id="print-dialog-printer">
	<title>Printer</title>
	<variablelist>
	  <varlistentry> <term><guilabel>Printer</guilabel> </term> 
	    <listitem> 
	      <para>Use this drop-down list to select the printer to which you want to print the document.</para>
              <note>
              <para>
                The <guilabel>Create a PDF document</guilabel> option is not supported in this version of &app;.
              </para>
              </note>
	    </listitem>
	  </varlistentry>
	  <varlistentry> <term><guilabel>Settings</guilabel> </term> 
	    <listitem> 
	      <para>Use this drop-down list to select the printer settings. 
              </para>
	      <para>To configure the printer, click <guibutton>Configure</guibutton>. For example, you can enable or disable duplex printing, or schedule delayed printing, if this functionality is supported by the printer.
              </para>
	    </listitem>
	  </varlistentry>
	  <varlistentry> <term><guilabel>Location</guilabel> </term> 
	    <listitem> 
	      <para>
                Use this drop-down list to select one of the following print destinations: 
	      </para>
	      <variablelist>
	        <varlistentry>
	          <term><guilabel>CUPS</guilabel></term>
	          <listitem>
	            <para>
                      Print the document to a CUPS printer. 
	            </para>
	            <note>
	              <para>
                        If the selected printer is a CUPS printer, <guilabel>CUPS</guilabel> is the only entry in this drop-down list. 
	              </para>
	            </note>
	          </listitem>
	        </varlistentry>
	        <varlistentry>
	          <term><guilabel>lpr</guilabel></term>
	          <listitem>
	            <para>
                      Print the document to a printer. 
	            </para>
	          </listitem>
	        </varlistentry>
	        <varlistentry>
	          <term><guilabel>File</guilabel></term>
	          <listitem>
	            <para>
                      Print the document to a PostScript file. 
	            </para>
	            <para>
                      Click <guibutton>Save As</guibutton> to display a dialog where you specify the name and location of the PostScript file.
	            </para>
	          </listitem>
	        </varlistentry>
	        <varlistentry>
	          <term><guilabel>Custom</guilabel></term>
	          <listitem>
	            <para>
                      Use the specified command to print the document.
	            </para>
	            <para>
                      Type the name of the command in the text box. Include all command-line arguments.
	            </para>
	          </listitem>
	        </varlistentry>
	      </variablelist>
            </listitem>
	  </varlistentry>
	  <varlistentry> <term><guilabel>State</guilabel> </term> 
	    <listitem> 
	      <para>This functionality is not supported in this version of &app;.
              </para>
	    </listitem>
	  </varlistentry>
	  <varlistentry> <term><guilabel>Type</guilabel> </term> 
	    <listitem> 
	      <para>This functionality is not supported in this version of &app;.
              </para>
	    </listitem>
	  </varlistentry>
	  <varlistentry> <term><guilabel>Comment</guilabel> </term> 
	    <listitem> 
	      <para>This functionality is not supported in this version of &app;.
              </para>
	    </listitem>
	  </varlistentry>
	</variablelist>
	</sect3>
		
	<sect3 id="print-dialog-paper">
	<title>Paper</title>
	<variablelist>
	  <varlistentry> <term><guilabel>Paper size</guilabel> </term> 
	    <listitem> 
	      <para>Use this drop-down list to select the size of the paper to which you want to print the document.</para>
	    </listitem>
	  </varlistentry>
	  <varlistentry> <term><guilabel>Width</guilabel> </term> 
	    <listitem> 
	      <para>Use this spin box to specify the width of the paper. Use the adjacent drop-down list to change the measurement unit.</para>
	    </listitem>
	  </varlistentry>
	    <varlistentry> <term><guilabel>Height</guilabel> </term> 
	    <listitem> 
	      <para>Use this spin box to specify the height of the paper.</para>
	    </listitem>
	  </varlistentry>
	  <varlistentry> <term><guilabel>Feed orientation</guilabel> </term> 
	    <listitem> 
	      <para>Use this drop-down list to select the orientation of the paper in the printer.</para>
	    </listitem>
	  </varlistentry>
	  <varlistentry> <term><guilabel>Page orientation</guilabel> </term> 
	    <listitem> 
	      <para>Use this drop-down list to select the page orientation.</para>
	    </listitem>
	  </varlistentry>
	  <varlistentry> <term><guilabel>Layout</guilabel> </term> 
	    <listitem> 
	      <para>Use this drop-down list to select the page layout. A preview of each layout that you select is displayed in the <guilabel>Preview</guilabel> area.</para>
	    </listitem>
	  </varlistentry>
	  <varlistentry> <term><guilabel>Paper Tray</guilabel> </term> 
	    <listitem> 
	      <para>Use this drop-down list to select the paper tray.
              </para>
	    </listitem>
	  </varlistentry>
	</variablelist>
      </sect3>
    </sect2>

    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="atril-copy-file"> 
      <title>To Copy a Document</title> 
      <para>To copy a file, perform the following steps:
      </para>
      <orderedlist>
        <listitem>
          <para>
            Choose <menuchoice> <guimenu>File</guimenu> <guimenuitem>Save a Copy</guimenuitem> </menuchoice>. 
          </para> 
        </listitem>
        <listitem>
          <para> 
            Type the new filename in the <guilabel>Filename</guilabel> text box in the <guilabel>Save a Copy</guilabel> dialog.
          </para> 
          <para> 
            If necessary, specify the location of the copied document. By default, copies are saved in your home directory.
          </para> 
        </listitem>
        <listitem>
          <para> 
            Click <guibutton>Save</guibutton>.
          </para> 
        </listitem>
      </orderedlist>
    </sect2>

    <!-- this id must be kept in sync with atril-persist-file.cc/atril-persist-stream.cc -->
    <sect2 id="atril-password">
      <title>To Work With Password-Protected Documents</title>
      <para>
        An author can use the following password levels to protect a document:
      </para>
      <itemizedlist>
        <listitem>
          <para>User password that allows others only to read the document.
          </para>
        </listitem>        
        <listitem>
          <para>Master password that allows others to perform additional actions, such as print the document.
          </para>
        </listitem>        
      </itemizedlist>
      <para>
        When you try to open a password-protected document, &app; displays a security dialog. Type either the user password or the master password in the <guilabel>Enter document password</guilabel> text box, then click <guibutton>Open Document</guibutton>.
      </para>
    </sect2>

    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="atril-close-file"> 
      <title>To Close a Document</title> 
      <para>To close a document, choose <menuchoice> <guimenu>File</guimenu> <guimenuitem>Close</guimenuitem> </menuchoice>. 
      </para> 
      <para> 
        If the window is the last &app; window open, the application exits.
      </para> 
    </sect2> 

  </sect1>

  <!-- ================ Shortcuts ================================ -->
  <sect1 id="atril-shortcuts"> 
    <title>Shortcuts</title> 
    <para>Below is a list of all shortcuts present in &app;:</para>
    <informaltable frame="all">
      <tgroup cols="2" colsep="1" rowsep="1">
        <colspec colname="COLSPEC0" colwidth="50*"/>
        <colspec colname="COLSPEC1" colwidth="50*"/>
        <thead>
          <row valign="top">
            <entry colname="COLSPEC0">
            <para>Shortcut</para></entry>
            <entry colname="COLSPEC1" align="left"> 
            <para>Action</para></entry>
          </row>
        </thead>
        <tbody>
          <row valign="middle">               
            <entry><para><keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo></para></entry>
            <entry><para>Open an existing document</para></entry>
          </row>
          <row valign="middle">               
            <entry><para><keycombo><keycap>Ctrl</keycap><keycap>S</keycap></keycombo></para></entry>
            <entry><para>Save a copy of the current document</para></entry>
          </row>
          <row valign="middle">               
            <entry><para><keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo></para></entry>
            <entry><para>Print document</para></entry>
          </row>
          <row valign="middle">               
            <entry><para><keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo></para></entry>
            <entry><para>Close window</para></entry>
          </row>
          <row valign="middle">               
            <entry><para><keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo></para></entry>
            <entry><para>Copy selection</para></entry>
          </row>
          <row valign="middle">               
            <entry><para><keycombo><keycap>Ctrl</keycap><keycap>A</keycap></keycombo></para></entry>
            <entry><para>Select All</para></entry>
          </row>
          <row valign="middle">               
            <entry>
              <para><keycombo><keycap>Ctrl</keycap><keycap>F</keycap></keycombo></para>
              <para><keycap>/</keycap> (slash)</para>
            </entry>
            <entry><para>Find a word or phrase in the document</para></entry>
          </row>
          <row valign="middle">               
            <entry>
              <para><keycombo><keycap>Ctrl</keycap><keycap>G</keycap></keycombo></para>
              <para><keycap>F3</keycap></para> 
            </entry>
            <entry><para>Find next</para></entry>
          </row>
          <row valign="middle">               
            <entry>
              <para><keycombo><keycap>Ctrl</keycap><keycap>+</keycap></keycombo> (plus sign)</para>
              <para><keycap>+</keycap></para>
              <para><keycap>=</keycap></para>
            </entry>
            <entry><para>Zoom in</para></entry>
          </row>
          <row valign="middle">               
            <entry>
              <para><keycombo><keycap>Ctrl</keycap><keycap>-</keycap></keycombo> (minus sign)</para>
              <para><keycap>-</keycap></para>
            </entry>
            <entry><para>Zoom out</para></entry>
          </row>
          <row valign="middle">               
            <entry><para><keycombo><keycap>Ctrl</keycap><keycap>R</keycap></keycombo></para></entry>
            <entry><para>Reload the document</para></entry>
          </row>
          <row valign="middle">               
            <entry>
            <para><keycap>Page Up</keycap></para></entry>
            <entry><para>Go to the previous page</para></entry>
          </row>
          <row valign="middle">               
            <entry><para><keycap>Page Down</keycap></para></entry>
            <entry><para>Go to the next page</para></entry>
          </row>
          <row valign="middle">               
            <entry>
              <para><keycap>Space</keycap></para>
              <para><keycombo><keycap>Shift</keycap><keycap>Backspace</keycap></keycombo></para>
              <para><keycap>Return</keycap></para>
            </entry>
            <entry><para>Scroll forward</para></entry>
          </row>
          <row valign="middle">               
            <entry>
              <para><keycombo><keycap>Shift</keycap><keycap>Space</keycap></keycombo></para>
              <para><keycap>Backspace</keycap></para>
              <para><keycombo><keycap>Shift</keycap><keycap>Return</keycap></keycombo></para>
            </entry>
            <entry><para>Scroll backward</para></entry>
          </row>
          <row valign="middle">               
            <entry>
            <para><keycombo><keycap>Shift</keycap><keycap>Page Up</keycap></keycombo></para></entry>
            <entry><para>Go a bunch of pages up</para></entry>
          </row>
          <row valign="middle">               
            <entry><para><keycombo><keycap>Shift</keycap><keycap>Page Down</keycap></keycombo></para></entry>
            <entry><para>Go a bunch of pages down</para></entry>
          </row>
          <row valign="middle">               
            <entry><para><keycap>Home</keycap></para></entry>
            <entry><para>Go to the first page</para></entry>
          </row>
          <row valign="middle">               
            <entry><para><keycap>End</keycap></para></entry>
            <entry><para>Go to the last page</para></entry>
          </row>
          <row valign="middle">               
            <entry><para><keycombo><keycap>Ctrl</keycap><keycap>L</keycap></keycombo></para></entry>
            <entry><para>Go to page by number or label</para></entry>
          </row>
          <row valign="middle">               
            <entry><para><keycap>F1</keycap></para></entry>
            <entry><para>Help</para></entry>
          </row>
          <row valign="middle">               
            <entry><para><keycap>F5</keycap></para></entry>
            <entry><para>Run document as presentation</para></entry>
          </row>
          <row valign="middle">               
            <entry><para><keycap>F9</keycap></para></entry>
            <entry><para>Show or hide the side pane</para></entry>
          </row>
          <row valign="middle">               
            <entry><para><keycap>F11</keycap></para></entry>
            <entry><para>Toggle fullscreen mode</para></entry>
          </row>
        </tbody>
      </tgroup>
    </informaltable>
  </sect1>

</article>