+<page xmlns="http://projectmallard.org/1.0/"

+ type="guide" style="task"

+ id="annotation-properties">

+

+ <info>

+ <link type="guide" xref="annotations"/>

+ <desc>How to customize the author, color, style or icon of an annotation.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+ </info>

+

+ <title>Customize annotations</title>

+

+<steps>

+ <item>

+ <p>

+ Right click on the annotation icon in the document.

+ </p>

+ </item>

+ <item>

+ <p>

+ Select <gui>Annotation Properties…</gui>.

+ </p>

+ </item>

+ <item>

+ <p>

+ In the <gui>Annotation Properties</gui> window, you can change the author, color, style and icon of your note.

+ </p>

+ <note>

+ <p>

+ The annotation properties will be applied to the note for which you made the changes only. Each note can have a different set of properties.

+ </p>

+ </note>

+ </item>

+</steps>

+

+

+<section id="change-default">

+ <title>Can I permanently change the default annotation properties?</title>

+<p>

+ The default annotation properties (author, colour, style and icon) can only be changed on a particular note as stated above. So if you want all icons for your notes to be <gui>red</gui> instead of <gui>yellow</gui>, you will have to change the default from <gui>yellow</gui> to <gui>red</gui> individually on each note. There is no way to save different default settings for annotation properties, at this time.

+</p>

+</section>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ xmlns:its="http://www.w3.org/2005/11/its"

+ type="topic" style="task"

+ id="annotations-delete">

+

+ <info>

+ <link type="guide" xref="index#annotations"/>

+ <link type="seealso" xref="annotations-save"/>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>David King</name>

+ <email its:translate="no">[email protected]</email>

+ </credit>

+

+ <include href="legal-unported.xml" xmlns="http://www.w3.org/2001/XInclude"/>

+

+ <desc>Delete annotations from a PDF document.</desc>

+ </info>

+

+ <title>Removing annotations</title>

+

+ <p>An annotation is a note or comment added to a PDF document. You can remove

+ annotations that you or other people have added.</p>

+

+ <steps>

+ <item>

+ <p>View a page that has an annotation. If you are not sure which pages

+ have annotations, find them in the

+ <link xref="annotations-navigate">annotation side pane</link>.</p>

+ </item>

+ <item>

+ <p>Right-click on the annotation icon in the document, and click

+ <gui style="menuitem">Remove Annotation</gui>.</p>

+ </item>

+ <item>

+ <p>Save the changes to a new document by clicking <gui style="menuitem">File</gui>, followed by <gui style="menuitem">Save As…</gui>.</p>

+ </item>

+ </steps>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="annotations-disabled">

+<info>

+ <link type="guide" xref="index#annotations"/>

+ <link type="seealso" xref="annotations"/>

+ <desc>Annotations can only be added to PDF files.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+</info>

+<title>Can't add annotations?</title>

+ <p>

+ Annotations can only be added to PDF files. If your file is of a format other than PDF, the option to add annotations will be greyed out (disabled).

+ </p>

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="annotations-navigate">

+

+ <info>

+ <link type="guide" xref="index#annotations"/>

+ <desc>How to navigate to annotations.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+ <title>Annotation navigation</title>

+ <p>

+ If you have created annotations on your document, you can use the side pane to display the list of all the annotations in the document. The list indicates the type, page number and author of the annotation.

+ </p>

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ xmlns:its="http://www.w3.org/2005/11/its"

+ type="topic" style="task"

+ id="annotations-save">

+<info>

+ <link type="guide" xref="index#annotations"/>

+ <desc>How to save your annotations.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ </credit>

+ <credit type="editor">

+ <name>Shobha Tyagi</name>

+ <email its:translate="no">[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+</info>

+<title>Save a copy of an annotated PDF</title>

+ <p>

+ To save a copy of your annotated PDF for future viewing using

+ <app>Atril</app> or any other PDF viewer

+ <em>that supports annotations</em>:

+ </p>

+ <steps>

+ <item>

+ <p>

+ Click <guiseq><gui>File</gui><gui>Save As…</gui></guiseq>

+ </p>

+ </item>

+ <item>

+ <p>

+ Choose a name and folder in which to save the file, then click

+ <gui>Save</gui>. The PDF will be saved in the folder you chose.

+ </p>

+ </item>

+ </steps>

+ <p>

+ Annotations are added according to the PDF specification. Therefore, most PDF

+ readers should be able to read them. Adobe Reader is known to work.

+ </p>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ xmlns:its="http://www.w3.org/2005/11/its"

+ type="guide" style="task"

+ id="annotations">

+

+ <info>

+ <link type="guide" xref="index#annotations"/>

+ <desc>How to create and customize annotations.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ </credit>

+ <credit type="author">

+ <name>Andre Klapper</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+<title>Adding annotations</title>

+<p>

+ An annotation is a note or comment added to a PDF document. You can add annotations using Atril.

+</p>

+<p>

+ When you open a file, you should have a side pane on the left side of the window.

+ If you do not have a visible side pane, click

+ <guiseq><gui style="menuitem">View</gui>

+ <gui style="menuitem">Sidepane</gui></guiseq>

+ or press the <key>F9</key> key on the keyboard.

+</p>

+

+<p>

+ At the top of the side pane, the items in the drop-down list <gui>Thumbnails</gui>, <gui>Index</gui>, <gui>Annotations</gui> and <gui>Bookmarks</gui> let you choose what to display in the side pane. (Some options may not be available for some documents).

+</p>

+<p>

+ To create an annotation:

+</p>

+<steps>

+ <item>

+ <p>

+ Select <gui style="button">Annotations</gui> from the drop-down list:

+ </p>

+ </item>

+ <item>

+ <p>

+ Click on <gui style="button">Add</gui> to add a text annotation.

+ </p>

+ </item>

+ <item>

+ <p>

+ Click on the spot in the document window you would like to add the annotation to. Your <em>annotation</em> window will open.

+ </p>

+ </item>

+ <item>

+ <p>

+ Type your text into the <em>annotation</em> window.

+ </p>

+ <note>

+ <p>

+ You can resize the note by clicking and holding the left mouse button on one of the bottom corners of the note, and moving it around.

+ </p>

+ </note>

+ </item>

+ <item>

+ <p>

+ Close the note by clicking on the <gui>x</gui> in the top corner of the note.

+ </p>

+ </item>

+</steps>

+

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ xmlns:its="http://www.w3.org/2005/11/its"

+ type="topic" style="task"

+ id="bookmarks">

+

+ <info>

+ <link type="guide" xref="index#annotations"/>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Tiffany Antopolski</name>

+ <email its:translate="no">[email protected]</email>

+ </credit>

+ <credit type="editor">

+ <name>Ekaterina Gerasimova</name>

+ <email its:translate="no">[email protected]</email>

+ </credit>

+

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ <desc>You can use annotations like bookmarks.</desc>

+ </info>

+

+<title>Bookmarks</title>

+

+ <p>You can add, rename and delete bookmarks using the <app>Document

+ Viewer</app>.</p>

+

+ <p>When you open a file, you should have a side pane on the left side of the window.

+ If you do not have a visible side pane, click

+ <guiseq><gui style="menuitem">View</gui>

+ <gui style="menuitem">Sidepane</gui></guiseq>, or press the <key>F9</key> key on the keyboard.</p>

+

+ <p>At the bottom of this side pane, select the <gui style="button">Bookmarks</gui>

+ from the drop-down list.</p>

+

+ <links type="section"/>

+

+<section id="create">

+ <title>Create a bookmark</title>

+

+ <steps>

+ <item>

+ <p>In the PDF document itself, navigate to the page to which you would

+ like to add the bookmark.</p>

+ </item>

+ <item>

+ <p>In the side pane, select <gui style="button">Bookmarks</gui>

+ from the drop-down list.</p>

+ </item>

+ <item>

+ <p>Press the <gui style="button">+</gui> button at the bottom of the side

+ pane. The default name of the bookmark you just added is the page number

+ of the document.</p>

+ </item>

+ <item>

+ <p>The bookmark is now listed in the bookmarks list.</p>

+ </item>

+ </steps>

+

+</section>

+

+<section id="rename">

+ <title>Rename a bookmark</title>

+

+ <steps>

+ <item><p>In the side pane, select <gui style="button">Bookmarks</gui>

+ from the drop-down list.</p></item>

+ <item><p>Select the bookmark in the side pane.</p></item>

+ <item><p>Click on the bookmark name.</p></item>

+ <item><p>Enter the new name.</p></item>

+ <item><p>Press <key>Enter</key>.</p></item>

+ </steps>

+

+</section>

+

+<section id="delete">

+ <title>Delete a bookmark</title>

+

+ <steps>

+ <item><p>In the side pane, select <gui style="button">Bookmarks</gui>

+ from the drop-down list.</p></item>

+ <item><p>Press the <gui style="button">-</gui> button at the bottom of the side pane.</p></item>

+ </steps>

+

+</section>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="bug-filing">

+

+ <info>

+ <link type="guide" xref="index#getInvolved"/>

+ <desc>How and where to report problems.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+ </info>

+

+<title>File a bug against Atril</title>

+<p>

+ Atril is maintained by a volunteer community. You are welcome to participate. If you notice a problem you can file a <em>bug report</em>. To file a bug, go to <link href="https://github.com/mate-desktop/atril/issues"/>.

+ </p>

+ <p>

+ This is a bug tracking system where users and developers can file details about bugs, crashes and request enhancements.

+ </p>

+ <p>

+ To participate you need an account which will give you the ability to gain access, file bugs, and make comments. Also, you need to register so you can receive updates by e-mail about the status of your bug. If you don't already have an account, just click on the <gui>Sign in / Register</gui> link to create one.

+ </p>

+ <p>

+ Once you have an account, log in, and click on <gui>New issue</gui>.

+ </p>

+ <p>

+ Fill in the Title and Description sections and click <gui>Submit Issue</gui>.

+ </p>

+ <p>

+ Your report will be given an ID number, and its status will be updated as it is being dealt with.

+ </p>

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="commandline">

+

+ <info>

+ <link type="guide" xref="index#advanced"/>

+ <title type="sort">Command line</title>

+ <desc>The <cmd>atril</cmd> command can open any number of files, at specific pages and in various modes.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Phil Bull</name>

+ <email>[email protected]</email>

+ </credit>

+ <credit type="editor">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+ </info>

+

+<title>The command line</title>

+<p>

+To start<app>Atril</app> from the command line, type <cmd>atril</cmd>. You

+can open a specific file by typing the filename after the atril command:

+</p>

+

+<screen>atril file.pdf</screen>

+<p>

+You can open multiple files by typing the filenames after the atril command, separating the filenames by a space:

+</p>

+<screen>atril file1.pdf file2.pdf</screen>

+<p>

+Atril also supports the handling of files on the web. For example, after the atril command you can give the location of a file on the web:

+</p>

+<section id="open">

+ <title>Opening a document at a specific page</title>

+ <p>

+ You can use<cmd>--page-label</cmd> switch to open a document at a

+ specific page. For example, to open a document to page 3, you would type:

+ </p>

+ <screen>atril --page-label=3 file.pdf</screen>

+ <p>

+ The page label should be in the same format as the page number displayed in

+ <app>Atril</app> header bar.

+ </p>

+</section>

+<section id="fullsreen">

+ <title>Opening a document in fullscreen mode</title>

+ <screen>atril --fullscreen file.pdf</screen>

+</section>

+<section id="presentation">

+ <title>Opening a document in presentation mode</title>

+ <screen>atril --presentation file.pdf</screen>

+</section>

+<section id="preview">

+ <title>Opening a document in preview mode</title>

+ <screen>atril --preview file.pdf</screen>

+</section>

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="convertPostScript">

+

+ <info>

+ <link type="guide" xref="index#tips"/>

+ <desc>You can convert a document to PostScript.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Phil Bull</name>

+ <email>[email protected]</email>

+ </credit>

+ <credit type="editor">

+ <name>Anna Philips</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+<title>Converting a document to PostScript</title>

+

+<p>

+You can convert documents of the following format types to PostScript files:

+</p>

+<list>

+ <item><p>DjVu (.djvu, .djv)</p></item>

+ <item><p>Portable Document Format (.pdf)</p></item>

+ <item><p>Tagged Image File Format (.tiff, .tif)</p></item>

+</list>

+<p>

+This works by opening the file in <app>Atril</app> and "printing" the document as a PostScript file.

+</p>

+<steps>

+ <item>

+ <p> Go to

+ <guiseq><gui style="menuitem">File</gui>

+ <gui style="menuitem">Print</gui></guiseq>

+ and

+ select <gui>Print</gui> or press

+ <keyseq><key>Ctrl</key><key>P</key></keyseq> and go to the

+ <gui>General</gui> tab.</p>

+ </item>

+ <item>

+ <p>

+ Select <gui>Print to File</gui> and choose PostScript as the

+ <gui>Output format</gui>.

+ </p>

+ </item>

+ <item>

+ <p>

+ Choose a name and folder in which to save the file, then click <gui>Print</gui>.

+ The PostScript file will be saved in the folder you chose.

+ </p>

+ </item>

+</steps>

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="convertSVG">

+

+ <info>

+ <link type="guide" xref="index#tips"/>

+ <desc>You can convert a document to SVG by "printing" it to a file.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Phil Bull</name>

+ <email>[email protected]</email>

+ </credit>

+ <credit type="editor">

+ <name>Anna Philips</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+<title>Converting a document to SVG</title>

+<p>

+You can convert documents of the following format types to SVG files:

+</p>

+<list>

+ <item><p>Portable Document Format (.pdf)</p></item>

+</list>

+<p>

+This works by opening the file in <app>Atril</app> and "printing" the document as an SVG file.

+</p>

+<steps>

+ <item>

+ <p> Go to

+ <guiseq><gui style="menuitem">File</gui>

+ <gui style="menuitem">Print</gui></guiseq>

+ and

+ select <gui>Print</gui> or press

+ <keyseq><key>Ctrl</key><key>P</key></keyseq>.</p>

+ </item>

+ <item>

+ <p>

+ Select <gui>Print to File</gui> and choose SVG as the

+ <gui>Output format</gui>.

+ </p>

+ </item>

+ <item>

+ <p>

+ Choose a name and folder in which to save the file, then click <gui>Print</gui>.

+ The SVG file will be saved in the folder you chose.

+ </p>

+ </item>

+</steps>

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="convertpdf">

+

+ <info>

+ <link type="guide" xref="index#tips"/>

+ <desc>You can convert a document to PDF by "printing" it to a file.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Phil Bull</name>

+ <email>[email protected]</email>

+ </credit>

+ <credit type="editor">

+ <name>Anna Philips</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+<title>Converting a document to PDF</title>

+

+<p>

+You can convert documents of the following format types into PDF format:

+</p>

+<list>

+ <item><p>Device Independent file format (.dvi)</p></item>

+ <item><p>PostScript (.ps)</p></item>

+</list>

+<p>

+This works by opening the file in <app>Atril</app> and "printing" the document as a PDF file.

+</p>

+<steps>

+ <item>

+ <p> Go to

+ <guiseq><gui style="menuitem">File</gui>

+ <gui style="menuitem">Print</gui></guiseq>

+ and

+ select <gui>Print</gui> or press

+ <keyseq><key>Ctrl</key><key>P</key></keyseq> on your keyboard.</p>

+ </item>

+ <item>

+ <p>

+ Select <gui>Print to File</gui> and choose PDF as the

+ <gui>Output format</gui>.

+ </p>

+ </item>

+ <item>

+ <p>

+ Choose a name and folder in which to save the file, then click <gui>Print</gui>.

+ The PDF will be saved in the folder you chose.

+ </p>

+ </item>

+</steps>

+<note>

+<p>

+You can't select text in PostScript or .dvi files, but you usually can do

+this in PDF files. Converting .dvi or PostScript files to PDF will not make

+the text selectable. This is because the text itself isn't stored in the file

+(it's just an image of what the text looks like), so there is no way to recover

+it and put it in the PDF. You can use <em>Optical Character Recognition</em>

+(OCR) software to extract the text from files if you need to.

+</p>

+</note>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="default-settings">

+

+ <info>

+ <link type="guide" xref="index#faq"/>

+ <desc>Save current settings as default for new documents.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Sindhu S</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+ <title>Change default settings</title>

+

+ <p>When a document is opened for the first time, default settings, such as

+ zoom and page view preferences, are applied. Any changes you make to these

+ settings are saved for the document.</p>

+ <p>You can save the settings which you are currently using as default for all

+ new documents by pressing <gui style="menuitem">Edit</gui>

+ and selecting <gui style="menuitem">Save Current Settings as Default</gui>.</p>

+

+ <note style="important">

+ <p>The new default settings do not override settings of previously opened

+ documents, they are applied only to documents opened for the first time.</p>

+ </note>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="develop">

+

+ <info>

+ <link type="guide" xref="index#getInvolved"/>

+ <desc>Improve <app>Atril</app>.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author copyright">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ <years>2011</years>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+ </info>

+

+<title>Help develop</title>

+ <p>

+ Atril is developed and maintained by a volunteer community. You are welcome to participate.

+ </p>

+ <p>

+ If you would like to <link href="https://mate-desktop.org/development/">help develop</link> Atril, create a <link href="https://github.com/mate-desktop/atril">Pull Request</link>.

+ </p>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="documentation">

+ <info>

+ <link type="guide" xref="index#getInvolved"/>

+ <desc>Contact the Documentation Team.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="editor copyright">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ <years>2011</years>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+ </info>

+

+<title>Help write documentation</title>

+

+<p>

+ Atrils documentation is maintained by a volunteer community. You are welcome to participate.</p>

+

+<p>To contribute to the Documentation Project, feel free to get in touch with us and create a <link href="https://github.com/mate-desktop/atril">Pull Request</link>.

+</p>

+<p>

+Our <link href="https://mate-desktop.org/development/">website</link> contains useful information.

+</p>

+

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="duplex-npage">

+

+ <info>

+ <link type="guide" xref="print-booklet#doubleSided"/>

+

+ <desc>Print a booklet with n pages.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+<title>n-page booklet</title>

+ <note style="important">

+ <p>

+ <em>n</em> is a multiple of 4.

+ </p>

+ </note>

+

+ <p>

+ If the number of pages in your PDF document is not a multiple of 4, you should add the appropriate number of blank pages (1,2 or 3) to make it a multiple of 4.

+ To do so, you can:

+ </p>

+ <steps>

+ <item>

+ <p>

+ Create a blank PDF using <app>LibreOffice Writer</app>.

+ </p>

+ </item>

+ <item>

+ <p>

+ Merge the blank pages with your PDF document using <app>PDF-Shuffler</app> placing the blank pages at the end.

+ </p>

+ </item>

+</steps>

+

+

+<steps>

+ <item>

+ <p>

+ Go to <guiseq><gui style="menuitem">File</gui><gui style="menuitem">Print</gui></guiseq> and press the <gui style="button">Print</gui> button.

+ </p>

+ </item>

+ <item>

+ <p>

+ Choose the <gui>General</gui> tab.

+ </p>

+ <p>

+ Under <em>Range</em>, choose <gui>Pages</gui>.

+ </p>

+ <tree>

+ <item>

+ Type the numbers of the pages in this order:

+ <item>n, 1, 2, n-1, n-2, 3, 4, n-3, n-4, 5, 6, n-5, n-6, 7, 8, n-7, n-8, 9, 10, n-9, n-10, 11, 12, n-11...</item>

+ <item>...until you have typed n-number of pages.</item>

+ </item>

+ </tree>

+ </item>

+ <item>

+ <p>

+ Choose the <gui>Page Setup</gui> tab.

+ </p>

+ <p>

+ Under <em>Layout</em>, in the <gui>Two-sided</gui> menu, select <gui>Short Edge (Flip)</gui>.

+ </p>

+ <p>

+ In the <gui>Pages per side</gui> option, select <gui>2</gui>.

+ </p>

+ <p>

+ In the <gui>Page ordering</gui> menu, select <gui>Left to right</gui>.

+ </p>

+ </item>

+ <item>

+ <p>

+ Click <gui>Print</gui>.

+ </p>

+ </item>

+</steps>

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="editing">

+

+ <info>

+ <link type="guide" xref="index#faq"/>

+ <desc>You can't use Atril to edit files.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Phil Bull</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+<title>Can I edit documents in the document viewer?</title>

+

+

+ <p>

+ Atril can't be used to make changes to documents. You need to use the appropriate editing application for the type of file you want to change.

+ </p>

+

+

+<note>

+ <p>

+ PDF and PostScript (.ps) files are not usually intended to be edited, but PDF editing software is available. Try

+ <app>LibreOffice Draw</app> or <app>Okular</app>, for example.

+ Furthermore, <app>pdfarranger</app> allows rearranging or removing pages and merging files.

+ </p>

+</note>

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ xmlns:its="http://www.w3.org/2005/11/its"

+ type="topic" style="task"

+ id="finding">

+

+ <info>

+ <link type="guide" xref="index#reading"/>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Phil Bull</name>

+ <email its:translate="no">[email protected]</email>

+ </credit>

+ <credit type="editor">

+ <name>Anna Philips</name>

+ <email its:translate="no">[email protected]</email>

+ </credit>

+ <credit type="editor">

+ <name>Ekaterina Gerasimova</name>

+ <email its:translate="no">[email protected]</email>

+ </credit>

+

+ <include href="legal-unported.xml" xmlns="http://www.w3.org/2001/XInclude"/>

+

+ <desc>Search for a word or phrase in a document.</desc>

+ </info>

+

+ <title>Find text in a document</title>

+

+ <steps>

+ <item>

+ <p>Click

+ <guiseq><gui style="menuitem">Edit</gui>

+ <gui style="menuitem">Find</gui></guiseq> or

+ <keyseq><key>Ctrl</key><key>F</key></keyseq> or

+ <key>/</key> to display a

+ search box.</p>

+ </item>

+ <item>

+ <p>Start typing into the search box and the search will start

+ automatically.</p>

+ </item>

+ <item>

+ <p>Use the <gui>Find Previous</gui> and <gui>Find Next</gui> buttons to move to the previous

+ or next search result.</p>

+ </item>

+ <item>

+ <p>To hide the search bar, click anywhere in the window

+ again or press <key>Esc</key>.</p>

+ </item>

+ </steps>

+

+ <note style="tip">

+ <p>To filter words by case, you can press the <gui>Case Sensitive</gui>

+ button.</p>

+

+ </note>

+ <p>If the word or phrase that you searched for appears in the document at least once, you will be shown how many times the search result appears on the current page.</p>

+

+ <note>

+ <p>Only PDF documents are searchable. Some PDF documents are not

+ searchable because their text is encoded in the document as an image.</p>

+ </note>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="formats">

+

+ <info>

+ <link type="guide" xref="index#pres"/>

+ <link type="seealso" xref="convertpdf"/>

+ <link type="seealso" xref="convertPostScript"/>

+ <link type="seealso" xref="convertSVG"/>

+ <desc>PDF, PostScript and many others are.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Phil Bull</name>

+ <email>[email protected]</email>

+ </credit>

+ <credit type="author">

+ <name>Ekaterina Gerasimova</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+<title>Supported formats</title>

+

+<p>

+Atril supports the following formats:

+</p>

+<list>

+ <item><p>Comic Book Archive (.cbr and .cbz)</p></item>

+ <item><p>Device Independent file format (.dvi)</p></item>

+ <item><p>DjVu (.djvu, .djv)</p></item>

+ <item><p>Open XML Paper Specification (.oxps, .xps)</p></item>

+ <item><p>Portable Document Format (.pdf)</p></item>

+ <item><p>PostScript (.ps)</p></item>

+</list>

+<note>

+<p>

+In some Linux distributions, not all formats are supported by default, so you might not be able to view all the formats listed above.

+</p>

+<p>

+Support for a format is called a <em>backend</em>. If you get the error "Unable to Open Document", you may wish to check whether the backend package for the format is installed.

+</p>

+</note>

+

+

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="forms-saving">

+

+ <info>

+ <link type="guide" xref="index#forms"/>

+ <desc>Make sure you save the

+ form, otherwise all of the information you entered will be

+ lost.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ </credit>

+ <credit type="editor">

+ <name>Anna Philips</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+ </info>

+

+<title>Saving a form</title>

+

+<p>

+ After you have filled it out, you may wish to save your form in one of two ways:

+</p>

+

+<list type = "numbered">

+<item><p>

+ To save a copy that can be edited in the future (form remains interactive):

+ </p>

+ <steps>

+ <item>

+ <p> Go to

+ <guiseq><gui style="menuitem">File</gui>

+ <gui style="menuitem">Print</gui></guiseq>

+ and

+ select <gui>Save As…</gui> or press

+ <keyseq><key>Ctrl</key><key>S</key></keyseq> on your keyboard.</p>

+ </item>

+ <item>

+ <p>

+ Choose a name and folder to save the file in, then click <gui>Save</gui>.

+ The PDF will be saved in the folder you chose.

+ </p>

+ </item>

+ </steps>

+</item>

+<item><p>

+ To save a copy that can no longer be edited (for example, to e-mail the form or submit it on-line):

+ </p>

+ <steps>

+ <item>

+ <p> Go to

+ <guiseq><gui style="menuitem">File</gui>

+ <gui style="menuitem">Print</gui></guiseq>

+ and select <gui>Print</gui> or press

+ <keyseq><key>Ctrl</key><key>P</key></keyseq> on your keyboard.</p>

+ </item>

+

+

+ <item>

+ <p>

+ Select <gui>Print to File</gui> and choose PDF as the

+ <gui>Output format</gui>.

+ </p>

+ </item>

+ <item>

+ <p>

+ Choose a name and folder to save the file in, then click <gui>Print</gui>.

+ The PDF will be saved in the folder you chose.

+ </p>

+ </item>

+ </steps>

+</item>

+</list>

+

+<note style="bug">

+<p>

+ Copies of encrypted files can't be saved or printed.

+</p>

+</note>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="forms">

+

+ <info>

+ <link type="guide" xref="index#forms"/>

+ <desc>Working with fillable forms.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+<title>Forms</title>

+<p>

+ When filling out an interactive form, you can navigate from field to field by clicking on a field with your mouse. When you are finished filling out a text field, press <key>Enter</key>.

+</p>

+

+<p>

+ You can make a selection in a scrollable list box by clicking on the list box and scrolling to your choice with your mouse.

+</p>

+<note style = "tip">

+ <p>

+There may be some parts of a form that you may need to fill out by hand <em>after</em> you print the form. For example, you might have to circle certain things, or sign the form in one or more places. If you wish to do this electronically, you may want to try <link href = "http://www.g-loaded.eu/2008/05/03/how-to-annotate-pdf-files-in-linux-using-xournal/">Xournal</link>.

+</p>

+</note>

+

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ xmlns:its="http://www.w3.org/2005/11/its"

+ type="guide" style="task"

+ id="index">

+

+ <info>

+ <title type='link' role="trail"><media type="image" its:translate="no" src="figures/atril-trail.png"/></title>

+ <title type='link'>Atril</title>

+ <title type='text'>Atril</title>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Phil Bull</name>

+ <email its:translate="no">[email protected]</email>

+ </credit>

+ <credit type="editor">

+ <name>Tiffany Antopolski</name>

+ <email its:translate="no">[email protected]</email>

+ </credit>

+

+ <include href="legal-unported.xml" xmlns="http://www.w3.org/2001/XInclude"/>

+

+ <desc><app>Atril</app> is

+ made for viewing PDF documents. Learn how to get started with <app>Atril</app> and its features.</desc>

+

+ </info>

+

+ <title>

+ <media type="image" its:translate="no" src="figures/atril.png" />

+ Atril Help

+ </title>

+

+<section id="reading" style="2column">

+ <title>Reading documents</title>

+</section>

+

+<section id="pres" style="2column">

+ <title>Presentations and other supported formats</title>

+</section>

+

+<section id="printing" style="2column">

+ <title>Printing</title>

+</section>

+

+<section id="annotations" style="2column">

+ <title>Annotations and bookmarks</title>

+</section>

+

+<section id="forms" style="2column">

+ <title>Interactive forms</title>

+</section>

+

+<section id="faq" style="2column" >

+ <title>Frequently asked questions</title>

+</section>

+

+<section id="advanced" style="2column">

+ <title>Advanced</title>

+</section>

+

+<section id="tips" style="2column">

+ <title>Tips and tricks</title>

+</section>

+

+<section id="synctex">

+ <title>SyncTeX</title>

+ <links type="topic" style="2column" groups="first second third fourth fifth sixth"/>

+</section>

+

+<section id="getInvolved" style="2column">

+ <title>Get involved</title>

+</section>

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ xmlns:its="http://www.w3.org/2005/11/its"

+ type="topic" style="task"

+ id="introduction">

+

+ <info>

+ <link type="guide" xref="index"/>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Tiffany Antopolski</name>

+ <email its:translate="no">[email protected]</email>

+ </credit>

+

+ <include href="legal-unported.xml" xmlns="http://www.w3.org/2001/XInclude"/>

+

+ <desc>Introduction to <em>Atril - The MATE Document Viewer</em>.</desc>

+ </info>

+

+ <title>Introduction</title>

+

+ <p><app>Atril</app> is a document viewer. See <link xref="formats"/> for a

+ list of file types you can view.</p>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="invert-colors">

+

+ <info>

+ <link type="guide" xref="index#tips"/>

+

+ <desc>

+ Inverting the colors can make it easier to read some text.

+ </desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Phil Bull</name>

+ <email>[email protected]</email>

+ </credit>

+ <credit type="editor">

+ <name>Anna Philips</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+<title>Invert colors on a page</title>

+

+

+ <p>To swap black for white, white for black, and so on, go to the <gui style="menuitem">View</gui> menu and select <gui style="menuitem">Invert Colours</gui> (or press <keyseq><key>Ctrl</key><key>I</key></keyseq>).</p>

+

+<note style="tip">

+ <p>

+ Doing this can make it easier to read text, especially in the case of certain kinds of visual impairment.

+ </p>

+</note>

+</page>

+<license xmlns="http://projectmallard.org/1.0/"

+ href="http://creativecommons.org/licenses/by-sa/3.0/">

+

+ <p>This work is licensed under a

+ <link href="http://creativecommons.org/licenses/by-sa/3.0/">Creative Commons

+ Attribution-ShareAlike 3.0 Unported License</link>.</p>

+

+</license>

+<license xmlns="http://projectmallard.org/1.0/"

+ href="http://creativecommons.org/licenses/by-sa/3.0/us/">

+<p>This work is licensed under a

+<link href="http://creativecommons.org/licenses/by-sa/3.0/us/">Creative Commons

+Attribution-Share Alike 3.0 United States License</link>.</p>

+<p>As a special exception, the copyright holders give you permission to copy,

+modify, and distribute the example code contained in this document under the

+terms of your choosing, without restriction.</p>

+</license>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic"

+ id="license">

+

+ <info>

+ <link type="seealso" xref="index"/>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <desc>Legal information.</desc>

+ </info>

+

+ <title>License</title>

+ <p>

+ <!--

+ Translators: try to use the same translation as the one provided by the CreativeCommons website.

+ If there is no translation for your language, consider providing one to CreativeCommons.

+ -->

+ This work is distributed under a CreativeCommons Attribution-Share Alike

+ 3.0 Unported license.

+ </p>

+ <p>

+ You are free:

+ </p>

+ <terms>

+ <item>

+ <title><em>To share</em></title>

+ <p>To copy, distribute and transmit the work.</p>

+ </item>

+ <item>

+ <title><em>To remix</em></title>

+ <p>To adapt the work.</p>

+ </item>

+ </terms>

+ <p>

+ Under the following conditions:

+ </p>

+ <terms>

+ <item>

+ <title><em>Attribution</em></title>

+ <p>

+ You must attribute the work in the manner specified by the author or

+ licensor (but not in any way that suggests that they endorse you or

+ your use of the work).

+ </p>

+ </item>

+ <item>

+ <title><em>Share Alike</em></title>

+ <p>

+ If you alter, transform, or build upon this work, you may distribute the

+ resulting work only under the same, similar or a compatible license.

+ </p>

+ </item>

+ </terms>

+ <p>

+ <!-- Translators: there are no official localized versions of the legal code, only the deed is localized. -->

+ For the full text of the license, see the

+ <link href="http://creativecommons.org/licenses/by-sa/3.0/legalcode">CreativeCommons website</link>,

+ or read the full <link href="http://creativecommons.org/licenses/by-sa/3.0/">Commons Deed</link>.

+ </p>

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ xmlns:its="http://www.w3.org/2005/11/its"

+ type="topic" style="task"

+ id="movingaround">

+

+ <info>

+ <link type="guide" xref="index#reading"/>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Phil Bull</name>

+ <email its:translate="no">[email protected]</email>

+ </credit>

+ <credit type="editor">

+ <name>Anna Philips</name>

+ <email its:translate="no">[email protected]</email>

+ </credit>

+

+ <include href="legal-unported.xml" xmlns="http://www.w3.org/2001/XInclude"/>

+

+ <desc>Navigating, scrolling and zooming.</desc>

+ </info>

+

+ <title>Moving around a document</title>

+

+ <p>You can move around each page of a document by any of the following

+ methods:</p>

+

+ <list>

+ <item>

+ <p>Scrolling up and down using the mouse wheel. To move around a page

+ just by moving the mouse:</p>

+ <steps>

+ <item>

+ <p>Right-click the page and select <gui>Autoscroll</gui>.</p>

+ </item>

+ <item>

+ <p>Move the mouse pointer towards the bottom of the window to scroll

+ down; it will scroll faster depending on how far down the window you

+ go.</p>

+ </item>

+ <item>

+ <p>To stop autoscrolling, click anywhere in the document.</p>

+ </item>

+ </steps>

+ </item>

+ <item>

+ <p>Using the scroll bar on the document window.</p>

+ </item>

+ <item>

+ <p>Using the up and down arrow keys of your keyboard.</p>

+ </item>

+ <item>

+ <p>Dragging the page around with your mouse, as if you are grabbing it.

+ To do this:</p>

+ <list>

+ <item>

+ <p>Move the mouse pointer over the page and hold down the middle

+ mouse button to drag it around.</p>

+ </item>

+ <item>

+ <p>If you don't have a middle mouse button, hold down the left and

+ right mouse buttons at the same time, then drag.</p>

+ </item>

+ </list>

+ </item>

+ </list>

+

+<section id="between-pages">

+ <title>Flipping between pages</title>

+

+ <p>You can move between pages of a document using one of the following

+ methods:</p>

+

+ <list>

+ <item>

+ <p>Press the <keyseq><key>Ctrl</key><key>Page Up</key></keyseq> or

+ <keyseq><key>Ctrl</key><key>Page Down</key></keyseq> buttons on the

+ keyboard.</p>

+ </item>

+ <item>

+ <p>To go to a specific page:</p>

+ <list>

+ <item>

+ <p>Type a page number in <gui style="input">Select Page</gui> and press <key>Enter</key>.</p>

+ </item>

+ <item>

+ <p>If you want to go to the beginning or the end of the document:</p>

+ <list>

+ <item>

+ <p>Press <keyseq><key>Ctrl</key><key>Home</key></keyseq> on your

+ keyboard.</p>

+ </item>

+ <item>

+ <p>Press <keyseq><key>Ctrl</key><key>End</key></keyseq> on your

+ keyboard.</p>

+ </item>

+ </list>

+ </item>

+ </list>

+ </item>

+ <item>

+ <p>To move ten pages at a time, press <keyseq><key>Shift</key><key>Page

+ Up</key></keyseq> or <keyseq><key>Shift</key><key>Page

+ Down</key></keyseq>.</p>

+ <note style="tip">

+ <p>You can only move around one page at a time, by default. If you want

+ to move between pages just by scrolling or dragging, go to the <gui style="menuitem">View</gui> menu

+ and select

+ <gui style="menuitem">Continuous</gui>.</p>

+ </note>

+ </item>

+ </list>

+

+</section>

+

+<section id="navigating">

+ <title>Navigating with a page list or table of contents</title>

+

+ <p>When you open a file, you should have a side pane on the left side of the window.

+ If you do not have a visible side pane,

+ <guiseq><gui style="menuitem">View</gui>

+ <gui style="menuitem">Sidepane</gui></guiseq>

+ or press the <key>F9</key> key on the keyboard.</p>

+

+ <p>The side pane shows a preview of all of the pages in the document.</p>

+

+ <p>You can move between pages by clicking on them in the side pane.</p>

+

+ <note>

+ <p>Some documents have an index or table of contents, which you can display

+ in the side pane. Select the <gui>Thumbnails</gui> Combobox at the top of the

+ side pane and select <gui>Index</gui> to view it.</p>

+ <note style = "tip">

+ <p>Most documents don't use this feature, so you won't be able to view

+ their index in the side pane.</p>

+ </note>

+ </note>

+

+</section>

+

+<section id="zoom">

+ <title>Zooming in and out</title>

+

+ <p>To adjust the zoom level:</p>

+

+ <list>

+ <item>

+ <p>Select the desired zoom percentage from combobox in the toolbar.</p>

+ </item>

+ <item>

+ <p>Alternatively, use the keyboard shortcuts <keyseq><key>Ctrl</key><key>+</key></keyseq>

+ to zoom in, or <keyseq><key>Ctrl</key><key>-</key></keyseq> to zoom out.</p>

+ </item>

+ <item>

+ <p>Alternatively, hold down <key>Ctrl</key> and use your mouse scroll wheel to zoom.</p>

+ </item>

+ </list>

+

+ <note>

+ <p>The <gui>Fit Page</gui> option will make a document page fit the whole

+ <em>height</em> of the window.</p>

+ <p>The <gui>Fit Width</gui> option will make a document page fill the whole

+ <em>width</em> of the window.</p>

+ <p>If you want to see two pages at once, side by side, like in a book,

+ go to <guiseq><gui style="menuitem">View</gui><gui style="menuitem">Dual</gui></guiseq> and press

+ <gui style="menuitem">Dual</gui>.</p>

+ <p>If the allow-links-change-zoom gsetting is set to false, links are blocked

+ from changing your zoom level.</p>

+ </note>

+

+ <p>You can use the whole of your screen to view the document:</p>

+

+ <list>

+ <item>

+ <p>Press <key>F11</key>.</p>

+ </item>

+ <item>

+ <p>To exit the full screen mode:</p>

+ <p>Press <key>F11</key> or <key>Escape</key></p>

+ </item>

+ </list>

+</section>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ xmlns:its="http://www.w3.org/2005/11/its"

+ xmlns:if="http://projectmallard.org/if/1.0/"

+ type="topic" style="task"

+ id="noprint">

+

+ <info>

+ <link type="guide" xref="index#printing"/>

+ <desc>The author may have put printing restrictions on the document.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Phil Bull</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+<title>I can't print a document</title>

+<section id="why">

+ <title>Possible reasons for printing failure</title>

+<p>A document might not print because of:</p>

+ <list>

+ <item><p>Printer problems or, </p></item>

+ <item><p>PDF printing restrictions.</p></item>

+ </list>

+</section>

+

+<section id="printer-problems">

+ <title>Printer problems</title>

+ <p>

+ There are many reasons why your printer might not be working. For example, it

+ could be out of paper or ink, or unplugged or damaged.

+ </p>

+ <p>

+ You might want to check your printer configuration in the Control Centre.

+ </p>

+</section>

+

+<section id="pdf-restrictions">

+ <title>PDF printing restrictions</title>

+ <p>

+ Some PDF documents have a setting which prevents you from printing them.

+ Authors can set this printing restriction when they write a document.

+ Atril overrides this restriction by default, but you may want to check

+ that it hasn't been disabled:

+ </p>

+

+ <note style="important">

+ <p>You need to have <app>dconf Editor</app> installed on your computer to

+ change this setting.</p>

+ </note>

+

+ <steps>

+ <item>

+ <p>Open <gui>dconf Editor</gui>.</p>

+ </item>

+ <item>

+ <p>Browse to <sys>/org/mate/atril</sys>.</p>

+ </item>

+ <item>

+ <p>

+ Make sure that the <gui>override-restrictions</gui> option is checked.

+ </p>

+ </item>

+ <item>

+ <p>

+ Go back to<app>Atril</app> and try to print the document again.

+ </p>

+ </item>

+ </steps>

+</section>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="openerror">

+

+ <info>

+ <link type="guide" xref="index#faq"/>

+ <desc>Error When Opening A File.</desc>

+ <link type="seealso" xref="formats"/>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+<title>Why can't I open a file?</title>

+

+<p>If you try to open a document of a format that Atril does not recognize, you will get an "Unable to open document" error message. Click <gui>Close</gui> to return to<app>Atril</app> window.

+</p>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ xmlns:its="http://www.w3.org/2005/11/its"

+ type="topic" style="task"

+ id="opening">

+

+ <info>

+ <link type="guide" xref="index#reading"/>

+ <link type="seealso" xref="formats"/>

+ <link type="seealso" xref="commandline"/>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Tiffany Antopolski</name>

+ <email its:translate="no">[email protected]</email>

+ </credit>

+ <credit type="editor">

+ <name>Ekaterina Gerasimova</name>

+ <email its:translate="no">[email protected]</email>

+ </credit>

+

+ <include href="legal-unported.xml" xmlns="http://www.w3.org/2001/XInclude"/>

+

+ <desc>How to open a document.</desc>

+ </info>

+

+ <title>Open a document</title>

+

+ <p>You can open a document using any one of the following ways:</p>

+

+ <list>

+ <item>

+ <p>Double-click on the file in <app>Caja</app> or your <em>file

+ manager</em>.</p>

+ <note style="tip">

+ <p>Double clicking PDF, PostScript, .djvu, .dvi and Comic Book

+ Archive files opens them in <app>Atril</app> by default.</p>

+ </note>

+ </item>

+ <item>

+ <p>Right-click on a file icon in <app>Caja</app> and click

+ <guiseq><gui>Open With</gui><gui>Atril</gui></guiseq>.</p>

+ </item>

+ </list>

+

+ <p>If an empty <app>Atril</app> window is already open you can:</p>

+

+ <list>

+ <item>

+ <p>Drag a file into the window from <app>Caja</app>. The new file will

+ open in a new window.</p>

+ </item>

+ <item>

+ <p>Press the <gui>Open…</gui> button in the top-left corner of

+ the window. In the <gui>Open Document</gui>

+ dialog, choose the file which you wish to open, and click

+ <gui>Open</gui>. The file will open in a new window.</p>

+ </item>

+ </list>

+

+ <p>If a document is already opened in a <app>Atril</app> window you can:</p>

+

+ <list>

+ <item>

+ <p>Drag a file into the window from <app>Caja</app>. The new file will

+ open in a new window.</p>

+ </item>

+ <item>

+ <p>Press <keyseq><key>Ctrl</key><key>O</key></keyseq>. In the <gui>Open Document</gui>

+ dialog, choose the file which you wish to open, and click

+ <gui>Open</gui>. The file will open in a new window.</p>

+ </item>

+ </list>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ xmlns:its="http://www.w3.org/2005/11/its"

+ type="topic" style="task"

+ id="password">

+

+ <info>

+ <link type="guide" xref="index#reading"/>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Phil Bull</name>

+ <email its:translate="no">[email protected]</email>

+ </credit>

+ <credit type="editor">

+ <name>Ekaterina Gerasimova</name>

+ <email its:translate="no">[email protected]</email>

+ </credit>

+

+ <include href="legal-unported.xml" xmlns="http://www.w3.org/2001/XInclude"/>

+

+ <desc>Handling password protected PDFs.</desc>

+ </info>

+

+ <title>Password-protected documents</title>

+

+ <p>If you try to open a PDF document that is protected with a password, a

+ window will appear asking you to enter the document password. Enter the

+ password and click <gui>Unlock Document</gui>.</p>

+

+<!-- TODO: not sure both types are relevant

+ <p>There are two types of passwords:</p>

+

+ <list>

+ <item>

+ <p>The <em>user password</em> is needed to view the document.</p>

+ </item>

+ <item>

+ <p>The <em>master password</em> is required to print the document as well

+ as view it.</p>

+ </item>

+ </list>

+

+ <note>

+ <p>These passwords are set by the person who created the document.</p>

+ </note>

+-->

+

+ <note>

+ <p>Passwords can be set by the person who created or edited the

+ document.</p>

+ </note>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="presentations">

+

+ <info>

+ <link type="guide" xref="index#pres"/>

+ <desc>How to play presentations.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Phil Bull</name>

+ <email>[email protected]</email>

+ </credit>

+ <credit type="editor">

+ <name>Anna Philips</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+<title>Presentations</title>

+<section id="start-presentation">

+<title>Starting a presentation</title>

+<p>To start a presentation:</p>

+<steps>

+ <item>

+ <p><link xref="opening">Open a file</link></p>

+ </item>

+ <item>

+ <p>Press <gui style="menuitem">View</gui> and select

+ <gui style="menuitem">Presentation</gui> (or press <key>F5</key>).</p>

+ <p>

+ The presentation will be displayed full screen.

+ </p>

+ </item>

+</steps>

+</section>

+<section id="present">

+ <title>

+ Moving through a presentation

+ </title>

+ <p>

+ Use the <key>spacebar</key>, <key>&#8594;</key>, <key>&#8595;</key>, or left mouse click to go to the next slide.

+ </p>

+ <p>

+ Use the <key>&#8592;</key>, <key>&#8593;</key> or right mouse click to go to the previous slide.

+ </p>

+ <note style = "tip">

+ <p>

+ You can also use the scroll wheel to move back and forth through the presentation.

+ </p>

+ </note>

+ <p>

+ Use <key>Esc</key> to exit the presentation.

+ </p>

+</section>

+

+<section id="blank-screen">

+<title>Showing a blank screen</title>

+<p>Press <key>B</key> or <key>.</key> to show a black screen.</p>

+<p>Press <key>W</key> to show a white screen.</p>

+<p>Press <key>B</key>, <key>.</key>, or <key>W</key> again to show the

+slide.</p>

+</section>

+

+<section id="file-formats">

+<title>Supported presentation file formats</title>

+<p>

+The following file formats can be used for presentations:

+</p>

+<list>

+ <item><p>Comic Book Archive (.cbr and .cbz)</p></item>

+ <item><p>Device Independent file format (.dvi)</p></item>

+ <item><p>DjVu (.djvu, .djv)</p></item>

+ <item><p>Open Document Presentation (.odp)</p></item>

+ <item><p>Portable Document Format (.pdf)</p></item>

+ <item><p>PostScript (.ps)</p></item>

+</list>

+</section>

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="guide" style="task"

+ id="print-2sided">

+

+ <info>

+ <link type="guide" xref="printing"/>

+

+ <desc>Printing two-sided and multi-page per sheet.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Phil Bull</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+<title>Two-sided and multiple pages per side layout for printing</title>

+

+<p>

+ You can print on both sides of each sheet of paper:

+</p>

+

+<steps>

+ <item>

+ <p>

+ Go to <guiseq><gui style="menuitem">File</gui><gui style="menuitem">Print</gui></guiseq> and press the <gui style="button">Print</gui> button.

+ </p>

+ </item>

+ <item>

+ <p>

+ Go to the <gui>Page Setup</gui> tab of the Print window and choose an option from the <gui>Two-sided</gui> drop-down list.

+ </p>

+ </item>

+ <item>

+ <p>

+ You can print more than one page of the document per <em>side</em> of paper too. Use the <gui>Pages per side</gui> option to do this.

+ </p>

+ </item>

+</steps>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="guide" style="task"

+ id="print-booklet">

+

+ <info>

+ <link type="guide" xref="index#printing"/>

+

+ <desc>How to print a booklet.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+<title>Printing a booklet</title>

+

+<p>

+ If you are printing a booklet (which will perhaps be bound or stapled in the middle of each page), select the type of printer you will be using for printing from the list below. Then select the number of printed pages your booklet will have.

+</p>

+

+<section id="singleSided" style="2column">

+ <title>Printer allows single-sided printing</title>

+</section>

+

+<section id="doubleSided" style="2column">

+ <title>Printer allows double-sided printing</title>

+</section>

+

+

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ xmlns:its="http://www.w3.org/2005/11/its"

+ type="guide" style="task"

+ id="print-differentsize">

+

+ <info>

+ <link type="guide" xref="printing"/>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Phil Bull</name>

+ <email its:translate="no">[email protected]</email>

+ </credit>

+ <credit type="author">

+ <name>Ekaterina Gerasimova</name>

+ <email its:translate="no">[email protected]</email>

+ <years>2015</years>

+ </credit>

+

+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>

+

+ <desc>Printing a document on paper of a different size or

+ orientation.</desc>

+ </info>

+

+ <title>Changing the paper size when printing</title>

+

+ <p>If you want to change the paper size of your document (for example, print

+ a US Letter-sized PDF on A4 paper), you can change the printing format for

+ the document.</p>

+

+ <steps>

+ <item>

+ <p>Go to <guiseq><gui style="menuitem">File</gui><gui style="menuitem">Print</gui></guiseq> and press the <gui style="button">Print</gui> button.</p>

+ </item>

+ <item>

+ <p>Select the <gui>Page Setup</gui> tab.</p>

+ </item>

+ <item>

+ <p>Under the <em>Paper</em> column, choose your <em>Paper size</em> from

+ the drop-down list.</p>

+ </item>

+ <item>

+ <p>Click <gui>Print</gui> and your document should print.</p>

+ </item>

+ </steps>

+

+ <p>You can also use the <em>Orientation</em> menu to choose a different

+ orientation:</p>

+

+ <list>

+ <item>

+ <p><gui>Portrait</gui></p>

+ </item>

+ <item>

+ <p><gui>Landscape</gui></p>

+ </item>

+ <item>

+ <p><gui>Reverse portrait</gui></p>

+ </item>

+ <item>

+ <p><gui>Reverse landscape</gui></p>

+ </item>

+ </list>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ xmlns:its="http://www.w3.org/2005/11/its"

+ type="guide" style="task"

+ id="print-pagescaling">

+

+ <info>

+ <link type="guide" xref="printing"/>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Ekaterina Gerasimova</name>

+ <email its:translate="no">[email protected]</email>

+ <years>2015</years>

+ </credit>

+

+ <include href="legal-unported.xml" xmlns="http://www.w3.org/2001/XInclude"/>

+

+ <desc>Shrink or expand the document to fit the paper size.</desc>

+ </info>

+

+ <title>Scale page for printing</title>

+

+ <p>If you want to change the paper size of your document (for example, print

+ a US Letter-sized PDF on A4 paper), you can change the printing format for

+ the document.</p>

+

+ <steps>

+ <item>

+ <p>Open the menu at the top-right of the window, then select

+ <gui style="menuitem">Print…</gui>.</p>

+ </item>

+ <item>

+ <p>Select the <gui style="tab">Page Handling</gui> tab.</p>

+ </item>

+ <item>

+ <p>Choose a <em>Page Scaling</em> from the drop-down list.</p>

+ <list>

+ <item>

+ <p><em>None</em>: do not perform page scaling.</p>

+ </item>

+ <item>

+ <p><em>Shrink to Printable Area</em>: document pages larger than the

+ printable area are reduced to fit the printable area of the printer

+ page.</p>

+ </item>

+ <item>

+ <p><em>Fit to Printable Area</em>: document pages are enlarged or

+ reduced as required to fit the printable area of the printer

+ page.</p>

+ </item>

+ </list>

+ </item>

+ <item>

+ <p>Click <gui>Print</gui> to print your document.</p>

+ </item>

+ </steps>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="guide" style="task"

+ id="printing">

+

+ <info>

+ <link type="guide" xref="index#printing" />

+ <link type="seealso" xref="noprint"/>

+

+ <desc>How to print, and common questions about printing.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Phil Bull</name>

+ <email>[email protected]</email>

+ </credit>

+ <credit type="editor">

+ <name>Anna Philips</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+<title>Printing a document</title>

+

+<list>

+ <item><p>To print a document:</p>

+ <steps>

+ <item>

+ <p>Click the <gui>File</gui> menu and

+ select <gui>Print</gui> or press

+ <keyseq><key>Ctrl</key><key>P</key></keyseq>.</p>

+ </item>

+ <item>

+ <p>Choose your printer from the list.</p>

+ </item>

+ <item><p>Click <gui>Print</gui>.</p></item>

+ </steps>

+ </item>

+</list>

+

+<list>

+ <item>

+ <p>Printing is enabled for the following file formats:</p>

+ <list>

+ <item><p>Device Independent file format (.dvi)</p></item>

+ <item><p>DjVu (.djvu, .djv)</p></item>

+ <item><p>Portable Document Format (.pdf)</p></item>

+ <item><p>PostScript (.ps)</p></item>

+ <item><p>Tagged Image File Format (.tiff, .tif)</p></item>

+ </list>

+ </item>

+</list>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="reload">

+

+ <info>

+ <link type="guide" xref="index#faq"/>

+

+ <desc>

+ Your document will be automatically reloaded if another program changes it while you're viewing it.

+ </desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Phil Bull</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+<title>Why does the document keep reloading?</title>

+

+<p>

+ If<app>Atril</app> detects that the document you have open has changed (perhaps because another program has modified it), it will automatically reload the document and display the most recent version for you.

+</p>

+

+<p>

+ If the document is deleted while you are still viewing it, it will still remain open.

+</p>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="shortcuts">

+

+ <info>

+ <link type="guide" xref="index#advanced"/>

+ <desc>See a list of all shortcuts.</desc>

+

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Phil Bull</name>

+ <email>[email protected]</email>

+ </credit>

+ <credit type="author">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ </credit>

+ <credit type="editor">

+ <name>Taufan Lubis</name>

+ <email>[email protected]</email>

+ </credit>

+ <credit type="editor">

+ <name>Ronaldi Santosa</name>

+ <email>[email protected]</email>

+ </credit>

+ <credit type="editor">

+ <name>Ibnu Amansyah</name>

+ <email>[email protected]</email>

+ </credit>

+ <credit type="editor">

+ <name>Andre Klapper</name>

+ <email>[email protected]</email>

+ </credit>

+ <credit type="editor">

+ <name>Germán Poo-Caamaño</name>

+ <email>[email protected]</email>

+ </credit>

+

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+

+<title>Keyboard shortcuts</title>

+

+<section id="default-shortcuts"><title>Default shortcuts</title>

+<section id="open-close-save-print">

+ <title>Opening, closing, saving and printing</title>

+ <table frame="all" rules="cols" shade="rows">

+ <tr>

+ <td><p>Open a document.</p></td>

+ <td><p><keyseq><key>Ctrl</key><key>O</key></keyseq></p></td>

+ </tr>

+ <tr>

+ <td><p>Open a copy of the current document.</p></td>

+ <td><p><keyseq><key>Ctrl</key><key>N</key></keyseq></p></td>

+ </tr>

+ <tr>

+ <td><p>Save a copy of the current document with a new file

+name.</p></td>

+ <td><p><keyseq><key>Ctrl</key><key>S</key></keyseq></p></td>

+ </tr>

+ <tr>

+ <td><p>Print the current document.</p></td>

+ <td><p><keyseq><key>Ctrl</key><key>P</key></keyseq></p></td>

+ </tr>

+ <tr>

+ <td><p>Close the current document window.</p></td>

+ <td><p><keyseq><key>Ctrl</key><key>W</key></keyseq></p></td>

+ </tr>

+ <tr>

+ <td><p>Reload the document (effectively closes and re-opens the

+document).</p></td>

+ <td><p><keyseq><key>Ctrl</key><key>R</key></keyseq></p></td>

+ </tr>

+ </table>

+</section>

+

+<section id="move-around">

+ <title>Moving around a document</title>

+<table frame="all" rules="cols" shade="rows">

+ <tr>

+ <td><p>Move up/down a page.</p></td>

+ <td><p>Arrow keys</p></td>

+ </tr>

+ <tr>

+ <td><p>Move up/down a page several lines at a time.</p></td>

+ <td><p><key>Page Up</key> / <key>Page Down</key></p></td>

+ </tr>

+ <tr>

+ <td><p>Go to the previous page.</p></td>

+ <td><p><keyseq><key>Ctrl</key><key>Page Up</key></keyseq> /

+<key>P</key></p></td>

+ </tr>

+ <tr>

+ <td><p>Go to the next page.</p></td>

+ <td><p><keyseq><key>Ctrl</key><key>Page Down</key></keyseq> /

+<key>N</key></p></td>

+ </tr>

+<tr>

+ <td><p>Go to page number.</p></td>

+ <td><p><keyseq><key>Ctrl</key><key>L</key></keyseq> followed by the page number and <key>Enter</key></p></td>

+</tr>

+ <tr>

+ <td><p>Go to the beginning of a page (beginning of the document if

+<gui>Continuous</gui> is selected in the main menu in the top-right corner).</p></td>

+ <td><p><key>Home</key></p></td>

+ </tr>

+ <tr>

+ <td><p>Go to the end of a page (end of the document if

+<gui>Continuous</gui> is selected in the main menu in the top-right corner).</p></td>

+ <td><p><key>End</key></p></td>

+ </tr>

+ <tr>

+ <td><p>Go to the beginning of the document.</p></td>

+ <td><p><keyseq><key>Ctrl</key><key>Home</key></keyseq></p></td>

+ </tr>

+ <tr>

+ <td><p>Go to the end of the document.</p></td>

+ <td><p><keyseq><key>Ctrl</key><key>End</key></keyseq></p></td>

+ </tr>

+ <tr>

+ <td><p>Add a bookmark in the current page.</p></td>

+ <td><p><keyseq><key>Ctrl</key><key>D</key></keyseq></p></td>

+ </tr>

+ <tr>

+ <td><p>Delete the bookmark in the current page if there is one.</p></td>

+ <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>D</key></keyseq></p></td>

+ </tr>

+ <tr>

+ <td><p>Display the side pane with a table of contents and bookmarks.</p></td>

+ <td><p><key>F9</key></p></td>

+ </tr>

+ <tr>

+ <td><p>Enable caret navigation placing a moveable cursor in text pages, allowing you to move around and select text with the keyboard.</p></td>

+ <td><p><key>F7</key></p></td>

+ </tr>

+ </table>

+</section>

+

+<section id="copy">

+ <title>Selecting and copying text</title>

+<table frame="all" rules="cols" shade="rows">

+ <tr>

+ <td><p>Copy highlighted text.</p></td>

+ <td><p><keyseq><key>Ctrl</key><key>C</key></keyseq> / <keyseq><key>Ctrl</key><key>Insert</key></keyseq></p></td>

+ </tr>

+ <tr>

+ <td><p>Select all the text in a document.</p></td>

+ <td><p><keyseq><key>Ctrl</key><key>A</key></keyseq></p></td>

+ </tr>

+</table>

+</section>

+

+<section id="find">

+ <title>Finding text</title>

+<table frame="all" rules="cols" shade="rows">

+ <tr>

+ <td><p>

+ Show the toolbar that lets you search for words in the document. The

+ search box is automatically highlighted when you press this, and the

+ search will start as soon as you type some text. If you select a text

+ in the document before searching, then the search will start using that

+ text as input.

+ </p></td>

+ <td><p><keyseq><key>Ctrl</key><key>F</key></keyseq> / <key>/</key></p></td>

+ </tr>

+ <tr>

+ <td><p>Go to the next search result.</p></td>

+ <td><p><keyseq><key>Ctrl</key><key>G</key></keyseq> / <key>F3</key></p></td>

+ </tr>

+ <tr>

+ <td><p>Go to the previous search result.</p></td>

+ <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>G</key></keyseq> / <keyseq><key>Shift</key><key>F3</key></keyseq></p></td>

+ </tr>

+</table>

+</section>

+

+<section id="rotate-zoom">

+ <title>Rotating and zooming</title>

+<table frame="all" rules="cols" shade="rows">

+ <tr>

+ <td><p>Rotate the pages 90 degrees counter-clockwise.</p></td>

+ <td><p><keyseq><key>Ctrl</key><key>Left arrow</key></keyseq></p></td>

+ </tr>

+ <tr>

+ <td><p>Rotate the pages 90 degrees clockwise.</p></td>

+ <td><p><keyseq><key>Ctrl</key><key>Right

+arrow</key></keyseq></p></td>

+ </tr>

+ <tr>

+ <td><p>Default zoom.</p></td>

+ <td><p><keyseq><key>Ctrl</key><key>0</key></keyseq></p></td>

+ </tr>

+ <tr>

+ <td><p>Zoom in.</p></td>

+ <td><p><keyseq><key>Ctrl</key><key>+</key></keyseq> / <key>=</key> /

+ <keyseq><key>Ctrl</key><key>=</key></keyseq></p></td>

+ </tr>

+ <tr>

+ <td><p>Zoom out.</p></td>

+ <td><p><keyseq><key>Ctrl</key><key>-</key></keyseq></p></td>

+ </tr>

+ <tr>

+ <td><p>Fit the page into the window.</p></td>

+ <td><p><key>F</key></p></td>

+ </tr>

+ <tr>

+ <td><p>Fit the content width to the space available.</p></td>

+ <td><p><key>W</key></p></td>

+ </tr>

+</table>

+</section>

+

+<section id="window">

+ <title>Window</title>

+<table frame="all" rules="cols" shade="rows">

+ <tr>

+ <td><p>Use the full screen to view the document.</p></td>

+ <td><p><key>F11</key></p></td>

+ </tr>

+ <tr>

+ <td><p>Start a presentation.</p></td>

+ <td><p><key>F5</key> / <keyseq><key>Shift</key><key>F5</key></keyseq></p></td>

+ </tr>

+</table>

+</section>

+

+<section id="document">

+ <title>Document view</title>

+<table frame="all" rules="cols" shade="rows">

+ <tr>

+ <td><p>Invert background and text colors.</p></td>

+ <td><p><keyseq><key>Ctrl</key><key>I</key></keyseq></p></td>

+ </tr>

+ <tr>

+ <td><p>Swap between continuous and page by page view of the document.</p></td>

+ <td><p><key>C</key></p></td>

+ </tr>

+ <tr>

+ <td><p>Display two pages side by side.</p></td>

+ <td><p><key>D</key></p></td>

+ </tr>

+</table>

+</section>

+

+<section id="presentation">

+ <title>Presentation mode</title>

+<table frame="all" rules="cols" shade="rows">

+ <tr>

+ <td><p>Toggle black screen.</p></td>

+ <td><p><key>B</key> / <key>.</key></p></td>

+ </tr>

+ <tr>

+ <td><p>Toggle white screen.</p></td>

+ <td><p><key>W</key></p></td>

+ </tr>

+</table>

+</section>

+

+</section>

+

+</page>

+ <page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="singlesided-npage">

+

+ <info>

+ <link type="guide" xref="print-booklet#singleSided"/>

+

+ <desc>Print a booklet with n pages.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+<title>n-page booklet</title>

+ <note style="important">

+ <p>

+ <em>n</em> is a multiple of 4.

+ </p>

+ </note>

+ <p>

+ If the number of pages in your PDF document is not a multiple of 4, you should add the appropriate number of blank pages (1, 2 or 3) to make it a multiple of 4.

+ To do so, you can:

+ </p>

+ <steps>

+ <item>

+ <p>

+ Create a blank PDF using <app>LibreOffice Writer</app>.

+ </p>

+ </item>

+ <item>

+ <p>

+ Merge the blank pages with your PDF document using <app>PDF-Shuffler</app> placing the blank pages at the end.

+ </p>

+ </item>

+</steps>

+

+ <p>

+ To print:

+ </p>

+ <steps>

+ <item>

+ <p>

+ Go to <guiseq><gui style="menuitem">File</gui><gui style="menuitem">Print</gui></guiseq> and press the <gui style="button">Print</gui> button.

+ </p>

+ </item>

+ <item>

+ <p>

+ Choose the <gui>General</gui> tab.

+ </p>

+ <p>

+ Under <em>Range</em>, choose <gui>Pages</gui>.

+ </p>

+ <tree>

+ <item>

+ Type the numbers of the pages in this order:

+ <item>n, 1, 2, n-1, n-2, 3, 4, n-3, n-4, 5, 6, n-5, n-6, 7, 8, n-7, n-8, 9, 10, n-9, n-10, 11, 12, n-11...</item>

+ <item>...until you have typed n-number of pages.</item>

+ </item>

+ </tree>

+ </item>

+ <item>

+ <p>

+ Choose the <gui>Page Setup</gui> tab.

+ </p>

+ <p>

+ Under <em>Layout</em>, in the <gui>Two-sided</gui> menu, select <gui>One Sided</gui>.

+ </p>

+ <p>

+ In the <gui>Pages per side</gui> menu, select <gui>2</gui>.

+ </p>

+ <p>

+ In the <gui>Page ordering</gui> menu, select <gui>Left to right</gui>.

+ </p>

+ <p>

+ In the <gui>Only print</gui> menu, select <gui>Odd sheets</gui>.

+ </p>

+ </item>

+ <item>

+ <p>

+ Click <gui>Print</gui>.

+ </p>

+ </item>

+ <item>

+ <p>

+ When all the pages have printed, flip the pages over and place them back in the printer.

+ </p>

+ </item>

+ <item>

+ <p>

+ Go to <guiseq><gui style="menuitem">File</gui><gui style="menuitem">Print</gui></guiseq> and press the <gui style="button">Print</gui> button.

+ </p>

+ </item>

+ <item>

+ <p>

+ Choose the <gui>Page Setup</gui> tab.

+ </p>

+ <p>

+ In the <gui>Only print</gui> menu, select <gui>Even sheets</gui>.

+ </p>

+ </item>

+ <item>

+ <p>

+ Click <gui>Print</gui>.

+ </p>

+ </item>

+ </steps>

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="synctex-beamer">

+

+ <info>

+ <link type="guide" xref="index#synctex" group="sixth"/>

+ <desc>Using SyncTeX with the LaTeX Beamer class.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+ </info>

+

+<title>Beamer with SyncTeX</title>

+<p>

+ Beamer is a LaTeX class for creating slides for presentations.

+</p>

+<p>

+ You can perform forward and backward search in a <em>Beamer-LaTeX</em> presentation in a similar fashion to <link xref="synctex-search">searching</link> through other TeX files compiled with SyncTeX. However the search brings you to the corresponding frame (slide), not necessarily the associated line of text. This difference is outlined in detail below.

+</p>

+<section id="forward-search">

+ <title>Forward search: from Beamer-LaTeX source to PDF (<app>pluma</app> to Atril)</title>

+ <p>

+ With <link xref="synctex-search#forward-search">forward search</link>, you can click on a specific line of Beamer-LaTeX source code. The <em>top</em> of the corresponding slide in the PDF will be outlined in red. This will often be the <em>frametitle</em>.

+ </p>

+</section>

+

+<section id="backward-search">

+

+ <title>Backward search: from PDF to Beamer-LaTeX source (from Atril to <app>pluma</app>)</title>

+ <p>

+ With <link xref="synctex-search#backward-search">backward search</link>, you click on some text in a frame, and the corresponding line of LaTex code that ends that particular frame is highlighted. This will usually be the line:

+ </p>

+ <code>\end{frame}</code>

+<p>corresponding to the frame you clicked on.</p>

+

+

+</section>

+

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="synctex-compile">

+

+ <info>

+ <link type="guide" xref="index#synctex" group="third"/>

+ <desc>How to compile your TeX document with SyncTeX</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+ </info>

+

+<title>Compile TeX with SyncTeX</title>

+<p>

+Adding the line <em>\synctex=1</em> in the preamble of your TeX file will trigger synchronization with SyncTeX.

+</p>

+<code>

+\documentclass{article}

+\synctex=1

+\usepackage{fullpage}

+\begin{document}

+...

+\end{document}

+</code>

+<p>

+ Alternatively, you can run the pdflatex command with the <em>-synctex=1</em> option:

+</p>

+<screen>pdflatex -synctex=1 yourFile.tex</screen>

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="synctex-editors">

+

+ <info>

+ <link type="guide" xref="index#synctex" group="fourth"/>

+ <desc>Which editor can you use to edit your TEX file?</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+<title>Supported editors</title>

+

+<section id="pluma"><title><app>pluma</app></title>

+<p>

+<link xref="synctex-search#forward-search">Forward Search</link> (from <app>pluma</app> to Atril) and <link xref="synctex-search#backward-search">Backward search</link> (from Atril to <app>pluma</app>) are both supported.

+</p>

+</section>

+

+<section id="vim-latex"><title>Vim-latex</title>

+<p>

+The <app>pluma</app> plugin contains a python script (<file>atril_dbus.py</file>) that can be used to get SyncTeX working with Vim.

+In order to use vim-latex together with Atril you need to follow the next steps:

+</p>

+<steps>

+ <item>

+ <p>

+ Copy the <file>atril_dbus.py</file> to some directory in your path and give it +x permissions.

+

+ </p>

+ </item>

+ <item>

+ <p>

+ Modify your <file>~/.vimrc</file> file and add the following lines.

+ </p>

+<code>

+let g:Tex_ViewRule_pdf = 'atril_dbus.py'

+let g:Tex_DefaultTargetFormat = 'pdf'

+let g:Tex_CompileRule_pdf = 'pdflatex --synctex=1 -interaction=nonstopmode $*'

+</code>

+

+ </item>

+ <item>

+ <p>

+ Now you can use Forward search from vim-latex by typing \ls. Backward search is not yet supported.

+ </p>

+ </item>

+</steps>

+</section>

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="synctex-search">

+

+ <info>

+ <link type="guide" xref="index#synctex" group="fifth"/>

+ <desc>Flip between Atril and <app>pluma</app>.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+<title>Search with SyncTeX</title>

+<p>

+ After you <link xref="synctex-compile">compile your TeX file with SyncTeX</link>, you will be able to search. SyncTeX even supports forward and backward search from an included file.

+</p>

+

+<section id="forward-search">

+ <title>Forward search: from TeX to PDF (from <app>pluma</app> to Atril)</title>

+ <p>

+ Forward search allows you to click on a specific section of TeX source code, and jump to the associated position in the PDF. To perform forward search:

+ </p>

+<steps>

+<item>

+<p>

+ Click on a line in the TeX file.

+</p>

+</item>

+<item>

+<p>

+ In <app>pluma</app>, click <guiseq><gui>Tools</gui> <gui>Forward Search</gui></guiseq>. The corresponding line in the PDF will be outlined in red.

+</p>

+<p>

+Alternatively, you can press <keyseq><key>Ctrl</key><key>Alt</key><key>F</key></keyseq>, or <keyseq><key>Ctrl</key>left click</keyseq>. The corresponding line in the PDF will be outlined in red.

+</p>

+</item>

+</steps>

+<note>

+<p>

+ If the corresponding PDF file is not open, performing a forward search will open the PDF in Atril.

+</p>

+</note>

+<p>

+ If you have a complex project with several TeX files you can put

+</p>

+<code>% mainfile: mainfile.tex</code>

+<p>

+either in the first or last three lines of each included TeX file, and forward search will work. Backward search should always work, even if you don't add the modeline.

+</p>

+

+</section>

+

+<section id="backward-search">

+ <title>Backward search: from PDF to TeX (from Atril to <app>pluma</app>)</title>

+ <p>

+ Backward search allows you to click on a specific line in the PDF file, and jump to the associated line in the TeX source code.

+</p>

+<p>

+You can perform a backward search by pressing <keyseq><key>Ctrl</key>left click</keyseq> in Atril. The corresponding line in the TeX source code will be highlighted.

+ </p>

+</section>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="synctex-support">

+

+ <info>

+ <link type="guide" xref="index#synctex" group="second"/>

+ <desc>How to add support for SyncTeX.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ </credit>

+ <credit type="editor">

+ <name>Germán Poo-Caamaño</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+<title>Set-up SyncTeX</title>

+<p>

+The following packages need to be installed in order to add support for SyncTeX:

+</p>

+<list>

+ <item>

+ <p>

+ A LaTeX engine with SyncTeX support, such as <app>pdflatex</app>.

+ </p>

+ </item>

+ <item>

+ <p>

+ A text editor with SyncTeX support, such as <app>pluma</app> with pluma-plugins installed.

+ </p>

+ </item>

+</list>

+

+<p>

+ In <app>pluma</app>, enable the SyncTeX Plugin:

+</p>

+<steps>

+ <item>

+ <p>

+ Click <guiseq><gui>Edit</gui><gui>Preferences</gui><gui>Plugins</gui></guiseq> tab.

+ </p>

+ </item>

+ <item>

+ <p>

+ Check <gui>SyncTeX</gui>.

+ </p>

+ </item>

+</steps>

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="synctex">

+

+ <info>

+ <link type="guide" xref="index#synctex" group="first"/>

+ <desc>SyncTeX support is available.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+ </info>

+

+<title>What is SyncTeX?</title>

+<p>

+ SyncTeX is a method that enables synchronization between a TeX source file and the resulting PDF output.

+</p>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="textselection">

+

+ <info>

+ <link type="guide" xref="index#faq"/>

+ <desc>When you copy text, the text that is pasted might be different from what you had selected.</desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author">

+ <name>Phil Bull</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+

+ </info>

+

+<title>Why didn't the text I selected copy properly?</title>

+

+

+<p>

+If you highlight and copy text from a document using Atril and then paste it into another

+application, the formatting may alter. It may also contain different characters than the original selection. This often happens when copying text from a PDF document with multiple columns.

+</p>

+

+

+ <p>

+ This problem happens because of how some document formats handle text.

+ The actual text in the document is stored differently from the way it is

+ displayed. This may result in a copy that does not appear as expected.

+ </p>

+

+ <p>

+ Unfortunately, there is no real way of fixing this problem. Copying

+ less text at a time, or copying the text into a text editor (like <app>pluma</app>) may minimize the problem.

+ </p>

+

+</page>

+<page xmlns="http://projectmallard.org/1.0/"

+ type="topic" style="task"

+ id="translate">

+

+ <info>

+ <link type="guide" xref="index#getInvolved"/>

+ <desc>Localize <app>Atril.</app></desc>

+ <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>

+ <credit type="author copyright">

+ <name>Tiffany Antopolski</name>

+ <email>[email protected]</email>

+ <years>2011</years>

+ </credit>

+ <credit type="editor">

+ <name>Michael Hill</name>

+ <email>[email protected]</email>

+ </credit>

+ <license>

+ <p>Creative Commons Share Alike 3.0</p>

+ </license>

+ </info>

+

+<title>Help translate</title>

+<p>

+Atrils user interface and documentation is being translated by a world-wide volunteer community. You are welcome to participate.

+</p>

+<p>

+ There are many languages for which translations are still needed.

+</p>

+<p>

+To start translating you will need to <link href="https://www.transifex.com/signin/">create an account</link> and join the <link href="https://www.transifex.com/mate/MATE/">translation team</link> for your language. This will give you the ability to upload new translations.

+</p>

+

+</page>

+

+HELP_MEDIA = figures/atril.png \

+ figures/atril-trail.png

+

+HELP_FILES = \

+ annotation-properties.page \

+ annotations-delete.page \

+ annotations-disabled.page \

+ annotations-navigate.page \

+ annotations.page \

+ annotations-save.page \

+ bookmarks.page \

+ bug-filing.page \

+ commandline.page \

+ convertpdf.page \

+ convertPostScript.page \

+ convertSVG.page \

+ default-settings.page \

+ develop.page \

+ documentation.page \

+ duplex-npages.page \

+ editing.page \

+ finding.page \

+ formats.page \

+ forms.page \

+ forms-saving.page \

+ index.page \

+ introduction.page \

+ invert-colors.page \

+ license.page \

+ legal.xml \

+ legal-unported.xml \

+ movingaround.page \

+ noprint.page \

+ openerror.page \

+ opening.page \

+ password.page \

+ presentations.page \

+ print-2sided.page \

+ print-booklet.page \

+ print-differentsize.page \

+ printing.page \

+ print-pagescaling.page \

+ reload.page \

+ shortcuts.page \

+ singlesided-npages.page \

+ synctex-beamer.page \

+ synctex-compile.page \

+ synctex-editors.page \

+ synctex.page \

+ synctex-search.page \

+ synctex-support.page \

+ textselection.page \

+ translate.page

+DISTCLEANFILES = \

+ Makefile.in

+