From e82bd2c2b4d0a1556234e33bdfeafc43ff21d9ec Mon Sep 17 00:00:00 2001 From: mbkma Date: Fri, 12 Mar 2021 11:24:53 +0100 Subject: update help --- help/C/annotation-properties.page | 51 +++ help/C/annotations-delete.page | 40 ++ help/C/annotations-disabled.page | 21 + help/C/annotations-navigate.page | 23 + help/C/annotations-save.page | 45 ++ help/C/annotations.page | 76 ++++ help/C/bookmarks.page | 89 ++++ help/C/bug-filing.page | 37 ++ help/C/commandline.page | 61 +++ help/C/convertPostScript.page | 59 +++ help/C/convertSVG.page | 55 +++ help/C/convertpdf.page | 68 +++ help/C/default-settings.page | 33 ++ help/C/develop.page | 27 ++ help/C/documentation.page | 30 ++ help/C/duplex-npages.page | 86 ++++ help/C/editing.page | 34 ++ help/C/figures/atril-trail.png | Bin 0 -> 907 bytes help/C/figures/atril.png | Bin 0 -> 3267 bytes help/C/figures/atril_start_window.png | Bin 23384 -> 0 bytes help/C/finding.page | 64 +++ help/C/formats.page | 50 +++ help/C/forms-saving.page | 86 ++++ help/C/forms.page | 34 ++ help/C/index.docbook | 794 ---------------------------------- help/C/index.page | 72 +++ help/C/introduction.page | 24 + help/C/invert-colors.page | 36 ++ help/C/legal-unported.xml | 8 + help/C/legal.xml | 85 +--- help/C/license.page | 59 +++ help/C/movingaround.page | 184 ++++++++ help/C/noprint.page | 76 ++++ help/C/openerror.page | 25 ++ help/C/opening.page | 73 ++++ help/C/password.page | 52 +++ help/C/presentations.page | 82 ++++ help/C/print-2sided.page | 44 ++ help/C/print-booklet.page | 36 ++ help/C/print-differentsize.page | 65 +++ help/C/print-pagescaling.page | 57 +++ help/C/printing.page | 56 +++ help/C/reload.page | 32 ++ help/C/shortcuts.page | 265 ++++++++++++ help/C/singlesided-npages.page | 113 +++++ help/C/synctex-beamer.page | 45 ++ help/C/synctex-compile.page | 34 ++ help/C/synctex-editors.page | 57 +++ help/C/synctex-search.page | 69 +++ help/C/synctex-support.page | 55 +++ help/C/synctex.page | 23 + help/C/textselection.page | 39 ++ help/C/translate.page | 34 ++ help/Makefile.am | 59 ++- 54 files changed, 2850 insertions(+), 872 deletions(-) create mode 100644 help/C/annotation-properties.page create mode 100644 help/C/annotations-delete.page create mode 100644 help/C/annotations-disabled.page create mode 100644 help/C/annotations-navigate.page create mode 100644 help/C/annotations-save.page create mode 100644 help/C/annotations.page create mode 100644 help/C/bookmarks.page create mode 100644 help/C/bug-filing.page create mode 100644 help/C/commandline.page create mode 100644 help/C/convertPostScript.page create mode 100644 help/C/convertSVG.page create mode 100644 help/C/convertpdf.page create mode 100644 help/C/default-settings.page create mode 100644 help/C/develop.page create mode 100644 help/C/documentation.page create mode 100644 help/C/duplex-npages.page create mode 100644 help/C/editing.page create mode 100644 help/C/figures/atril-trail.png create mode 100644 help/C/figures/atril.png delete mode 100644 help/C/figures/atril_start_window.png create mode 100644 help/C/finding.page create mode 100644 help/C/formats.page create mode 100644 help/C/forms-saving.page create mode 100644 help/C/forms.page delete mode 100644 help/C/index.docbook create mode 100644 help/C/index.page create mode 100644 help/C/introduction.page create mode 100644 help/C/invert-colors.page create mode 100644 help/C/legal-unported.xml create mode 100644 help/C/license.page create mode 100644 help/C/movingaround.page create mode 100644 help/C/noprint.page create mode 100644 help/C/openerror.page create mode 100644 help/C/opening.page create mode 100644 help/C/password.page create mode 100644 help/C/presentations.page create mode 100644 help/C/print-2sided.page create mode 100644 help/C/print-booklet.page create mode 100644 help/C/print-differentsize.page create mode 100644 help/C/print-pagescaling.page create mode 100644 help/C/printing.page create mode 100644 help/C/reload.page create mode 100644 help/C/shortcuts.page create mode 100644 help/C/singlesided-npages.page create mode 100644 help/C/synctex-beamer.page create mode 100644 help/C/synctex-compile.page create mode 100644 help/C/synctex-editors.page create mode 100644 help/C/synctex-search.page create mode 100644 help/C/synctex-support.page create mode 100644 help/C/synctex.page create mode 100644 help/C/textselection.page create mode 100644 help/C/translate.page 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 @@ + + + + + How to customize the author, color, style or icon of an annotation. + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + + + Customize annotations + + + +

+ Right click on the annotation icon in the document. +

+ + +

+ Select Annotation Properties…. +

+ + +

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

+ +

+ 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. +

+ + + + + +
+ Can I permanently change the default annotation properties? +

+ 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 red instead of yellow, you will have to change the default from yellow to red individually on each note. There is no way to save different default settings for annotation properties, at this time. +

+
+ + 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 @@ + + + + + + + + David King + davidk@mate.org + + + + + Delete annotations from a PDF document. + + + Removing annotations + +

An annotation is a note or comment added to a PDF document. You can remove + annotations that you or other people have added.

+ + + +

View a page that has an annotation. If you are not sure which pages + have annotations, find them in the + annotation side pane.

+ + +

Right-click on the annotation icon in the document, and click + Remove Annotation.

+ + +

Save the changes to a new document by clicking File, followed by Save As….

+ + + + 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 @@ + + + + + Annotations can only be added to PDF files. + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + +Can't add annotations? +

+ 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). +

+ 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 @@ + + + + + How to navigate to annotations. + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + + + + Annotation navigation +

+ 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. +

+ 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 @@ + + + + How to save your annotations. + + + Tiffany Antopolski + tiffany@antopolski.com + + + Shobha Tyagi + tyagishobha@gmail.com + + +

Creative Commons Share Alike 3.0

+ + +Save a copy of an annotated PDF +

+ To save a copy of your annotated PDF for future viewing using + Atril or any other PDF viewer + that supports annotations: +

+ + +

+ Click FileSave As… +

+ + +

+ Choose a name and folder in which to save the file, then click + Save. The PDF will be saved in the folder you chose. +

+ + +

+ Annotations are added according to the PDF specification. Therefore, most PDF + readers should be able to read them. Adobe Reader is known to work. +

+ + 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 @@ + + + + + How to create and customize annotations. + + + Tiffany Antopolski + tiffany@antopolski.com + + + Andre Klapper + ak-47@gmx.net + + +

Creative Commons Share Alike 3.0

+ + + + +Adding annotations +

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

+

+ 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 + View + Sidepane + or press the F9 key on the keyboard. +

+ +

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

+

+ To create an annotation: +

+ + +

+ Select Annotations from the drop-down list: +

+ + +

+ Click on Add to add a text annotation. +

+ + +

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

+ + +

+ Type your text into the annotation window. +

+ +

+ 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. +

+ + + +

+ Close the note by clicking on the x in the top corner of the note. +

+ + + + + 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 @@ + + + + + + + Tiffany Antopolski + tiffany@antopolski.com + + + Ekaterina Gerasimova + kittykat3756@gmail.com + + + +

Creative Commons Share Alike 3.0

+ + + You can use annotations like bookmarks. + + +Bookmarks + +

You can add, rename and delete bookmarks using the Document + Viewer.

+ +

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 + View + Sidepane, or press the F9 key on the keyboard.

+ +

At the bottom of this side pane, select the Bookmarks + from the drop-down list.

+ + + +
+ Create a bookmark + + + +

In the PDF document itself, navigate to the page to which you would + like to add the bookmark.

+ + +

In the side pane, select Bookmarks + from the drop-down list.

+ + +

Press the + button at the bottom of the side + pane. The default name of the bookmark you just added is the page number + of the document.

+ + +

The bookmark is now listed in the bookmarks list.

+ + + +
+ +
+ Rename a bookmark + + +

In the side pane, select Bookmarks + from the drop-down list.

 +

Select the bookmark in the side pane.

 +

Click on the bookmark name.

 +

Enter the new name.

 +

Press Enter.

 + + +
+ +
+ Delete a bookmark + + +

In the side pane, select Bookmarks + from the drop-down list.

 +

Press the - button at the bottom of the side pane.

 + + +
+ + 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 @@ + + + + + How and where to report problems. + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + + +File a bug against Atril +

+ Atril is maintained by a volunteer community. You are welcome to participate. If you notice a problem you can file a bug report. To file a bug, go to . +

+

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

+

+ 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 Sign in / Register link to create one. +

+

+ Once you have an account, log in, and click on New issue. +

+

+ Fill in the Title and Description sections and click Submit Issue. +

+

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

+ 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 @@ + + + + + Command line + The atril command can open any number of files, at specific pages and in various modes. + + + Phil Bull + philbull@gmail.com + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + + +The command line +

+To startAtril from the command line, type atril. You +can open a specific file by typing the filename after the atril command: +

+ +atril file.pdf +

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

+atril file1.pdf file2.pdf +

+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: +

+
+ Opening a document at a specific page +

+ You can use--page-label switch to open a document at a + specific page. For example, to open a document to page 3, you would type: +

+ atril --page-label=3 file.pdf +

+ The page label should be in the same format as the page number displayed in + Atril header bar. +

+
+
+ Opening a document in fullscreen mode + atril --fullscreen file.pdf +
+
+ Opening a document in presentation mode + atril --presentation file.pdf +
+
+ Opening a document in preview mode + atril --preview file.pdf +
+ 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 @@ + + + + + You can convert a document to PostScript. + + + Phil Bull + philbull@gmail.com + + + Anna Philips + anna.cs.au@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + + +Converting a document to PostScript + +

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

+ +

DjVu (.djvu, .djv)

 +

Portable Document Format (.pdf)

 +

Tagged Image File Format (.tiff, .tif)

 + +

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

+ + +

Go to + File + Print + and + select Print or press + CtrlP and go to the + General tab.

+ + +

+ Select Print to File and choose PostScript as the + Output format. +

+ + +

+ Choose a name and folder in which to save the file, then click Print. + The PostScript file will be saved in the folder you chose. +

+ + + 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 @@ + + + + + You can convert a document to SVG by "printing" it to a file. + + + Phil Bull + philbull@gmail.com + + + Anna Philips + anna.cs.au@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + + +Converting a document to SVG +

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

+ +

Portable Document Format (.pdf)

 + +

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

+ + +

Go to + File + Print + and + select Print or press + CtrlP.

+ + +

+ Select Print to File and choose SVG as the + Output format. +

+ + +

+ Choose a name and folder in which to save the file, then click Print. + The SVG file will be saved in the folder you chose. +

+ + + 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 @@ + + + + + You can convert a document to PDF by "printing" it to a file. + + + Phil Bull + philbull@gmail.com + + + Anna Philips + anna.cs.au@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + + +Converting a document to PDF + +

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

+ +

Device Independent file format (.dvi)

 +

PostScript (.ps)

 + +

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

+ + +

Go to + File + Print + and + select Print or press + CtrlP on your keyboard.

+ + +

+ Select Print to File and choose PDF as the + Output format. +

+ + +

+ Choose a name and folder in which to save the file, then click Print. + The PDF will be saved in the folder you chose. +

+ + + +

+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 Optical Character Recognition +(OCR) software to extract the text from files if you need to. +

+ + + 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 @@ + + + + + Save current settings as default for new documents. + + + Sindhu S + sindhus@live.in + + +

Creative Commons Share Alike 3.0

+ + + + + Change default settings + +

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.

+

You can save the settings which you are currently using as default for all + new documents by pressing Edit + and selecting Save Current Settings as Default.

+ + +

The new default settings do not override settings of previously opened + documents, they are applied only to documents opened for the first time.

+ + + 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 @@ + + + + + Improve Atril. + + + Tiffany Antopolski + tiffany.antopolski@gmail.com + 2011 + + +

Creative Commons Share Alike 3.0

+ + + +Help develop +

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

+

+ If you would like to help develop Atril, create a Pull Request. +

+ + 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 @@ + + + + Contact the Documentation Team. + + + Tiffany Antopolski + tiffany.antopolski@gmail.com + 2011 + + +

Creative Commons Share Alike 3.0

+ + + +Help write documentation + +

+ Atrils documentation is maintained by a volunteer community. You are welcome to participate.

+ +

To contribute to the Documentation Project, feel free to get in touch with us and create a Pull Request. +

+

+Our website contains useful information. +

+ + + 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 @@ + + + + + + Print a booklet with n pages. + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + + + +n-page booklet + +

+ n is a multiple of 4. +

+ + +

+ 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: +

+ + +

+ Create a blank PDF using LibreOffice Writer. +

+ + +

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

+ + + + + + +

+ Go to FilePrint and press the Print button. +

+ + +

+ Choose the General tab. +

+

+ Under Range, choose Pages. +

+ + + Type the numbers of the pages in this order: + 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... + ...until you have typed n-number of pages. + + + + +

+ Choose the Page Setup tab. +

+

+ Under Layout, in the Two-sided menu, select Short Edge (Flip). +

+

+ In the Pages per side option, select 2. +

+

+ In the Page ordering menu, select Left to right. +

+ + +

+ Click Print. +

+ + + 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 @@ + + + + + You can't use Atril to edit files. + + + Phil Bull + philbull@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + + +Can I edit documents in the document viewer? + + +

+ 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. +

+ + + +

+ PDF and PostScript (.ps) files are not usually intended to be edited, but PDF editing software is available. Try + LibreOffice Draw or Okular, for example. + Furthermore, pdfarranger allows rearranging or removing pages and merging files. +

+ + diff --git a/help/C/figures/atril-trail.png b/help/C/figures/atril-trail.png new file mode 100644 index 00000000..1a417c9d Binary files /dev/null and b/help/C/figures/atril-trail.png differ diff --git a/help/C/figures/atril.png b/help/C/figures/atril.png new file mode 100644 index 00000000..c9ff5e24 Binary files /dev/null and b/help/C/figures/atril.png 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 Binary files a/help/C/figures/atril_start_window.png and /dev/null 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 @@ + + + + + + + Phil Bull + philbull@gmail.com + + + Anna Philips + anna.cs.au@gmail.com + + + Ekaterina Gerasimova + kittykat3756@gmail.com + + + + + Search for a word or phrase in a document. + + + Find text in a document + + + +

Click + Edit + Find or + CtrlF or + / to display a + search box.

+ + +

Start typing into the search box and the search will start + automatically.

+ + +

Use the Find Previous and Find Next buttons to move to the previous + or next search result.

+ + +

To hide the search bar, click anywhere in the window + again or press Esc.

+ + + + +

To filter words by case, you can press the Case Sensitive + button.

+ + +

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.

+ + +

Only PDF documents are searchable. Some PDF documents are not + searchable because their text is encoded in the document as an image.

+ + + 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 @@ + + + + + + + + PDF, PostScript and many others are. + + + Phil Bull + philbull@gmail.com + + + Ekaterina Gerasimova + kittykat3756@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + + +Supported formats + +

+Atril supports the following formats: +

+ +

Comic Book Archive (.cbr and .cbz)

 +

Device Independent file format (.dvi)

 +

DjVu (.djvu, .djv)

 +

Open XML Paper Specification (.oxps, .xps)

 +

Portable Document Format (.pdf)

 +

PostScript (.ps)

 + + +

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

+

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

+ + + + + 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 @@ + + + + + Make sure you save the + form, otherwise all of the information you entered will be + lost. + + + Tiffany Antopolski + tiffany@antopolski.com + + + Anna Philips + anna.cs.au@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + +Saving a form + +

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

+ + +

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

+ + +

Go to + File + Print + and + select Save As… or press + CtrlS on your keyboard.

+ + +

+ Choose a name and folder to save the file in, then click Save. + The PDF will be saved in the folder you chose. +

+ + + +

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

+ + +

Go to + File + Print + and select Print or press + CtrlP on your keyboard.

+ + + + +

+ Select Print to File and choose PDF as the + Output format. +

+ + +

+ Choose a name and folder to save the file in, then click Print. + The PDF will be saved in the folder you chose. +

+ + + + + + +

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

+ + + 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 @@ + + + + + Working with fillable forms. + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + + + +Forms +

+ 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 Enter. +

+ +

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

+ +

+There may be some parts of a form that you may need to fill out by hand after 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 Xournal. +

+ + + + 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 @@ - - - - - - Atril Document Viewer"> - -]> - - - - -
- - - - &appname; Manual - - - The Atril Document Viewer application enables you to view documents of various formats like Portable - Document Format (PDF) files and PostScript files - - - - 2021 - MATE Documentation Project - - - 2005 - Nickolay V. Shmyrev - - - 2004 - Sun Microsystems - - - - - - MATE Documentation Project - - - GNOME Documentation Project - - - &legal; - - - - - MATE Documentation Project - - MATE Desktop - - - Sun - GNOME Documentation Team - Sun Microsystems - - - Nickolay V. - Shmyrev - - GNOME Documentation Project -
nshmyrev@yandex.ru
- - - - - - - - - &appname; Manual V&manrevision; - July 2015 - - MATE Documentation Team - MATE Documentation Project - - - - &appname; Manual V1.1 - 2008-04-05 - - Niels Giesen - Claude Paroz - GNOME Documentation Project - - - - &appname; Manual V1.0 - 2005-04-06 - - Nickolay V. Shmyrev - GNOME Documentation Project - - - - - This manual describes version &appversion; of &appname; - - - Feedback - To report a bug or make a suggestion regarding the &appname; application or this manual, follow the directions in the MATE Feedback Page. - - - - - - - &appname; - - - atril - - - - - - - Introduction - 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. - - - - - - - Getting Started - - - To Start &appname; - &app; starts when you open a document such as a PDF or PostScript file. - Alternatively, you can start &app; from the command line, with the command: atril. - - - - - When You Start &appname; - When you start &app;, the following window is displayed. - - -
- &appname; Window - - - - - - Shows &appname; main window. Contains titlebar, menubar, toolbar and display area. Menubar contains File, Edit, View, Go and Help menus. - - - -
- - The &app; window contains the following elements: - - - - Menubar - - The menus on the menubar contain all of the commands that you need to work with documents in &app;. - - - - Toolbar - - The toolbar contains a subset of the commands that you can access from the menubar. - - - - Display area - - The display area displays the document. - - - - - - In &app;, you can perform the same action in several ways. For example, you can open a document in the following ways: - - - - - - - - UI Component - - Action - - - - - Window - - - - Drag a file into the &app; window from another application such as a file manager. - - - Double-click on the file name in the file manager - - - - - - Menubar - Choose FileOpen. - - - - Shortcut keys - Press CtrlO. - - - - - - - This manual documents functionality from the menubar. - - - - - - - Usage - - - - To Open A Document - To open a document, perform the following steps: - - - - Choose FileOpen . - - - - In the Open Document dialog, select the file you want to open. - - - - - Click Open. &app; displays the name of the document in the titlebar of the window. - - - - - To open another document, choose FileOpen again. &app; opens each file in a new window. - - - If you try to open a document with format that &app; does not recognize, the application displays an error message. - - - - - To Navigate Through a Document - You can navigate through a file as follows: - - - To view the next page, choose Go Next Page . - - - - To view the previous page, choose Go Previous Page . - - - - To view the first page in the document, choose Go First Page . - - - - To view the last page in the document, choose Go Last Page . - - - - To view a particular page, enter the page number or page label in the text box on the toolbar, then press Return. - - - - - - - To Scroll a Page - To display the page contents that are not currently displayed in the display area, use the following methods: - - - Use the arrow keys or space key on the keyboard. - - - Drag the display area by clicking with the middle mouse button somewhere in the document and then moving the mouse. For example, to scroll down the page, drag the display area upwards in the window. - - - Use the scrollbars on the window. - - - - - - - To Change the Page Size - - You can use the following methods to resize a page in the &app; display area: - - - - - To increase the page size, choose View Zoom In . - - - - - To decrease the page size, choose View Zoom Out . - - - - - To resize a page to have the same width as the &app; display area, choose View Fit page width . - - - - - To resize a page to fit within the &app; display area, choose View Best Fit . - - - - - To resize the &app; window to have the same width and height as the screen, choose View Full Screen . To resize the &app; window to the original size, click on the Exit Full Screen button. - - - - - - - To View Pages or Document Structure - To view bookmarks or pages, perform the following steps: - - - - - Choose View Sidebar or press F9. - - - - - Use the drop-down list in the side-pane header to select whether to display document structure or pages in the side pane. - - - - - Use the side-pane scrollbars to display the required item or page in the side pane. - - - - Click on an entry to navigate to that location in the document. Click on a page to navigate to that page in the document. - - - - - - To View the Properties of a Document - To view the properties of a document, choose - - File - Properties - . - - - The Properties dialog displays all information available - - - - - To Print a Document - - To print a Document, choose File Print . - - - - If you cannot choose the Print menu item, the author of the document has disabled the print option for this document. To enable the print option, you must enter the master password when you open the document. See for more information about password-protected files. - - - - The Print dialog has the following tabbed sections: - - - - - Job - - - - - Printer - - - - - Paper - - - - - - Job - - Print range - - Select one of the following options to determine how many pages to print: - - - All - Select this option to print all of the pages in the document. - - - Pages From - Select this option to print the selected range of pages in the document. Use the spin boxes to specify the first page and last page of the range. - - - - - - - - - - Printer - - Printer - - Use this drop-down list to select the printer to which you want to print the document. - - - The Create a PDF document option is not supported in this version of &app;. - - - - - Settings - - Use this drop-down list to select the printer settings. - - To configure the printer, click Configure. For example, you can enable or disable duplex printing, or schedule delayed printing, if this functionality is supported by the printer. - - - - Location - - - Use this drop-down list to select one of the following print destinations: - - - - CUPS - - - Print the document to a CUPS printer. - - - - If the selected printer is a CUPS printer, CUPS is the only entry in this drop-down list. - - - - - - lpr - - - Print the document to a printer. - - - - - File - - - Print the document to a PostScript file. - - - Click Save As to display a dialog where you specify the name and location of the PostScript file. - - - - - Custom - - - Use the specified command to print the document. - - - Type the name of the command in the text box. Include all command-line arguments. - - - - - - - State - - This functionality is not supported in this version of &app;. - - - - Type - - This functionality is not supported in this version of &app;. - - - - Comment - - This functionality is not supported in this version of &app;. - - - - - - - - Paper - - Paper size - - Use this drop-down list to select the size of the paper to which you want to print the document. - - - Width - - Use this spin box to specify the width of the paper. Use the adjacent drop-down list to change the measurement unit. - - - Height - - Use this spin box to specify the height of the paper. - - - Feed orientation - - Use this drop-down list to select the orientation of the paper in the printer. - - - Page orientation - - Use this drop-down list to select the page orientation. - - - Layout - - Use this drop-down list to select the page layout. A preview of each layout that you select is displayed in the Preview area. - - - Paper Tray - - Use this drop-down list to select the paper tray. - - - - - - - - - - To Copy a Document - To copy a file, perform the following steps: - - - - - Choose File Save a Copy . - - - - - Type the new filename in the Filename text box in the Save a Copy dialog. - - - If necessary, specify the location of the copied document. By default, copies are saved in your home directory. - - - - - Click Save. - - - - - - - - To Work With Password-Protected Documents - - An author can use the following password levels to protect a document: - - - - User password that allows others only to read the document. - - - - Master password that allows others to perform additional actions, such as print the document. - - - - - When you try to open a password-protected document, &app; displays a security dialog. Type either the user password or the master password in the Enter document password text box, then click Open Document. - - - - - - To Close a Document - To close a document, choose File Close . - - - If the window is the last &app; window open, the application exits. - - - - - - - - Shortcuts - Below is a list of all shortcuts present in &app;: - - - - - - - - Shortcut - - Action - - - - - CtrlO - Open an existing document - - - CtrlS - Save a copy of the current document - - - CtrlP - Print document - - - CtrlW - Close window - - - CtrlC - Copy selection - - - CtrlA - Select All - - - - CtrlF - / (slash) - - Find a word or phrase in the document - - - - CtrlG - F3 - - Find next - - - - Ctrl+ (plus sign) - + - = - - Zoom in - - - - Ctrl- (minus sign) - - - - Zoom out - - - CtrlR - Reload the document - - - - Page Up - Go to the previous page - - - Page Down - Go to the next page - - - - Space - ShiftBackspace - Return - - Scroll forward - - - - ShiftSpace - Backspace - ShiftReturn - - Scroll backward - - - - ShiftPage Up - Go a bunch of pages up - - - ShiftPage Down - Go a bunch of pages down - - - Home - Go to the first page - - - End - Go to the last page - - - CtrlL - Go to page by number or label - - - F1 - Help - - - F5 - Run document as presentation - - - F9 - Show or hide the side pane - - - F11 - Toggle fullscreen mode - - - - - - -
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 @@ + + + + <media type="image" its:translate="no" src="figures/atril-trail.png"/> + Atril + Atril + + + Phil Bull + philbull@gmail.com + + + Tiffany Antopolski + tiffany@antopolski.com + + + + + Atril is + made for viewing PDF documents. Learn how to get started with Atril and its features. + + + + + <media type="image" its:translate="no" src="figures/atril.png" /> + Atril Help + + +
+ Reading documents +
+ +
+ Presentations and other supported formats +
+ +
+ Printing +
+ +
+ Annotations and bookmarks +
+ +
+ Interactive forms +
+ +
+ Frequently asked questions +
+ +
+ Advanced +
+ +
+ Tips and tricks +
+ +
+ SyncTeX + +
+ +
+ Get involved +
+ 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 @@ + + + + + + + Tiffany Antopolski + tiffany@antopolski.com + + + + + Introduction to Atril - The MATE Document Viewer. + + + Introduction + +

Atril is a document viewer. See for a + list of file types you can view.

+ + 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 @@ + + + + + + + Inverting the colors can make it easier to read some text. + + + + Phil Bull + philbull@gmail.com + + + Anna Philips + anna.cs.au@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + + +Invert colors on a page + + +

To swap black for white, white for black, and so on, go to the View menu and select Invert Colours (or press CtrlI).

+ + +

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

+ + 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 @@ + + +

This work is licensed under a + Creative Commons + Attribution-ShareAlike 3.0 Unported 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 @@ - - - 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 link or in the file COPYING-DOCS - distributed with this manual. - - This manual is part of a collection of MATE manuals - distributed under the GFDL. If you want to distribute this - manual separately from the collection, you can do so by - adding a copy of the license to the manual, as described in - section 6 of the license. - - - - Many of the names used by companies to distinguish their - products and services are claimed as trademarks. Where those - names appear in any MATE documentation, and the members of - the MATE Documentation Project are made aware of those - trademarks, then the names are in capital letters or initial - capital letters. - - - - DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED - UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE - WITH THE FURTHER UNDERSTANDING THAT: - - - - 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 - - - - 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. - - - - - - + +

This work is licensed under a +Creative Commons +Attribution-Share Alike 3.0 United States License.

+

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.

+ 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 @@ + + + + + + Legal information. + + + License +

+ + This work is distributed under a CreativeCommons Attribution-Share Alike + 3.0 Unported license. +

+

+ You are free: +

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

To copy, distribute and transmit the work.

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

To adapt the work.

+ + +

+ Under the following conditions: +

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

+ 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). +

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

+ If you alter, transform, or build upon this work, you may distribute the + resulting work only under the same, similar or a compatible license. +

+ + +

+ + For the full text of the license, see the + CreativeCommons website, + or read the full Commons Deed. +

+ 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 @@ + + + + + + + Phil Bull + philbull@gmail.com + + + Anna Philips + anna.cs.au@gmail.com + + + + + Navigating, scrolling and zooming. + + + Moving around a document + +

You can move around each page of a document by any of the following + methods:

+ + + +

Scrolling up and down using the mouse wheel. To move around a page + just by moving the mouse:

+ + +

Right-click the page and select Autoscroll.

+ + +

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.

+ + +

To stop autoscrolling, click anywhere in the document.

+ + + + +

Using the scroll bar on the document window.

+ + +

Using the up and down arrow keys of your keyboard.

+ + +

Dragging the page around with your mouse, as if you are grabbing it. + To do this:

+ + +

Move the mouse pointer over the page and hold down the middle + mouse button to drag it around.

+ + +

If you don't have a middle mouse button, hold down the left and + right mouse buttons at the same time, then drag.

+ + + + + +
+ Flipping between pages + +

You can move between pages of a document using one of the following + methods:

+ + + +

Press the CtrlPage Up or + CtrlPage Down buttons on the + keyboard.

+ + +

To go to a specific page:

+ + +

Type a page number in Select Page and press Enter.

+ + +

If you want to go to the beginning or the end of the document:

+ + +

Press CtrlHome on your + keyboard.

+ + +

Press CtrlEnd on your + keyboard.

+ + + + + + +

To move ten pages at a time, press ShiftPage + Up or ShiftPage + Down.

+ +

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 View menu + and select + Continuous.

+ + + + +
+ + + +
+ Zooming in and out + +

To adjust the zoom level:

+ + + +

Select the desired zoom percentage from combobox in the toolbar.

+ + +

Alternatively, use the keyboard shortcuts Ctrl+ + to zoom in, or Ctrl- to zoom out.

+ + +

Alternatively, hold down Ctrl and use your mouse scroll wheel to zoom.

+ + + + +

The Fit Page option will make a document page fit the whole + height of the window.

+

The Fit Width option will make a document page fill the whole + width of the window.

+

If you want to see two pages at once, side by side, like in a book, + go to ViewDual and press + Dual.

+

If the allow-links-change-zoom gsetting is set to false, links are blocked + from changing your zoom level.

+ + +

You can use the whole of your screen to view the document:

+ + + +

Press F11.

+ + +

To exit the full screen mode:

+

Press F11 or Escape

+ + +
+ + 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 @@ + + + + + The author may have put printing restrictions on the document. + + + Phil Bull + philbull@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + + +I can't print a document +
+ Possible reasons for printing failure +

A document might not print because of:

+ +

Printer problems or,

+

PDF printing restrictions.

 + +
+ +
+ Printer problems +

+ 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. +

+

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

+
+ +
+ PDF printing restrictions +

+ 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: +

+ + +

You need to have dconf Editor installed on your computer to + change this setting.

+ + + + +

Open dconf Editor.

+ + +

Browse to /org/mate/atril.

+ + +

+ Make sure that the override-restrictions option is checked. +

+ + +

+ Go back toAtril and try to print the document again. +

+ + +
+ + 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 @@ + + + + + Error When Opening A File. + + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + + + +Why can't I open a file? + +

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 Close to return toAtril window. +

+ + 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 @@ + + + + + + + + + Tiffany Antopolski + tiffany@antopolski.com + + + Ekaterina Gerasimova + kittykat3756@gmail.com + + + + + How to open a document. + + + Open a document + +

You can open a document using any one of the following ways:

+ + + +

Double-click on the file in Caja or your file + manager.

+ +

Double clicking PDF, PostScript, .djvu, .dvi and Comic Book + Archive files opens them in Atril by default.

+ + + +

Right-click on a file icon in Caja and click + Open WithAtril.

+ + + +

If an empty Atril window is already open you can:

+ + + +

Drag a file into the window from Caja. The new file will + open in a new window.

+ + +

Press the Open… button in the top-left corner of + the window. In the Open Document + dialog, choose the file which you wish to open, and click + Open. The file will open in a new window.

+ + + +

If a document is already opened in a Atril window you can:

+ + + +

Drag a file into the window from Caja. The new file will + open in a new window.

+ + +

Press CtrlO. In the Open Document + dialog, choose the file which you wish to open, and click + Open. The file will open in a new window.

+ + + + 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 @@ + + + + + + + Phil Bull + philbull@gmail.com + + + Ekaterina Gerasimova + kittykat3756@gmail.com + + + + + Handling password protected PDFs. + + + Password-protected documents + +

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 Unlock Document.

+ + + + +

Passwords can be set by the person who created or edited the + document.

+ + + 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 @@ + + + + + How to play presentations. + + + Phil Bull + philbull@gmail.com + + + Anna Philips + anna.cs.au@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + + +Presentations +
+Starting a presentation +

To start a presentation:

+ + +

Open a file

+ + +

Press View and select + Presentation (or press F5).

+

+ The presentation will be displayed full screen. +

+ + +
+
+ + Moving through a presentation + +

+ Use the spacebar, →, ↓, or left mouse click to go to the next slide. +

+

+ Use the ←, ↑ or right mouse click to go to the previous slide. +

+ +

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

+ +

+ Use Esc to exit the presentation. +

+
+ +
+Showing a blank screen +

Press B or . to show a black screen.

+

Press W to show a white screen.

+

Press B, ., or W again to show the +slide.

+
+ +
+Supported presentation file formats +

+The following file formats can be used for presentations: +

+ +

Comic Book Archive (.cbr and .cbz)

 +

Device Independent file format (.dvi)

 +

DjVu (.djvu, .djv)

 +

Open Document Presentation (.odp)

 +

Portable Document Format (.pdf)

 +

PostScript (.ps)

 + +
+ 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 @@ + + + + + + Printing two-sided and multi-page per sheet. + + + Phil Bull + philbull@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + + +Two-sided and multiple pages per side layout for printing + +

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

+ + + +

+ Go to FilePrint and press the Print button. +

+ + +

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

+ + +

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

+ + + + 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 @@ + + + + + + How to print a booklet. + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + + + +Printing a booklet + +

+ 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. +

+ +
+ Printer allows single-sided printing +
+ +
+ Printer allows double-sided printing +
+ + + + 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 @@ + + + + + + + Phil Bull + philbull@gmail.com + + + Ekaterina Gerasimova + kittykat3756@gmail.com + 2015 + + + + + Printing a document on paper of a different size or + orientation. + + + Changing the paper size when printing + +

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.

+ + + +

Go to FilePrint and press the Print button.

+ + +

Select the Page Setup tab.

+ + +

Under the Paper column, choose your Paper size from + the drop-down list.

+ + +

Click Print and your document should print.

+ + + +

You can also use the Orientation menu to choose a different + orientation:

+ + + +

Portrait

+ + +

Landscape

+ + +

Reverse portrait

+ + +

Reverse landscape

+ + + + 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 @@ + + + + + + + Ekaterina Gerasimova + kittykat3756@gmail.com + 2015 + + + + + Shrink or expand the document to fit the paper size. + + + Scale page for printing + +

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.

+ + + +

Open the menu at the top-right of the window, then select + Print….

+ + +

Select the Page Handling tab.

+ + +

Choose a Page Scaling from the drop-down list.

+ + +

None: do not perform page scaling.

+ + +

Shrink to Printable Area: document pages larger than the + printable area are reduced to fit the printable area of the printer + page.

+ + +

Fit to Printable Area: document pages are enlarged or + reduced as required to fit the printable area of the printer + page.

+ + + + +

Click Print to print your document.

+ + + + 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 @@ + + + + + + + How to print, and common questions about printing. + + + Phil Bull + philbull@gmail.com + + + Anna Philips + anna.cs.au@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + + +Printing a document + + +

To print a document:

+ + +

Click the File menu and + select Print or press + CtrlP.

+ + +

Choose your printer from the list.

+ +

Click Print.

 + + + + + + +

Printing is enabled for the following file formats:

+ +

Device Independent file format (.dvi)

 +

DjVu (.djvu, .djv)

 +

Portable Document Format (.pdf)

 +

PostScript (.ps)

 +

Tagged Image File Format (.tiff, .tif)

 + + + + + 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 @@ + + + + + + + Your document will be automatically reloaded if another program changes it while you're viewing it. + + + + Phil Bull + philbull@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + + +Why does the document keep reloading? + +

+ IfAtril 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. +

+ +

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

+ + 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 @@ + + + + + See a list of all shortcuts. + + + + Phil Bull + philbull@gmail.com + + + Tiffany Antopolski + tiffany.antopolski@gmail.com + + + Taufan Lubis + taufanlinux@gmail.com + + + Ronaldi Santosa + ronald.santosa@gmail.com + + + Ibnu Amansyah + javalander9@gmail.com + + + Andre Klapper + ak-47@gmx.net + + + Germán Poo-Caamaño + gpoo@gnome.org + + + +

Creative Commons Share Alike 3.0

+ + + + + +Keyboard shortcuts + +
Default shortcuts +
+ Opening, closing, saving and printing + + + + + + + + + + + + + + + + + + + + + + + + + +

Open a document.

CtrlO

Open a copy of the current document.

CtrlN

Save a copy of the current document with a new file +name.

CtrlS

Print the current document.

CtrlP

Close the current document window.

CtrlW

Reload the document (effectively closes and re-opens the +document).

CtrlR

+
+ +
+ Moving around a document + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Move up/down a page.

Arrow keys

Move up/down a page several lines at a time.

Page Up / Page Down

Go to the previous page.

CtrlPage Up / +P

Go to the next page.

CtrlPage Down / +N

Go to page number.

CtrlL followed by the page number and Enter

Go to the beginning of a page (beginning of the document if +Continuous is selected in the main menu in the top-right corner).

Home

Go to the end of a page (end of the document if +Continuous is selected in the main menu in the top-right corner).

End

Go to the beginning of the document.

CtrlHome

Go to the end of the document.

CtrlEnd

Add a bookmark in the current page.

CtrlD

Delete the bookmark in the current page if there is one.

ShiftCtrlD

Display the side pane with a table of contents and bookmarks.

F9

Enable caret navigation placing a moveable cursor in text pages, allowing you to move around and select text with the keyboard.

F7

+
+ +
+ Selecting and copying text + + + + + + + + + +

Copy highlighted text.

CtrlC / CtrlInsert

Select all the text in a document.

CtrlA

+
+ +
+ Finding text + + + + + + + + + + + + + +

+ 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. +

CtrlF / /

Go to the next search result.

CtrlG / F3

Go to the previous search result.

ShiftCtrlG / ShiftF3

+
+ +
+ Rotating and zooming + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Rotate the pages 90 degrees counter-clockwise.

CtrlLeft arrow

Rotate the pages 90 degrees clockwise.

CtrlRight +arrow

Default zoom.

Ctrl0

Zoom in.

Ctrl+ / = / + Ctrl=

Zoom out.

Ctrl-

Fit the page into the window.

F

Fit the content width to the space available.

W

+
+ +
+ Window + + + + + + + + + +

Use the full screen to view the document.

F11

Start a presentation.

F5 / ShiftF5

+
+ +
+ Document view + + + + + + + + + + + + + +

Invert background and text colors.

CtrlI

Swap between continuous and page by page view of the document.

C

Display two pages side by side.

D

+
+ +
+ Presentation mode + + + + + + + + + +

Toggle black screen.

B / .

Toggle white screen.

W

+
+ +
+ + 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 @@ + + + + + + Print a booklet with n pages. + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + + + +n-page booklet + +

+ n is a multiple of 4. +

+ +

+ 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: +

+ + +

+ Create a blank PDF using LibreOffice Writer. +

+ + +

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

+ + + +

+ To print: +

+ + +

+ Go to FilePrint and press the Print button. +

+ + +

+ Choose the General tab. +

+

+ Under Range, choose Pages. +

+ + + Type the numbers of the pages in this order: + 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... + ...until you have typed n-number of pages. + + + + +

+ Choose the Page Setup tab. +

+

+ Under Layout, in the Two-sided menu, select One Sided. +

+

+ In the Pages per side menu, select 2. +

+

+ In the Page ordering menu, select Left to right. +

+

+ In the Only print menu, select Odd sheets. +

+ + +

+ Click Print. +

+ + +

+ When all the pages have printed, flip the pages over and place them back in the printer. +

+ + +

+ Go to FilePrint and press the Print button. +

+ + +

+ Choose the Page Setup tab. +

+

+ In the Only print menu, select Even sheets. +

+ + +

+ Click Print. +

+ + + 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 @@ + + + + + Using SyncTeX with the LaTeX Beamer class. + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + + +Beamer with SyncTeX +

+ Beamer is a LaTeX class for creating slides for presentations. +

+

+ You can perform forward and backward search in a Beamer-LaTeX presentation in a similar fashion to searching 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. +

+ + + + + + 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 @@ + + + + + How to compile your TeX document with SyncTeX + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + + +Compile TeX with SyncTeX +

+Adding the line \synctex=1 in the preamble of your TeX file will trigger synchronization with SyncTeX. +

+ +\documentclass{article} +\synctex=1 +\usepackage{fullpage} +\begin{document} +... +\end{document} + +

+ Alternatively, you can run the pdflatex command with the -synctex=1 option: +

+pdflatex -synctex=1 yourFile.tex + 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 @@ + + + + + Which editor can you use to edit your TEX file? + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + + + +Supported editors + +
<app>pluma</app> +

+Forward Search (from pluma to Atril) and Backward search (from Atril to pluma) are both supported. +

+
+ +
Vim-latex +

+The pluma plugin contains a python script (atril_dbus.py) 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: +

+ + +

+ Copy the atril_dbus.py to some directory in your path and give it +x permissions. + +

+ + +

+ Modify your ~/.vimrc file and add the following lines. +

+ +let g:Tex_ViewRule_pdf = 'atril_dbus.py' +let g:Tex_DefaultTargetFormat = 'pdf' +let g:Tex_CompileRule_pdf = 'pdflatex --synctex=1 -interaction=nonstopmode $*' + + + + +

+ Now you can use Forward search from vim-latex by typing \ls. Backward search is not yet supported. +

+ + +
+ 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 @@ + + + + + Flip between Atril and pluma. + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + + + +Search with SyncTeX +

+ After you compile your TeX file with SyncTeX, you will be able to search. SyncTeX even supports forward and backward search from an included file. +

+ + + + + + 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 @@ + + + + + How to add support for SyncTeX. + + + Tiffany Antopolski + tiffany@antopolski.com + + + Germán Poo-Caamaño + gpoo@mate.org + + +

Creative Commons Share Alike 3.0

+ + + + +Set-up SyncTeX +

+The following packages need to be installed in order to add support for SyncTeX: +

+ + +

+ A LaTeX engine with SyncTeX support, such as pdflatex. +

+ + +

+ A text editor with SyncTeX support, such as pluma with pluma-plugins installed. +

+ + + +

+ In pluma, enable the SyncTeX Plugin: +

+ + +

+ Click EditPreferencesPlugins tab. +

+ + +

+ Check SyncTeX. +

+ + + 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 @@ + + + + + SyncTeX support is available. + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + + +What is SyncTeX? +

+ SyncTeX is a method that enables synchronization between a TeX source file and the resulting PDF output. +

+ + 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 @@ + + + + + When you copy text, the text that is pasted might be different from what you had selected. + + + Phil Bull + philbull@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + + +Why didn't the text I selected copy properly? + + +

+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. +

+ + +

+ 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. +

+ +

+ 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 pluma) may minimize the problem. +

+ + 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 @@ + + + + + Localize Atril. + + + Tiffany Antopolski + tiffany.antopolski@gmail.com + 2011 + + + Michael Hill + mdhillca@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + +Help translate +

+Atrils user interface and documentation is being translated by a world-wide volunteer community. You are welcome to participate. +

+

+ There are many languages for which translations are still needed. +

+

+To start translating you will need to create an account and join the translation team for your language. This will give you the ability to upload new translations. +

+ + 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 -- cgit v1.2.1