From: Ryan Lortie Date: Tue, 5 Oct 2010 03:29:46 +0000 (-0400) Subject: Import Mallard documentation X-Git-Tag: EVINCE_2_91_1~19 X-Git-Url: https://www.fi.muni.cz/~kas/git//home/kas/public_html/git/?a=commitdiff_plain;h=d19ad6f9b763a5fda2fb8ef5dab0c24bf43f8832;p=evince.git Import Mallard documentation Replace the existing Evince user guide with new topic-based help from the Mallard project. Documentation written by Phil Bull and Tiffany Antopolski. --- diff --git a/help/C/add-text-annotation.png b/help/C/add-text-annotation.png new file mode 100644 index 00000000..6ca8d858 Binary files /dev/null and b/help/C/add-text-annotation.png differ diff --git a/help/C/annotation-properties.page b/help/C/annotation-properties.page new file mode 100644 index 00000000..aab5fa86 --- /dev/null +++ b/help/C/annotation-properties.page @@ -0,0 +1,55 @@ + + + + + You can customise the author, colour, style or icon of an annotation. + + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + + + + Customise an Annotation + + + +

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

+ + +

+ Select Annotation Properties... +

+ + +

+ In the Annotation Properties window, you can change the author, colour, 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..780ef86a --- /dev/null +++ b/help/C/annotations-delete.page @@ -0,0 +1,24 @@ + + + + + You can not remove an annotation in Evince Document Viewer. + + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + + + + How can I remove an annotation? +

+ You can not remove an annotation in Evince Document Viewer at this time. +

+ diff --git a/help/C/annotations-nav-to-page.png b/help/C/annotations-nav-to-page.png new file mode 100644 index 00000000..08a746dc Binary files /dev/null and b/help/C/annotations-nav-to-page.png differ diff --git a/help/C/annotations-navigate.page b/help/C/annotations-navigate.page new file mode 100644 index 00000000..080680ed --- /dev/null +++ b/help/C/annotations-navigate.page @@ -0,0 +1,29 @@ + + + + + You can 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 List tab to display the list of all the annotations in the document. The list indicates the type, page number, author and date of the annotation. +

+ +

+ To quickly navigate to the location of a particular annotation, click on the arrow to the left of the page number. You will see a list of annotations on that page. Click on the annotation you are interested in, and Evince Document Viewer will navigate to the location of the annotation in the document. +

+ + diff --git a/help/C/annotations-navigate.png b/help/C/annotations-navigate.png new file mode 100644 index 00000000..261f1285 Binary files /dev/null and b/help/C/annotations-navigate.png differ diff --git a/help/C/annotations.page b/help/C/annotations.page new file mode 100644 index 00000000..7a4990b8 --- /dev/null +++ b/help/C/annotations.page @@ -0,0 +1,108 @@ + + + + + Creating Annotations in Evince Document Viewer. + + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + + + +Adding an Annotation + +

+ When you open a file in Evince Document Viewer you should have a side pane on the left side of the window. If you do not have a visible side pane, click ViewSide Pane or press F9. +

+ +

+ At the top of this side pane, there is a drop-down menu with the following options (some of which may be dimmed for some documents): +

+ + +

+ Thumbnails +

+ + +

+ Index +

+ + +

+ Attachments +

+ + +

+ Layers +

+ + +

+ Annotations +

+ + + +

+ To create an annotation: +

+ + +

+ Select Annotations from the drop-down menu. +

+ + +

+ You should now see List and Add tabs under the drop-down menu. +

+ + + + + +

+ Select the Add tab. +

+ + +

+ Click on the icon to add a text annotation. +

+ + + +

+ Click on the spot in the document window you would like to add the annotion 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..71ae9d2c --- /dev/null +++ b/help/C/bookmarks.page @@ -0,0 +1,25 @@ + + + + + Can I create bookmarks in Evince Document Viewer? + + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + + + +Bookmarks +

+ Evince Document Viewer does not have a bookmark system. However, you can use annotations like bookmarks. +

+ + diff --git a/help/C/commandline.page b/help/C/commandline.page new file mode 100644 index 00000000..01beba18 --- /dev/null +++ b/help/C/commandline.page @@ -0,0 +1,60 @@ + + + + + The Document Viewer can be started with the evince command. + + + + Phil Bull + philbull@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + + +Opening The Document Viewer From The Command Line + +

+To start the Document Viewer from the command line, type evince. You +can open a specific file by typing the filename after the evince command: +

+ +evince file.pdf +

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

+evince file1.pdf file2.pdf +

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

+evince http://www.claymath.org/millennium/P_vs_NP/pvsnp.pdf +
+ Opening A Document At A Specific Page +

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

+ evince --page-label=3 +

+ The page label should be in the same format as the page number displayed in + the Document Viewer toolbar. +

+
+
+ Opening A Document In Fullscreen Mode + evince --fullscreen file.pdf +
+
+ Opening A Document In Presentation Mode + evince --presentation file.pdf +
+
+ Opening A Document In Preview Mode + evince --preview file.pdf +
+ diff --git a/help/C/convertPostScript.page b/help/C/convertPostScript.page new file mode 100644 index 00000000..7993795b --- /dev/null +++ b/help/C/convertPostScript.page @@ -0,0 +1,54 @@ + + + + + + You can convert a document to PostScript. + + + + Phil Bull + philbull@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 Document Viewer and "printing" the document as a PostScript file. +

+ + +

+ Click FilePrint and go to the + General tab. +

+ + +

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

+ + +

+ Choose a name and folder to save the file in, 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..ab3bb78c --- /dev/null +++ b/help/C/convertSVG.page @@ -0,0 +1,51 @@ + + + + + + You can convert a document to SVG by "printing" it to a file. + + + + Phil Bull + philbull@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 Document Viewer and "printing" the document as an SVG file. +

+ + +

+ Click FilePrint and go to the + General tab. +

+ + +

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

+ + +

+ Choose a name and folder to save the file in, 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..662b3fd9 --- /dev/null +++ b/help/C/convertpdf.page @@ -0,0 +1,65 @@ + + + + + + You can convert a document to PDF by "printing" it to a file. + + + + Phil Bull + philbull@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 Document Viewer and "printing" the document as a PDF file. +

+ + +

+ Click FilePrint and go to the + General tab. +

+ + +

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

+ + +

+Note: +

+

+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/editing.page b/help/C/editing.page new file mode 100644 index 00000000..84ead1e9 --- /dev/null +++ b/help/C/editing.page @@ -0,0 +1,35 @@ + + + + + + You can not use the Evince Document Viewer to edit files. + + + + Phil Bull + philbull@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + + +Can I Edit Documents In The Document Viewer? + + +

+ The document viewer can not 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 +pdfedit, for example. +

+ + diff --git a/help/C/evince.xml b/help/C/evince.xml deleted file mode 100644 index 40bd6750..00000000 --- a/help/C/evince.xml +++ /dev/null @@ -1,774 +0,0 @@ - - - - - - Evince Document Viewer"> - -]> - - - - -
- - - - &appname; Manual - - - The Evince Document Viewer application enables you to view documents of various formats like Portable - Document Format (PDF) files and PostScript files - - - - 2005 - Nickolay V. Shmyrev - - - 2004 - Sun Microsystems - - - - - - GNOME Documentation Project - - - &legal; - - - - - Sun - GNOME Documentation Team - Sun Microsystems - - - Nickolay V. - Shmyrev - - GNOME Documentation Project -
nshmyrev@yandex.ru
- - - - - - - - - &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 GNOME Feedback Page. - - - - - - - &appname; - - - evince - - - - - - - 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 GNOME 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: evince. - - - - - 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/evincelogo.png b/help/C/evincelogo.png new file mode 100644 index 00000000..41091f44 Binary files /dev/null and b/help/C/evincelogo.png differ diff --git a/help/C/figures/evince_start_window.png b/help/C/figures/evince_start_window.png deleted file mode 100644 index 9f30e8b8..00000000 Binary files a/help/C/figures/evince_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..49f95fc3 --- /dev/null +++ b/help/C/finding.page @@ -0,0 +1,48 @@ + + + + + Search for a given term on a page. + + + + Phil Bull + philbull@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + + +Finding Things In A Document + +

Click EditFind or press + CtrlF or / to display a + search box.

+ +

Type the word you want to look for and a search will start + automatically.

 + +

The Find Previous and Find Next buttons let you skip from + one search result to another.

 + + +

To hide the search bar, click anywhere in the document.

+ +

If the search bar says 0 found on this page, and clicking the Find Next button has no effect, then your search word has not been + found in the document.

+ + + + + + +

Some documents are not searchable because the original text of the document has + been converted into a different format. For example, many PostScript (.ps) files are not searchable.

+ + + diff --git a/help/C/formats.page b/help/C/formats.page new file mode 100644 index 00000000..118594c6 --- /dev/null +++ b/help/C/formats.page @@ -0,0 +1,42 @@ + + + + + + + + PDF, PostScript and several other formats are supported. + + + + Phil Bull + philbull@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + + +Supported Formats + +

+The Document Viewer supports the following formats: +

+ +

Comic Book Archive (.cbr and .cbz)

 +

Device Independent file format (.dvi)

 +

DjVu (.djvu, .djv)

 +

OpenOffice Presentation (.odp)

 +

Portable Document Format (.pdf)

 +

PostScript (.ps)

 +

Scalable Vector Graphics (.svg)

 +

Tagged Image File Format (.tiff, .tif)

 +

Other Image Files (.gif, .jpeg, .png)

 + + + + + diff --git a/help/C/forms.page b/help/C/forms.page new file mode 100644 index 00000000..95567d5b --- /dev/null +++ b/help/C/forms.page @@ -0,0 +1,24 @@ + + + + + Working with fillable forms in Evince Document Viewer. + + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + + + +Forms + + + + diff --git a/help/C/gconf-editor.png b/help/C/gconf-editor.png new file mode 100644 index 00000000..4920ea13 Binary files /dev/null and b/help/C/gconf-editor.png differ diff --git a/help/C/index.page b/help/C/index.page new file mode 100644 index 00000000..154fdf5a --- /dev/null +++ b/help/C/index.page @@ -0,0 +1,45 @@ + + + + Help for the Evince Document Viewer. + Evince Document Viewer + Evince Document Viewer + + + Phil Bull + philbull@gmail.com + + + + + +<media type="image" src="evincelogo.png">Evince logo</media> +Evince Document Viewer + +
+ Reading Documents +
+ +
+ Presentations and Other Supported Formats +
+ +
+ Printing +
+ +
+ Annotations +
+ +
+ Problems and Common Questions +
+ +
+ Other Information +
+ + diff --git a/help/C/introduction.page b/help/C/introduction.page new file mode 100644 index 00000000..511c2039 --- /dev/null +++ b/help/C/introduction.page @@ -0,0 +1,26 @@ + + + + + Introduction to the Evince Document Viewer. + + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + + + + + +Introduction + + +

Evince 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..71a92c75 --- /dev/null +++ b/help/C/invert-colors.page @@ -0,0 +1,43 @@ + + + + + + + Inverting the colors can make it easier to read some text. + + + + + Phil Bull + philbull@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + + +Invert Colours On A Page + + + +

+ Click ViewInverted Colors. +

+ +

+ This will swap black for white, white for black, and so on. +

+ + + + + +

+ 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.xml b/help/C/legal.xml index ac97e1de..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 GNOME 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 GNOME documentation, and the members of - the GNOME 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/list-add-tabs.png b/help/C/list-add-tabs.png new file mode 100644 index 00000000..74af3db1 Binary files /dev/null and b/help/C/list-add-tabs.png differ diff --git a/help/C/movingaround.page b/help/C/movingaround.page new file mode 100644 index 00000000..6161f9b4 --- /dev/null +++ b/help/C/movingaround.page @@ -0,0 +1,139 @@ + + + + + Scrolling and navigating around a page. + + + + Phil Bull + philbull@gmail.com + + +

Creative Commons Share Alike 3.0

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

+ + +

Click the Previous or Next buttons on the toolbar.

+

Use the Go Menu:

+ +

GoNext Page

 +

GoPrevious Page

 + + +

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

 +

To go to a specific page:

+ +

type a page number in the text box on the toolbar and press Enter.

+

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

+ +

Click GoFirst Page. You can also press CtrlHome on your keyboard.

 +

Click GoLast Page or 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, click + ViewContinuous. +

+ + + +
+ +
+ Navigating With A Page List Or Table Of Contents + +

To make the side pane visible:

+ +

Click ViewSide Pane on the toolbar, + or press F9 on the keyboard.

+

You should see a preview of all of the pages in + the document.

 + + +

You can move between pages by clicking on them in the side pane.

+ + +

+ Some documents have an index or table of contents, which you can display in the + side pane. Click the drop-down list at the top of the side pane and select + Index to view it.

+

Most documents don't use this feature, so you + won't be able to view their index in the side pane.

 + + +
+ + diff --git a/help/C/noprint.page b/help/C/noprint.page new file mode 100644 index 00000000..a02dfa58 --- /dev/null +++ b/help/C/noprint.page @@ -0,0 +1,89 @@ + + + + + The author may have put printing restrictions on the document. + + + Phil Bull + philbull@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + + +Why Can't I Print A Document? + +

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

+ +

To check if your printer is printing correctly:

+ +

Choose SystemAdministrationPrinting

 +

Double click on your printer in the list.

 +

Select Settings in the left menu. Click on Print Test Page. A page should be sent to your printer.

+ +

+If this fails, see your printer's manual + to see what else you can do. +

+ + + + + + +
+ +
+ 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. + Evince overrides this restriction by default, but you may want to check + that it hasn't been disabled: +

+ + + +

+ Press AltF2 to open the Run + Application window. +

+ + +

+ Type gconf-editor into the text box and click + Run. The Configuration Editor will open. +

+ +

Browse to /apps/evince using the side pane.

 + +

+ Make sure that the override_restrictions option is checked. +

+ + +

+ Go back to the Document Viewer 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..119aecbe --- /dev/null +++ b/help/C/openerror.page @@ -0,0 +1,27 @@ + + + + + Why can't I open a file? + + + + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + + + +Error When Opening A File + +

If you try to open a document of a format that Evince Document Viewer does not recognise, you will get an "Unable to open document" error message. Click Close to return to the Document Viewer window. +

+ + diff --git a/help/C/opening.page b/help/C/opening.page new file mode 100644 index 00000000..e7b80002 --- /dev/null +++ b/help/C/opening.page @@ -0,0 +1,46 @@ + + + + + How to open a document using Evince Document Viewer. + + + + + + Tiffany Antopolski + tiffany@antopolski.com + + +

Creative Commons Share Alike 3.0

+ + + + +Opening A Document + +

You can open a document in Evince Document Viewer using the following ways:

+ + +

Double-click on the file icon in the file manager or on the Desktop.

+

+ Double clicking opens PDF, PostScript, .djvu, .dvi and Comic Book Archive files in the Document Viewer by default. +

+ + +

Right-click on a file icon on the Desktop or in the file manager and click Open WithDocument Viewer.

+ + + +

If a Document View window is already open you can:

+ +

drag a file icon into the window from the Desktop or the file manager. The new file will open in a new window (provided the file is of a file type supported by Document Viewer).

 +

choose FileOpen from the Menubar. In the Open Document dialog box, choose the file 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..3920e47d --- /dev/null +++ b/help/C/password.page @@ -0,0 +1,34 @@ + + + + + Handling PDF files which are password-protected. + + + + Phil Bull + philbull@gmail.com + + +

Creative Commons Share Alike 3.0

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

+ +

There are two types of passwords:

+ + +

The user password is needed to view the document.

 +

The master password is required to print the document as well as view it.

 + + + +

These passwords are set by the person who created the document.

+ + diff --git a/help/C/presentations.page b/help/C/presentations.page new file mode 100644 index 00000000..e60ca6bd --- /dev/null +++ b/help/C/presentations.page @@ -0,0 +1,62 @@ + + + + + You can play presentations with the Document Viewer. + + + + Phil Bull + philbull@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + + +Presentations +

The Document Viewer can be used to display presentations.

+ +

To start a presentation:

+ +

Open a file

+

Click ViewPresentation (or press F5).

+ +

+The presentation will be displayed full screen. +

+ + + + +
+Moving Through A Presentation +

Use the spacebar, right arrow key, down arrow key, or left mouse click to go to the next slide.

+

Use the left arrow key, up arrow key 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.

+
+ + + +

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

+ +

Comic Book Archive (.cbr and .cbz)

 +

Device Independent file format (.dvi)

 +

DjVu (.djvu, .djv)

 +

OpenOffice 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..0e3151ab --- /dev/null +++ b/help/C/print-2sided.page @@ -0,0 +1,83 @@ + + + + + + + Printing two-sided and multi-page per 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: +

+ + + +

+ Click FilePrint. +

+ + +

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

+ + + +

+ If you are printing a booklet (which will perhaps be bound or stapled in the middle of each page): +

+ + +

+ Click FilePrint. +

+ + +

+ Choose the Page Setup tab. +

+ + +

+ Under Layout, in the Pages per side menu, select 2. +

+ + +

+ In the Page ordering and Only print options, choose selections that will print the document in sach a way that the pages will be in the right order after binding. +

+ + +

+You may need to use the Pages option on the General tab too. +

+ + + + + + + + diff --git a/help/C/print-2sided.png b/help/C/print-2sided.png new file mode 100644 index 00000000..ec15e28f Binary files /dev/null and b/help/C/print-2sided.png differ diff --git a/help/C/print-differentsize.page b/help/C/print-differentsize.page new file mode 100644 index 00000000..1f93aa45 --- /dev/null +++ b/help/C/print-differentsize.page @@ -0,0 +1,41 @@ + + + + + + Printing a document on paper of a different size, shape or orientation. + + + + Phil Bull + philbull@gmail.com + + +

Creative Commons Share Alike 3.0

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

+ +

Click File Print...

+

Select the Page Setup tab.

 +

Under the Paper column, choose your Paper size from the dropdown 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-order.page b/help/C/print-order.page new file mode 100644 index 00000000..aa2799ac --- /dev/null +++ b/help/C/print-order.page @@ -0,0 +1,59 @@ + + + + + + + Use the Collate and Reverse options to make pages print in order. + + + + Phil Bull + philbull@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + +Getting Copies To Print In The Correct Order + +
+Reverse +

+Printers usually print the first page first, and the last page last, so the +pages end up in reverse order when you pick them up. +

+

+ To reverse the order: +

+ +

FilePrint...

 +

In the General tab of the Print window under Copies check Reverse. The last page will be printed first, and so on.

 + + +
+ +
+Collate +

+If you are printing more than one copy of the document, the print outs will be grouped by page +number by default. (e.g. The copies of page one come out, then the copies of page two, etc.) Collating will make each copy come out with +its pages grouped together. +

+ +

+ To Collate: +

+ +

FilePrint...

 +

In the General tab of the Print window under Copies check Collate.

+ + +
+ + + + diff --git a/help/C/print-select.page b/help/C/print-select.page new file mode 100644 index 00000000..3b5813e3 --- /dev/null +++ b/help/C/print-select.page @@ -0,0 +1,49 @@ + + + + + + Print only specific pages, or only a range of pages. + + + + Phil Bull + philbull@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + +Only Printing Certain Pages + + +

+ To only print certain pages from the document: +

+ +

Click File Print...

 +

In the General tab in the Print window choose Pages from the Range section.

 +

Type the numbers of the pages you want to print in the textbox, separated by commas. Use a dash to denote a range of pages. +

 + + + + + +

+ Example: +

+ + + +

+ Pages 1, 3, 5, 6, 7 and 9 will be printed. +

+ + + + + diff --git a/help/C/print-select.png b/help/C/print-select.png new file mode 100644 index 00000000..6a7a6869 Binary files /dev/null and b/help/C/print-select.png differ diff --git a/help/C/printing.page b/help/C/printing.page new file mode 100644 index 00000000..abdb67cf --- /dev/null +++ b/help/C/printing.page @@ -0,0 +1,51 @@ + + + + + + + How to print, and common questions about printing. + + + + Phil Bull + philbull@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + + +Printing A Document + + +

To print a document:

+ +

Click FilePrint

 +

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..96305e1d --- /dev/null +++ b/help/C/reload.page @@ -0,0 +1,36 @@ + + + + + + + The Document Viewer automatically reloads your document 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? + +

+If the Document Viewer 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 remain open in the Document Viewer. +

+ + diff --git a/help/C/reverse-collate.png b/help/C/reverse-collate.png new file mode 100644 index 00000000..28d1da25 Binary files /dev/null and b/help/C/reverse-collate.png differ diff --git a/help/C/shortcuts.page b/help/C/shortcuts.page new file mode 100644 index 00000000..4f08e5f0 --- /dev/null +++ b/help/C/shortcuts.page @@ -0,0 +1,229 @@ + + + + + All keyboard shortcuts listed, and how to create custome shortcuts. + + + + Phil Bull + philbull@gmail.com + + +

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 the 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/next page.CtrlPage Up / CtrlPage Down
Go to the beginning of a page (beginning of the document if View Continuous is selected).Home
Go to the end of a page (end of the document if ViewContinuous is selected). End
Go to the beginning of the document.CtrlHome
Go to the end of the document.CtrlEnd
+
+ +
+ Selecting and copying text + + + + + + + + + +
Copy highlighted text.CtrlC
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. + CtrlF
Go to the next search result.CtrlG
Go to the previous search result.CtrlShiftG
+
+ +
+ Rotating and zooming + + + + + + + + + + + + + + + + + +
Rotate the pages 90 degrees counter-clockwise.CtrlLeft arrow
Rotate the pages 90 degrees clockwise.CtrlRight arrow
Zoom in.Ctrl+
Zoom out.Ctrl-
+
+
+ +
+ Create Your Own Custom Shortcuts + + +

+Enable the /desktop/gnome/interface/can_change_accels flag in gconf: +

+ + +

+ PressAltF2. The Run Application dialogue opens. +

+ + +

+ In the textbox, type 'gconf-editor'. +

+ + +

+ In the Configuration Editor select desktopgnomeinterface. +

+ + +

+ Check the value box for can_change_accels in the right side of the window. +

+ + +

+ You can add/change the shortcut as follows: +

+ + +

+ Open Evince Document Viewer. +

+ + +

+ Hover the pointer over the menu item you want to change/create the shortcut for. +

+ + +

+ Enter the shortcut you want on the keyboard, e.g. CtrlShiftT. +

+ + +

+ Close Evince Document Viewer. +

+ + + + +

+ Repeat steps 1-3. +

+ + +

+ Uncheck the value box for can_change_accels in the right side of the window. +

+ +

+ The next time Evince starts your custom shortcut key will be preserved. +

+ + + + + + + +

+ Note that this also works for many other Gnome applications as well. +

+ +
+ diff --git a/help/C/textselection.page b/help/C/textselection.page new file mode 100644 index 00000000..701b4cc1 --- /dev/null +++ b/help/C/textselection.page @@ -0,0 +1,49 @@ + + + + + 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 Evince Document Viewer 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 may minimise the problem. You can locate a text editor by clicking:

+ + +

+ ApplicationsAccessoriesgedit Text Editor. +

+ + + + + diff --git a/help/C/tips.page b/help/C/tips.page new file mode 100644 index 00000000..90e321ef --- /dev/null +++ b/help/C/tips.page @@ -0,0 +1,26 @@ + + + + + Learn about extra features, and ways you can use the Document Viewer more effectively. + + + + Phil Bull + philbull@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + + +Tips And Tricks +

+Learn how you can use the Document Viewer more effectively, by making use of +features that might not be obvious. +

+ + diff --git a/help/C/zoom.png b/help/C/zoom.png new file mode 100644 index 00000000..2e523e14 Binary files /dev/null and b/help/C/zoom.png differ diff --git a/help/C/zooming.page b/help/C/zooming.page new file mode 100644 index 00000000..7771a0da --- /dev/null +++ b/help/C/zooming.page @@ -0,0 +1,57 @@ + + + + + Change the size of the document by zooming in or out of the page. + + + + Phil Bull + philbull@gmail.com + + +

Creative Commons Share Alike 3.0

+ + + + +Zooming In And Out + + +

Click ViewZoom In or use the keyboard shortcuts Ctrl+ to zoom in.

 +

Click ViewZoom Out or use the keyboard shortcuts Ctrl- to zoom out.

 + + +

Alternatively, you can do one of the following:

+ +

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

 +

select desired zoom percentage from the drop down menu above the window.

+ + + + +

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

+

The Fit Page 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, click +ViewDual. +

+ +

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

+ + +

Click ViewFullscreen or press F11.

+

To exit from the full screen mode:

+ +

Press F11 or Escape

 +

or click the Leave Fullscreen button at the top of the screen.

 + + + + + diff --git a/help/Makefile.am b/help/Makefile.am index dae47297..b157b6cf 100644 --- a/help/Makefile.am +++ b/help/Makefile.am @@ -1,14 +1,60 @@ SUBDIRS = reference if ENABLE_HELP - include $(top_srcdir)/gnome-doc-utils.make + +DOC_ID = evince +DOC_INCLUDES = legal.xml + dist-hook: doc-dist-hook DOC_MODULE = evince -DOC_ENTITIES = legal.xml -DOC_INCLUDES = -DOC_FIGURES = figures/evince_start_window.png +DOC_INCLUDES = legal.xml +DOC_FIGURES = \ + add-text-annotation.png \ + annotations-navigate.png \ + annotations-nav-to-page.png \ + evincelogo.png \ + gconf-editor.png \ + list-add-tabs.png \ + print-2sided.png \ + print-select.png \ + reverse-collate.png \ + zoom.png + +DOC_PAGES = \ + annotation-properties.page \ + annotations-delete.page \ + annotations-navigate.page \ + annotations.page \ + bookmarks.page \ + commandline.page \ + convertpdf.page \ + convertPostScript.page \ + convertSVG.page \ + editing.page \ + finding.page \ + formats.page \ + forms.page \ + index.page \ + introduction.page \ + invert-colors.page \ + movingaround.page \ + noprint.page \ + openerror.page \ + opening.page \ + password.page \ + presentations.page \ + print-2sided.page \ + print-differentsize.page \ + printing.page \ + print-order.page \ + print-select.page \ + reload.page \ + shortcuts.page \ + textselection.page \ + tips.page \ + zooming.page DOC_LINGUAS = bg ca cs de el en_GB es eu fi fr it ja nl oc pt_BR ru sl sr sv uk vi zh_CN