summaryrefslogtreecommitdiff
path: root/help
diff options
context:
space:
mode:
authormbkma <[email protected]>2021-03-12 11:24:53 +0100
committerraveit65 <[email protected]>2021-03-29 20:45:35 +0200
commite82bd2c2b4d0a1556234e33bdfeafc43ff21d9ec (patch)
tree09d117459074c1f7fa8a9f2e0415d2f01a225e21 /help
parent2651eeb6938177551676efc0a9ffde1e2c9ab9fc (diff)
downloadatril-e82bd2c2b4d0a1556234e33bdfeafc43ff21d9ec.tar.bz2
atril-e82bd2c2b4d0a1556234e33bdfeafc43ff21d9ec.tar.xz
update help
Diffstat (limited to 'help')
-rw-r--r--help/C/annotation-properties.page51
-rw-r--r--help/C/annotations-delete.page40
-rw-r--r--help/C/annotations-disabled.page21
-rw-r--r--help/C/annotations-navigate.page23
-rw-r--r--help/C/annotations-save.page45
-rw-r--r--help/C/annotations.page76
-rw-r--r--help/C/bookmarks.page89
-rw-r--r--help/C/bug-filing.page37
-rw-r--r--help/C/commandline.page61
-rw-r--r--help/C/convertPostScript.page59
-rw-r--r--help/C/convertSVG.page55
-rw-r--r--help/C/convertpdf.page68
-rw-r--r--help/C/default-settings.page33
-rw-r--r--help/C/develop.page27
-rw-r--r--help/C/documentation.page30
-rw-r--r--help/C/duplex-npages.page86
-rw-r--r--help/C/editing.page34
-rw-r--r--help/C/figures/atril-trail.pngbin0 -> 907 bytes
-rw-r--r--help/C/figures/atril.pngbin0 -> 3267 bytes
-rw-r--r--help/C/figures/atril_start_window.pngbin23384 -> 0 bytes
-rw-r--r--help/C/finding.page64
-rw-r--r--help/C/formats.page50
-rw-r--r--help/C/forms-saving.page86
-rw-r--r--help/C/forms.page34
-rw-r--r--help/C/index.docbook794
-rw-r--r--help/C/index.page72
-rw-r--r--help/C/introduction.page24
-rw-r--r--help/C/invert-colors.page36
-rw-r--r--help/C/legal-unported.xml8
-rw-r--r--help/C/legal.xml85
-rw-r--r--help/C/license.page59
-rw-r--r--help/C/movingaround.page184
-rw-r--r--help/C/noprint.page76
-rw-r--r--help/C/openerror.page25
-rw-r--r--help/C/opening.page73
-rw-r--r--help/C/password.page52
-rw-r--r--help/C/presentations.page82
-rw-r--r--help/C/print-2sided.page44
-rw-r--r--help/C/print-booklet.page36
-rw-r--r--help/C/print-differentsize.page65
-rw-r--r--help/C/print-pagescaling.page57
-rw-r--r--help/C/printing.page56
-rw-r--r--help/C/reload.page32
-rw-r--r--help/C/shortcuts.page265
-rw-r--r--help/C/singlesided-npages.page113
-rw-r--r--help/C/synctex-beamer.page45
-rw-r--r--help/C/synctex-compile.page34
-rw-r--r--help/C/synctex-editors.page57
-rw-r--r--help/C/synctex-search.page69
-rw-r--r--help/C/synctex-support.page55
-rw-r--r--help/C/synctex.page23
-rw-r--r--help/C/textselection.page39
-rw-r--r--help/C/translate.page34
-rw-r--r--help/Makefile.am59
54 files changed, 2850 insertions, 872 deletions
diff --git a/help/C/annotation-properties.page b/help/C/annotation-properties.page
new file mode 100644
index 00000000..49c9c876
--- /dev/null
+++ b/help/C/annotation-properties.page
@@ -0,0 +1,51 @@
+<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>
diff --git a/help/C/annotations-delete.page b/help/C/annotations-delete.page
new file mode 100644
index 00000000..7f0d35a9
--- /dev/null
+++ b/help/C/annotations-delete.page
@@ -0,0 +1,40 @@
+<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>
diff --git a/help/C/annotations-disabled.page b/help/C/annotations-disabled.page
new file mode 100644
index 00000000..6b4390d5
--- /dev/null
+++ b/help/C/annotations-disabled.page
@@ -0,0 +1,21 @@
+<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>
diff --git a/help/C/annotations-navigate.page b/help/C/annotations-navigate.page
new file mode 100644
index 00000000..cf52f319
--- /dev/null
+++ b/help/C/annotations-navigate.page
@@ -0,0 +1,23 @@
+<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>
diff --git a/help/C/annotations-save.page b/help/C/annotations-save.page
new file mode 100644
index 00000000..28816f68
--- /dev/null
+++ b/help/C/annotations-save.page
@@ -0,0 +1,45 @@
+<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>
diff --git a/help/C/annotations.page b/help/C/annotations.page
new file mode 100644
index 00000000..ac9915da
--- /dev/null
+++ b/help/C/annotations.page
@@ -0,0 +1,76 @@
+<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>
diff --git a/help/C/bookmarks.page b/help/C/bookmarks.page
new file mode 100644
index 00000000..9196f99d
--- /dev/null
+++ b/help/C/bookmarks.page
@@ -0,0 +1,89 @@
+<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>
diff --git a/help/C/bug-filing.page b/help/C/bug-filing.page
new file mode 100644
index 00000000..e3639d5e
--- /dev/null
+++ b/help/C/bug-filing.page
@@ -0,0 +1,37 @@
+<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>
diff --git a/help/C/commandline.page b/help/C/commandline.page
new file mode 100644
index 00000000..8a40aed6
--- /dev/null
+++ b/help/C/commandline.page
@@ -0,0 +1,61 @@
+<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>
diff --git a/help/C/convertPostScript.page b/help/C/convertPostScript.page
new file mode 100644
index 00000000..cf49fbd4
--- /dev/null
+++ b/help/C/convertPostScript.page
@@ -0,0 +1,59 @@
+<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>
diff --git a/help/C/convertSVG.page b/help/C/convertSVG.page
new file mode 100644
index 00000000..78134bc5
--- /dev/null
+++ b/help/C/convertSVG.page
@@ -0,0 +1,55 @@
+<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>
diff --git a/help/C/convertpdf.page b/help/C/convertpdf.page
new file mode 100644
index 00000000..1bb11ac4
--- /dev/null
+++ b/help/C/convertpdf.page
@@ -0,0 +1,68 @@
+<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>
diff --git a/help/C/default-settings.page b/help/C/default-settings.page
new file mode 100644
index 00000000..debc0781
--- /dev/null
+++ b/help/C/default-settings.page
@@ -0,0 +1,33 @@
+<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>
diff --git a/help/C/develop.page b/help/C/develop.page
new file mode 100644
index 00000000..cc7ceb12
--- /dev/null
+++ b/help/C/develop.page
@@ -0,0 +1,27 @@
+<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>
diff --git a/help/C/documentation.page b/help/C/documentation.page
new file mode 100644
index 00000000..7e9f359f
--- /dev/null
+++ b/help/C/documentation.page
@@ -0,0 +1,30 @@
+<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>
diff --git a/help/C/duplex-npages.page b/help/C/duplex-npages.page
new file mode 100644
index 00000000..ad821358
--- /dev/null
+++ b/help/C/duplex-npages.page
@@ -0,0 +1,86 @@
+<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>
diff --git a/help/C/editing.page b/help/C/editing.page
new file mode 100644
index 00000000..ccd9cac2
--- /dev/null
+++ b/help/C/editing.page
@@ -0,0 +1,34 @@
+<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>
diff --git a/help/C/figures/atril-trail.png b/help/C/figures/atril-trail.png
new file mode 100644
index 00000000..1a417c9d
--- /dev/null
+++ b/help/C/figures/atril-trail.png
Binary files differ
diff --git a/help/C/figures/atril.png b/help/C/figures/atril.png
new file mode 100644
index 00000000..c9ff5e24
--- /dev/null
+++ b/help/C/figures/atril.png
Binary files differ
diff --git a/help/C/figures/atril_start_window.png b/help/C/figures/atril_start_window.png
deleted file mode 100644
index 3d4d9bef..00000000
--- a/help/C/figures/atril_start_window.png
+++ /dev/null
Binary files differ
diff --git a/help/C/finding.page b/help/C/finding.page
new file mode 100644
index 00000000..fbdf04a7
--- /dev/null
+++ b/help/C/finding.page
@@ -0,0 +1,64 @@
+<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>
diff --git a/help/C/formats.page b/help/C/formats.page
new file mode 100644
index 00000000..0be948b1
--- /dev/null
+++ b/help/C/formats.page
@@ -0,0 +1,50 @@
+<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>
diff --git a/help/C/forms-saving.page b/help/C/forms-saving.page
new file mode 100644
index 00000000..e40d0ba9
--- /dev/null
+++ b/help/C/forms-saving.page
@@ -0,0 +1,86 @@
+<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>
diff --git a/help/C/forms.page b/help/C/forms.page
new file mode 100644
index 00000000..fc99da4b
--- /dev/null
+++ b/help/C/forms.page
@@ -0,0 +1,34 @@
+<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>
diff --git a/help/C/index.docbook b/help/C/index.docbook
deleted file mode 100644
index 7ff2e6dc..00000000
--- a/help/C/index.docbook
+++ /dev/null
@@ -1,794 +0,0 @@
-<?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>[email protected]</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>[email protected]</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>
diff --git a/help/C/index.page b/help/C/index.page
new file mode 100644
index 00000000..642144b8
--- /dev/null
+++ b/help/C/index.page
@@ -0,0 +1,72 @@
+<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>
diff --git a/help/C/introduction.page b/help/C/introduction.page
new file mode 100644
index 00000000..70191552
--- /dev/null
+++ b/help/C/introduction.page
@@ -0,0 +1,24 @@
+<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>
diff --git a/help/C/invert-colors.page b/help/C/invert-colors.page
new file mode 100644
index 00000000..f1608d4c
--- /dev/null
+++ b/help/C/invert-colors.page
@@ -0,0 +1,36 @@
+<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>
diff --git a/help/C/legal-unported.xml b/help/C/legal-unported.xml
new file mode 100644
index 00000000..aa36246c
--- /dev/null
+++ b/help/C/legal-unported.xml
@@ -0,0 +1,8 @@
+<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>
diff --git a/help/C/legal.xml b/help/C/legal.xml
index 9c4e2480..0e598834 100644
--- a/help/C/legal.xml
+++ b/help/C/legal.xml
@@ -1,76 +1,9 @@
- <legalnotice id="legalnotice">
- <para>
- Permission is granted to copy, distribute and/or modify this
- document under the terms of the GNU Free Documentation
- License (GFDL), Version 1.1 or any later version published
- by the Free Software Foundation with no Invariant Sections,
- no Front-Cover Texts, and no Back-Cover Texts. You can find
- a copy of the GFDL at this <ulink type="help"
- url="help:fdl">link</ulink> or in the file COPYING-DOCS
- distributed with this manual.
- </para>
- <para> This manual is part of a collection of MATE manuals
- distributed under the GFDL. If you want to distribute this
- manual separately from the collection, you can do so by
- adding a copy of the license to the manual, as described in
- section 6 of the license.
- </para>
-
- <para>
- Many of the names used by companies to distinguish their
- products and services are claimed as trademarks. Where those
- names appear in any MATE documentation, and the members of
- the MATE Documentation Project are made aware of those
- trademarks, then the names are in capital letters or initial
- capital letters.
- </para>
-
- <para>
- DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
- UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
- WITH THE FURTHER UNDERSTANDING THAT:
-
- <orderedlist>
- <listitem>
- <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
- WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
- IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
- THAT THE DOCUMENT OR MODIFIED VERSION OF THE
- DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
- A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
- RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
- OF THE DOCUMENT OR MODIFIED VERSION OF THE
- DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
- MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
- YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
- CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
- SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
- OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
- LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
- VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
- EXCEPT UNDER THIS DISCLAIMER; AND
- </para>
- </listitem>
- <listitem>
- <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
- THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
- CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
- INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
- DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
- OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
- PARTIES, BE LIABLE TO ANY PERSON FOR ANY
- DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
- CONSEQUENTIAL DAMAGES OF ANY CHARACTER
- INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
- OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
- MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
- LOSSES ARISING OUT OF OR RELATING TO USE OF THE
- DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
- EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
- THE POSSIBILITY OF SUCH DAMAGES.
- </para>
- </listitem>
- </orderedlist>
- </para>
- </legalnotice>
-
+<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>
diff --git a/help/C/license.page b/help/C/license.page
new file mode 100644
index 00000000..8925e00b
--- /dev/null
+++ b/help/C/license.page
@@ -0,0 +1,59 @@
+<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>
diff --git a/help/C/movingaround.page b/help/C/movingaround.page
new file mode 100644
index 00000000..5bb44044
--- /dev/null
+++ b/help/C/movingaround.page
@@ -0,0 +1,184 @@
+<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>
diff --git a/help/C/noprint.page b/help/C/noprint.page
new file mode 100644
index 00000000..f4f56d93
--- /dev/null
+++ b/help/C/noprint.page
@@ -0,0 +1,76 @@
+<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>
diff --git a/help/C/openerror.page b/help/C/openerror.page
new file mode 100644
index 00000000..9c5023a8
--- /dev/null
+++ b/help/C/openerror.page
@@ -0,0 +1,25 @@
+<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>
diff --git a/help/C/opening.page b/help/C/opening.page
new file mode 100644
index 00000000..6cbc5c57
--- /dev/null
+++ b/help/C/opening.page
@@ -0,0 +1,73 @@
+<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>
diff --git a/help/C/password.page b/help/C/password.page
new file mode 100644
index 00000000..dd4d6615
--- /dev/null
+++ b/help/C/password.page
@@ -0,0 +1,52 @@
+<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>
diff --git a/help/C/presentations.page b/help/C/presentations.page
new file mode 100644
index 00000000..31918f4c
--- /dev/null
+++ b/help/C/presentations.page
@@ -0,0 +1,82 @@
+<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>
diff --git a/help/C/print-2sided.page b/help/C/print-2sided.page
new file mode 100644
index 00000000..4f95e4e6
--- /dev/null
+++ b/help/C/print-2sided.page
@@ -0,0 +1,44 @@
+<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>
diff --git a/help/C/print-booklet.page b/help/C/print-booklet.page
new file mode 100644
index 00000000..403466ca
--- /dev/null
+++ b/help/C/print-booklet.page
@@ -0,0 +1,36 @@
+<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>
diff --git a/help/C/print-differentsize.page b/help/C/print-differentsize.page
new file mode 100644
index 00000000..2b467516
--- /dev/null
+++ b/help/C/print-differentsize.page
@@ -0,0 +1,65 @@
+<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>
diff --git a/help/C/print-pagescaling.page b/help/C/print-pagescaling.page
new file mode 100644
index 00000000..f887a620
--- /dev/null
+++ b/help/C/print-pagescaling.page
@@ -0,0 +1,57 @@
+<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>
diff --git a/help/C/printing.page b/help/C/printing.page
new file mode 100644
index 00000000..f6cef7fa
--- /dev/null
+++ b/help/C/printing.page
@@ -0,0 +1,56 @@
+<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>
diff --git a/help/C/reload.page b/help/C/reload.page
new file mode 100644
index 00000000..7d576e0d
--- /dev/null
+++ b/help/C/reload.page
@@ -0,0 +1,32 @@
+<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>
diff --git a/help/C/shortcuts.page b/help/C/shortcuts.page
new file mode 100644
index 00000000..ad4aba01
--- /dev/null
+++ b/help/C/shortcuts.page
@@ -0,0 +1,265 @@
+<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>
diff --git a/help/C/singlesided-npages.page b/help/C/singlesided-npages.page
new file mode 100644
index 00000000..ac3a4d52
--- /dev/null
+++ b/help/C/singlesided-npages.page
@@ -0,0 +1,113 @@
+ <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>
diff --git a/help/C/synctex-beamer.page b/help/C/synctex-beamer.page
new file mode 100644
index 00000000..26dc4c57
--- /dev/null
+++ b/help/C/synctex-beamer.page
@@ -0,0 +1,45 @@
+<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>
diff --git a/help/C/synctex-compile.page b/help/C/synctex-compile.page
new file mode 100644
index 00000000..ed431c29
--- /dev/null
+++ b/help/C/synctex-compile.page
@@ -0,0 +1,34 @@
+<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>
diff --git a/help/C/synctex-editors.page b/help/C/synctex-editors.page
new file mode 100644
index 00000000..eae0f990
--- /dev/null
+++ b/help/C/synctex-editors.page
@@ -0,0 +1,57 @@
+<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>
diff --git a/help/C/synctex-search.page b/help/C/synctex-search.page
new file mode 100644
index 00000000..22cba7d6
--- /dev/null
+++ b/help/C/synctex-search.page
@@ -0,0 +1,69 @@
+<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>
diff --git a/help/C/synctex-support.page b/help/C/synctex-support.page
new file mode 100644
index 00000000..70f1ce1d
--- /dev/null
+++ b/help/C/synctex-support.page
@@ -0,0 +1,55 @@
+<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>
diff --git a/help/C/synctex.page b/help/C/synctex.page
new file mode 100644
index 00000000..0a9deca4
--- /dev/null
+++ b/help/C/synctex.page
@@ -0,0 +1,23 @@
+<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>
diff --git a/help/C/textselection.page b/help/C/textselection.page
new file mode 100644
index 00000000..1b310fe4
--- /dev/null
+++ b/help/C/textselection.page
@@ -0,0 +1,39 @@
+<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>
diff --git a/help/C/translate.page b/help/C/translate.page
new file mode 100644
index 00000000..4d679ba8
--- /dev/null
+++ b/help/C/translate.page
@@ -0,0 +1,34 @@
+<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>
diff --git a/help/Makefile.am b/help/Makefile.am
index 7e0f9fc3..bb4a6290 100644
--- a/help/Makefile.am
+++ b/help/Makefile.am
@@ -3,8 +3,60 @@ SUBDIRS = reference
@YELP_HELP_RULES@
HELP_ID = atril
-HELP_FILES = index.docbook legal.xml
-HELP_MEDIA = figures/atril_start_window.png
+
+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
# Add linguas to be ignored, e.g. IGNORE_HELP_LINGUAS = ca de es fr
if USE_NLS
@@ -16,4 +68,7 @@ else
HELP_LINGUAS =
endif
+DISTCLEANFILES = \
+ Makefile.in
+
-include $(top_srcdir)/git.mk