From c3e1500a4815225f08e1b20dd066559e8c92c280 Mon Sep 17 00:00:00 2001 From: Nickolay V. Shmyrev Date: Thu, 07 Apr 2005 15:28:06 +0000 Subject: Recent files support. 2005-04-07 Nickolay V. Shmyrev * cut-n-paste/recent-files/Makefile.am: * data/evince-ui.xml, shell/Makefile.am: * shell/ev-application.c, shell/ev-application.h: * shell/ev-window.c: Recent files support. * configure.ac: Added "ru" to ALL_LINGUAS. * dvju: new backend to support DJVU files. * dvi: new backend to support DVI. * configure.ac, Makefile.am, shell/Makefile.am, ev-window.c: * ev-application.c: Support for new backends. * help, ev-window.c, main.c shell/Makefile.am: --- (limited to 'help') diff --git a/help/.cvsignore b/help/.cvsignore new file mode 100644 index 0000000..282522d --- /dev/null +++ b/help/.cvsignore @@ -0,0 +1,2 @@ +Makefile +Makefile.in diff --git a/help/C/.cvsignore b/help/C/.cvsignore new file mode 100644 index 0000000..9382ad0 --- /dev/null +++ b/help/C/.cvsignore @@ -0,0 +1,4 @@ +Makefile +Makefile.in +evince-C.omf.out +omf_timestamp diff --git a/help/C/Makefile.am b/help/C/Makefile.am new file mode 100644 index 0000000..95d493a --- /dev/null +++ b/help/C/Makefile.am @@ -0,0 +1,9 @@ +figdir = figures +docname = evince +lang = C +omffile = evince-C.omf +entities = legal.xml +include $(top_srcdir)/help/xmldocs.make +dist-hook: app-dist-hook + +DISTCLEANFILES = evince-C.omf.out diff --git a/help/C/evince-C.omf b/help/C/evince-C.omf new file mode 100644 index 0000000..5c05e93 --- /dev/null +++ b/help/C/evince-C.omf @@ -0,0 +1,30 @@ + + + + + docs@gnome.org (GDP) + + + docs@gnome.org (GDP) + + + Evince Document Viewer Manual V1.0 + + + 2005-04-06 + + + + + User manual for the Evince Document Viewer. + + + user's guide + + + + + + + + diff --git a/help/C/evince.xml b/help/C/evince.xml new file mode 100644 index 0000000..c626a5c --- /dev/null +++ b/help/C/evince.xml @@ -0,0 +1,637 @@ + + + + + + Evince Document Viewer"> + +]> + + + + +
+ + + + &appname; Manual V&manrevision; + + 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.0 + &date; + + 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; + You can start &app; in the following ways: + + + + Applications menu + + Choose Graphics Evince Document Viewer . + + + + + Command line + + Execute the following 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 File + To open a File, perform the following steps: + + + + Choose FileOpen . + + + + In the Load file 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 in the opposite direction to the direction in which you want to scroll. 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 Structore + 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. + + To quit &app; at any time, no matter how many windows are open, choose File Quit . + + When you quit, &app; closes all documents opened in the current session. + + + + + +
diff --git a/help/C/figures/evince_start_window.png b/help/C/figures/evince_start_window.png new file mode 100644 index 0000000..8cc15dc --- /dev/null +++ b/help/C/figures/evince_start_window.png Binary files differ diff --git a/help/C/legal.xml b/help/C/legal.xml new file mode 100644 index 0000000..ac97e1d --- /dev/null +++ b/help/C/legal.xml @@ -0,0 +1,76 @@ + + + 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. + + + + + + diff --git a/help/Makefile.am b/help/Makefile.am new file mode 100644 index 0000000..42ffacc --- /dev/null +++ b/help/Makefile.am @@ -0,0 +1 @@ +SUBDIRS = C diff --git a/help/omf.make b/help/omf.make new file mode 100644 index 0000000..3261e00 --- /dev/null +++ b/help/omf.make @@ -0,0 +1,53 @@ +# +# No modifications of this Makefile should be necessary. +# +# This file contains the build instructions for installing OMF files. It is +# generally called from the makefiles for particular formats of documentation. +# +# Note that you must configure your package with --localstatedir=/var/lib +# so that the scrollkeeper-update command below will update the database +# in the standard scrollkeeper directory. +# +# If it is impossible to configure with --localstatedir=/var/lib, then +# modify the definition of scrollkeeper_localstate_dir so that +# it points to the correct location. Note that you must still use +# $(localstatedir) in this or when people build RPMs it will update +# the real database on their system instead of the one under RPM_BUILD_ROOT. +# +# Note: This make file is not incorporated into xmldocs.make because, in +# general, there will be other documents install besides XML documents +# and the makefiles for these formats should also include this file. +# +# About this file: +# This file was taken from scrollkeeper_example2, a package illustrating +# how to install documentation and OMF files for use with ScrollKeeper +# 0.3.x and 0.4.x. For more information, see: +# http://scrollkeeper.sourceforge.net/ +# Version: 0.1.2 (last updated: March 20, 2002) +# + +omf_dest_dir=$(datadir)/omf/@PACKAGE@ +scrollkeeper_localstate_dir = $(localstatedir)/scrollkeeper + +omf: omf_timestamp + +omf_timestamp: $(omffile) + -for file in $(omffile); do \ + scrollkeeper-preinstall $(docdir)/$(docname).xml $(srcdir)/$$file $$file.out; \ + done + touch omf_timestamp + +install-data-hook-omf: + $(mkinstalldirs) $(DESTDIR)$(omf_dest_dir) + for file in $(omffile); do \ + $(INSTALL_DATA) $$file.out $(DESTDIR)$(omf_dest_dir)/$$file; \ + done + -scrollkeeper-update -p $(scrollkeeper_localstate_dir) -o $(DESTDIR)$(omf_dest_dir) + +uninstall-local-omf: + -for file in $(srcdir)/*.omf; do \ + basefile=`basename $$file`; \ + rm -f $(omf_dest_dir)/$$basefile; \ + done + -rmdir $(omf_dest_dir) + -scrollkeeper-update -p $(scrollkeeper_localstate_dir) diff --git a/help/xmldocs.make b/help/xmldocs.make new file mode 100644 index 0000000..ad65ccf --- /dev/null +++ b/help/xmldocs.make @@ -0,0 +1,96 @@ +# +# No modifications of this Makefile should be necessary. +# +# To use this template: +# 1) Define: figdir, docname, lang, omffile, and entities in +# your Makefile.am file for each document directory, +# although figdir, omffile, and entities may be empty +# 2) Make sure the Makefile in (1) also includes +# "include $(top_srcdir)/xmldocs.make" and +# "dist-hook: app-dist-hook". +# 3) Optionally define 'entities' to hold xml entities which +# you would also like installed +# 4) Figures must go under $(figdir)/ and be in PNG format +# 5) You should only have one document per directory +# 6) Note that the figure directory, $(figdir)/, should not have its +# own Makefile since this Makefile installs those figures. +# +# example Makefile.am: +# figdir = figures +# docname = scrollkeeper-manual +# lang = C +# omffile=scrollkeeper-manual-C.omf +# entities = fdl.xml +# include $(top_srcdir)/xmldocs.make +# dist-hook: app-dist-hook +# +# About this file: +# This file was taken from scrollkeeper_example2, a package illustrating +# how to install documentation and OMF files for use with ScrollKeeper +# 0.3.x and 0.4.x. For more information, see: +# http://scrollkeeper.sourceforge.net/ +# Version: 0.1.2 (last updated: March 20, 2002) +# + + +# ************* Begin of section some packagers may need to modify ************** +# This variable (docdir) specifies where the documents should be installed. +# This default value should work for most packages. +# docdir = $(datadir)/@PACKAGE@/doc/$(docname)/$(lang) +docdir = $(datadir)/gnome/help/$(docname)/$(lang) + +# ************** You should not have to edit below this line ******************* +xml_files = $(entities) $(docname).xml + +EXTRA_DIST = $(xml_files) $(omffile) +CLEANFILES = omf_timestamp + +# If the following file is in a subdir (like help/) you need to add that to the path +include $(top_srcdir)/help/omf.make + +all: omf + +$(docname).xml: $(entities) + -ourdir=`pwd`; \ + cd $(srcdir); \ + cp $(entities) $$ourdir + +app-dist-hook: + if test "$(figdir)"; then \ + $(mkinstalldirs) $(distdir)/$(figdir); \ + for file in $(srcdir)/$(figdir)/*.png; do \ + basefile=`echo $$file | sed -e 's,^.*/,,'`; \ + $(INSTALL_DATA) $$file $(distdir)/$(figdir)/$$basefile; \ + done \ + fi + +install-data-local: omf + $(mkinstalldirs) $(DESTDIR)$(docdir) + for file in $(xml_files); do \ + cp $(srcdir)/$$file $(DESTDIR)$(docdir); \ + done + if test "$(figdir)"; then \ + $(mkinstalldirs) $(DESTDIR)$(docdir)/$(figdir); \ + for file in $(srcdir)/$(figdir)/*.png; do \ + basefile=`echo $$file | sed -e 's,^.*/,,'`; \ + $(INSTALL_DATA) $$file $(DESTDIR)$(docdir)/$(figdir)/$$basefile; \ + done \ + fi + +install-data-hook: install-data-hook-omf + +uninstall-local: uninstall-local-doc uninstall-local-omf + +uninstall-local-doc: + -if test "$(figdir)"; then \ + for file in $(srcdir)/$(figdir)/*.png; do \ + basefile=`echo $$file | sed -e 's,^.*/,,'`; \ + rm -f $(docdir)/$(figdir)/$$basefile; \ + done; \ + rmdir $(DESTDIR)$(docdir)/$(figdir); \ + fi + -for file in $(xml_files); do \ + rm -f $(DESTDIR)$(docdir)/$$file; \ + done + -rmdir $(DESTDIR)$(docdir) + -- cgit v0.9.1