help/C/evince.xml

   1 <?xml version="1.0"?>
   2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
   3 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
   4   <!ENTITY legal SYSTEM "legal.xml">
   5   <!ENTITY appversion "0.2">
   6   <!ENTITY manrevision "1.0">
   7   <!ENTITY date "April 2005">
   8   <!ENTITY app "<application>Evince Document Viewer</application>">
   9   <!ENTITY appname "Evince Document Viewer">
  10 ]>
  11
  12 <!--
  13       (Do not remove this comment block.)
  14   Maintained by the GNOME Documentation Project
  15   http://developer.gnome.org/projects/gdp
  16   Template version: 2.0 beta
  17   Template last modified Apr 11, 2002
  18 -->
  19
  20 <!-- =============Document Header ============================= -->
  21 <article id="index" lang="en">
  22 <!-- please do not change the id; for translations, change lang to -->
  23 <!-- appropriate code -->
  24   <articleinfo>
  25     <title>&appname; Manual V&manrevision;</title>
  26     <copyright>
  27       <year>2005</year>
  28       <holder>Nickolay V. Shmyrev</holder>
  29     </copyright>
  30     <copyright>
  31       <year>2004</year>
  32       <holder>Sun Microsystems</holder>
  33     </copyright>
  34
  35 <!-- translators: uncomment this:
  36     <copyright>
  37       <year>2002</year>
  38       <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  39     </copyright>
  40 -->
  41
  42     <publisher>
  43       <publishername> GNOME Documentation Project </publishername>
  44     </publisher>
  45
  46     &legal;
  47     <!-- This file  contains link to license for the documentation (GNU FDL), and
  48          other legal stuff such as "NO WARRANTY" statement. Please do not change
  49          any of this. -->
  50
  51     <authorgroup>
  52       <author>
  53         <firstname>Sun</firstname>
  54         <surname>GNOME Documentation Team</surname>
  55         <affiliation><orgname>Sun Microsystems</orgname></affiliation>
  56       </author>
  57       <author>
  58         <firstname>Nickolay V. </firstname>
  59         <surname>Shmyrev</surname>
  60         <affiliation>
  61           <orgname>GNOME Documentation Project</orgname>
  62           <address> <email>nshmyrev@yandex.ru</email> </address>
  63         </affiliation>
  64       </author>
  65
  66 <!-- This is appropriate place for other contributors: translators,
  67      maintainers,  etc. Commented out by default.
  68       <othercredit role="translator">
  69         <firstname>Latin</firstname>
  70         <surname>Translator 1</surname>
  71         <affiliation>
  72           <orgname>Latin Translation Team</orgname>
  73           <address> <email>translator@gnome.org</email> </address>
  74         </affiliation>
  75         <contrib>Latin translation</contrib>
  76       </othercredit>
  77 -->
  78     </authorgroup>
  79
  80     <revhistory>
  81       <revision>
  82         <revnumber>&appname; Manual V1.0</revnumber>
  83         <date>&date;</date>
  84         <revdescription>
  85           <para role="author">Nickolay V. Shmyrev</para>
  86           <para role="publisher">GNOME Documentation Project</para>
  87         </revdescription>
  88       </revision>
  89     </revhistory>
  90
  91     <releaseinfo>This manual describes version &appversion; of &appname;
  92     </releaseinfo>
  93     <legalnotice>
  94       <title>Feedback</title>
  95       <para>To report a bug or make a suggestion regarding the &appname; application or this manual, follow the directions in the <ulink url="ghelp:gnome-feedback" type="help">GNOME Feedback Page</ulink>.
  96       </para>
  97 <!-- Translators may also add here feedback address for translations -->
  98     </legalnotice>
  99   </articleinfo>
 100
 101   <indexterm zone="index">
 102     <primary>&appname;</primary>
 103   </indexterm>
 104   <indexterm zone="index">
 105     <primary>evince</primary>
 106   </indexterm>
 107
 108 <!-- ============= Document Body ============================= -->
 109 <!-- ============= Introduction ============================== -->
 110 <!-- Use the Introduction section to give a brief overview of what
 111      the application is and what it does. -->
 112   <sect1 id="evince-introduction">
 113     <title>Introduction</title>
 114     <para>The &app; application enables you to view documents of various formats like Portable Document Format (PDF) files and PostScript files.  &app; follows Freedesktop.org and GNOME standards to provide integration with Desktop Environment.
 115     </para>
 116   </sect1>
 117
 118 <!-- =========== Getting Started ============================== -->
 119
 120   <sect1 id="evince-getting-started">
 121     <title>Getting Started</title>
 122
 123     <sect2 id="evince-start">
 124     <title>To Start &appname;</title>
 125     <para>You can start &app; in the following ways:
 126     </para>
 127     <variablelist>
 128       <varlistentry>
 129         <term><guimenu>Applications</guimenu> menu</term>
 130         <listitem>
 131           <para>Choose <menuchoice> <guisubmenu>Graphics</guisubmenu> <guimenuitem>Evince Document Viewer</guimenuitem> </menuchoice>.
 132           </para>
 133         </listitem>
 134       </varlistentry>
 135       <varlistentry>
 136         <term>Command line</term>
 137         <listitem>
 138           <para>Execute the following command: <command>evince</command>
 139           </para>
 140         </listitem>
 141       </varlistentry>
 142     </variablelist>
 143     </sect2>
 144
 145     <sect2 id="evince-when-start">
 146     <title>When You Start &appname;</title>
 147     <para>When you start &app;, the following window is displayed.</para>
 148
 149     <!-- ==== Figure ==== -->
 150       <figure id="mainwindow-fig">
 151         <title>&appname; Window</title>
 152         <screenshot>
 153           <mediaobject>
 154             <imageobject><imagedata
 155                 fileref="figures/evince_start_window.png" format="PNG"/>
 156             </imageobject>
 157             <textobject>
 158               <phrase>Shows &appname; main window. Contains titlebar, menubar, toolbar and display area. Menubar contains File, Edit, View, Go and Help menus. </phrase>
 159             </textobject>
 160           </mediaobject>
 161         </screenshot>
 162       </figure>
 163
 164     <para>The &app; window contains the following elements:
 165     </para>
 166       <variablelist>
 167         <varlistentry>
 168           <term>Menubar</term>
 169           <listitem>
 170             <para>The menus on the menubar contain all of the commands that you need to work with documents in &app;.</para>
 171           </listitem>
 172         </varlistentry>
 173         <varlistentry>
 174           <term>Toolbar</term>
 175           <listitem>
 176             <para>The toolbar contains a subset of the commands that you can access from the menubar.</para>
 177           </listitem>
 178         </varlistentry>
 179         <varlistentry>
 180           <term>Display area</term>
 181           <listitem>
 182             <para>The display area displays the document.</para>
 183           </listitem>
 184         </varlistentry>
 185       </variablelist>
 186
 187       <para>
 188         In &app;, you can perform the same action in several ways. For example, you can open a document in the following ways:
 189                   <informaltable frame="all">
 190                     <tgroup cols="2" colsep="1" rowsep="1">
 191                       <colspec colname="COLSPEC0" colwidth="50*"/>
 192                       <colspec colname="COLSPEC1" colwidth="50*"/>
 193                       <thead>
 194                         <row valign="top">
 195                           <entry colname="COLSPEC0">
 196                             <para>UI Component</para></entry>
 197                           <entry colname="COLSPEC1" align="left">
 198                             <para>Action</para></entry>
 199                         </row>
 200                       </thead>
 201                       <tbody>
 202                         <row valign="top">
 203                           <entry><para>Window</para></entry>
 204                           <entry>
 205                             <itemizedlist>
 206                               <listitem>
 207                                 <para>Drag a file into the &app; window from another application such as a file manager.</para>
 208                               </listitem>
 209                               <listitem>
 210                                 <para>Double-click on the file name in the file manager</para>
 211                               </listitem>
 212                             </itemizedlist>
 213                           </entry>
 214                         </row>
 215                         <row valign="top">
 216                           <entry><para>Menubar</para></entry>
 217                           <entry><para>Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Open</guimenuitem></menuchoice>.</para>
 218 </entry>
 219                         </row>
 220                         <row valign="top">
 221                           <entry><para>Shortcut keys</para></entry>
 222                           <entry><para>Press <keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo>.</para></entry>
 223                         </row>
 224                       </tbody>
 225                     </tgroup>
 226                   </informaltable>
 227       </para>
 228       <para>
 229       This manual documents functionality from the menubar.
 230       </para>
 231     </sect2>
 232   </sect1>
 233
 234 <!-- ================ Usage ================================ -->
 235   <sect1 id="evince-usage">
 236     <title>Usage</title>
 237
 238     <!-- ================ Usage Subsection ================================ -->
 239     <sect2 id="evince-open-file">
 240       <title>To Open a File</title>
 241       <para>To open a File, perform the following steps:</para>
 242       <orderedlist>
 243         <listitem>
 244           <para>
 245             Choose <menuchoice> <guimenu>File</guimenu><guimenuitem>Open</guimenuitem> </menuchoice>.  </para>
 246         </listitem>
 247         <listitem>
 248           <para>
 249             In the <guilabel>Load file</guilabel> dialog, select the file you want to open.
 250           </para>
 251         </listitem>
 252         <listitem>
 253           <para>
 254             Click <guibutton>Open</guibutton>. &app; displays the name of the document in the titlebar of the window.
 255           </para>
 256         </listitem>
 257       </orderedlist>
 258       <para>
 259         To open another document, choose <menuchoice> <guimenu>File</guimenu><guimenuitem>Open</guimenuitem> </menuchoice> again. &app; opens each file in a new window.
 260       </para>
 261       <para>
 262         If you try to open a document with format that &app; does not recognize, the application displays an error message.
 263       </para>
 264     </sect2>
 265
 266     <sect2 id="evince-navigate-file">
 267     <title>To Navigate Through a Document</title>
 268       <para>You can navigate through a file as follows:</para>
 269       <itemizedlist>
 270         <listitem>
 271           <para>To view the next page, choose <menuchoice> <guimenu>Go</guimenu> <guimenuitem>Next Page</guimenuitem> </menuchoice>.
 272           </para>
 273         </listitem>
 274         <listitem>
 275           <para>To view the previous page, choose <menuchoice> <guimenu>Go</guimenu> <guimenuitem>Previous Page</guimenuitem> </menuchoice>.
 276           </para>
 277         </listitem>
 278         <listitem>
 279           <para>To view the first page in the document, choose <menuchoice> <guimenu>Go</guimenu> <guimenuitem>First Page</guimenuitem> </menuchoice>.
 280           </para>
 281         </listitem>
 282         <listitem>
 283           <para>To view the last page in the document, choose <menuchoice> <guimenu>Go</guimenu> <guimenuitem>Last Page</guimenuitem> </menuchoice>.
 284           </para>
 285         </listitem>
 286         <listitem>
 287           <para>To view a particular page, enter the page number or page label in the text box on the toolbar, then press <keycap>Return</keycap>.</para>
 288         </listitem>
 289       </itemizedlist>
 290     </sect2>
 291
 292     <!-- ================ Usage Subsection ================================ -->
 293     <sect2 id="evince-scroll-page">
 294       <title>To Scroll a Page</title>
 295       <para>To display the page contents that are not currently displayed in the display area, use the following methods:</para>
 296         <itemizedlist>
 297           <listitem>
 298             <para>Use the arrow keys or space key on the keyboard.</para>
 299           </listitem>
 300           <listitem>
 301             <para>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.</para>
 302           </listitem>
 303           <listitem>
 304             <para>Use the scrollbars on the window.</para>
 305           </listitem>
 306       </itemizedlist>
 307     </sect2>
 308
 309     <!-- ================ Usage Subsection ================================ -->
 310          <sect2 id="evince-manipulate-zoom-factor">
 311       <title>To Change the Page Size</title>
 312       <para>
 313         You can use the following methods to resize a page in the &app; display area:
 314       </para>
 315       <itemizedlist>
 316         <listitem>
 317           <para>
 318             To increase the page size, choose <menuchoice> <guimenu>View</guimenu> <guimenuitem>Zoom In</guimenuitem> </menuchoice>.
 319           </para>
 320         </listitem>
 321         <listitem>
 322           <para>
 323             To decrease the page size, choose <menuchoice> <guimenu>View</guimenu> <guimenuitem>Zoom Out</guimenuitem> </menuchoice>.
 324           </para>
 325         </listitem>
 326         <listitem>
 327           <para>
 328             To resize a page to have the same width as the &app; display area, choose <menuchoice> <guimenu>View</guimenu> <guimenuitem>Fit page width</guimenuitem> </menuchoice>.
 329           </para>
 330         </listitem>
 331         <listitem>
 332           <para>
 333             To resize a page to fit within the &app; display area, choose <menuchoice> <guimenu>View</guimenu> <guimenuitem>Best Fit</guimenuitem> </menuchoice>.
 334           </para>
 335         </listitem>
 336         <listitem>
 337           <para>
 338             To resize the &app; window to have the same width and height as the screen, choose <menuchoice> <guimenu>View</guimenu> <guimenuitem>Full Screen</guimenuitem> </menuchoice>. To resize the &app; window to the original size, click on the <guibutton>Exit Full Screen</guibutton> button.
 339           </para>
 340         </listitem>
 341       </itemizedlist>
 342     </sect2>
 343
 344     <sect2 id="evince-view-pages">
 345       <title>To View Pages or Document Structore</title>
 346       <para>To view bookmarks or pages, perform the following steps:
 347       </para>
 348       <orderedlist>
 349         <listitem>
 350           <para>
 351             Choose <menuchoice> <guimenu>View</guimenu> <guimenuitem>Sidebar</guimenuitem> </menuchoice> or press <keycap>F9</keycap>.
 352           </para>
 353         </listitem>
 354         <listitem>
 355           <para>
 356             Use the drop-down list in the side-pane header to select whether to display document structure or pages in the side pane.
 357           </para>
 358         </listitem>
 359         <listitem>
 360           <para>
 361             Use the side-pane scrollbars to display the required item or page in the side pane.
 362           </para>
 363         </listitem>
 364         <listitem>
 365           <para>Click on an entry to navigate to that location in the document. Click on a page to navigate to that page in the document.</para>
 366         </listitem>
 367       </orderedlist>
 368     </sect2>
 369
 370     <sect2 id="evince-view-properties">
 371       <title>To View the Properties of a Document</title>
 372       <para>To view the properties of a document, choose
 373         <menuchoice>
 374           <guimenu>File</guimenu>
 375           <guimenuitem>Properties</guimenuitem>
 376         </menuchoice>.
 377       </para>
 378       <para>
 379         The <guilabel>Properties</guilabel> dialog displays all information available
 380       </para>
 381     </sect2>
 382
 383     <sect2 id="evince-print-file">
 384       <title>To Print a Document</title>
 385       <para>
 386         To print a Document, choose <menuchoice> <guimenu>File</guimenu> <guimenuitem>Print</guimenuitem> </menuchoice>.
 387       </para>
 388       <note>
 389         <para>
 390           If you cannot choose the <guimenuitem>Print</guimenuitem> menu item, the author of the document has disabled the print option for this document. To enable the print option, you must enter the master password when you open the document. See <xref linkend="evince-password"/> for more information about password-protected files.
 391         </para>
 392       </note>
 393       <para>
 394         The <guilabel>Print</guilabel> dialog has the following tabbed sections:
 395       </para>
 396       <itemizedlist>
 397         <listitem>
 398           <para>
 399             <link linkend="print-dialog-job">Job</link>
 400           </para>
 401         </listitem>
 402         <listitem>
 403           <para>
 404             <link linkend="print-dialog-printer">Printer</link>
 405           </para>
 406         </listitem>
 407         <listitem>
 408           <para>
 409             <link linkend="print-dialog-paper">Paper</link>
 410           </para>
 411         </listitem>
 412       </itemizedlist>
 413
 414       <sect3 id="print-dialog-job">
 415       <title>Job</title>
 416         <variablelist>
 417           <varlistentry> <term><guilabel>Print range</guilabel> </term>
 418             <listitem>
 419               <para>Select one of the following options to determine how many pages to print:</para>
 420               <itemizedlist>
 421                 <listitem>
 422                   <para><guilabel>All</guilabel></para>
 423                   <para>Select this option to print all of the pages in the document.</para>
 424                 </listitem>
 425                 <listitem>
 426                   <para><guilabel>Pages From</guilabel></para>
 427                   <para>Select this option to print the selected range of pages in the document. Use the spin boxes to specify the first page and last page of the range.
 428                   </para>
 429                 </listitem>
 430               </itemizedlist>
 431             </listitem>
 432           </varlistentry>
 433         </variablelist>
 434       </sect3>
 435
 436         <sect3 id="print-dialog-printer">
 437         <title>Printer</title>
 438         <variablelist>
 439           <varlistentry> <term><guilabel>Printer</guilabel> </term>
 440             <listitem>
 441               <para>Use this drop-down list to select the printer to which you want to print the document.</para>
 442               <note>
 443               <para>
 444                 The <guilabel>Create a PDF document</guilabel> option is not supported in this version of &app;.
 445               </para>
 446               </note>
 447             </listitem>
 448           </varlistentry>
 449           <varlistentry> <term><guilabel>Settings</guilabel> </term>
 450             <listitem>
 451               <para>Use this drop-down list to select the printer settings.
 452               </para>
 453               <para>To configure the printer, click <guibutton>Configure</guibutton>. For example, you can enable or disable duplex printing, or schedule delayed printing, if this functionality is supported by the printer.
 454               </para>
 455             </listitem>
 456           </varlistentry>
 457           <varlistentry> <term><guilabel>Location</guilabel> </term>
 458             <listitem>
 459               <para>
 460                 Use this drop-down list to select one of the following print destinations:
 461               </para>
 462               <variablelist>
 463                 <varlistentry>
 464                   <term><guilabel>CUPS</guilabel></term>
 465                   <listitem>
 466                     <para>
 467                       Print the document to a CUPS printer.
 468                     </para>
 469                     <note>
 470                       <para>
 471                         If the selected printer is a CUPS printer, <guilabel>CUPS</guilabel> is the only entry in this drop-down list.
 472                       </para>
 473                     </note>
 474                   </listitem>
 475                 </varlistentry>
 476                 <varlistentry>
 477                   <term><guilabel>lpr</guilabel></term>
 478                   <listitem>
 479                     <para>
 480                       Print the document to a printer.
 481                     </para>
 482                   </listitem>
 483                 </varlistentry>
 484                 <varlistentry>
 485                   <term><guilabel>File</guilabel></term>
 486                   <listitem>
 487                     <para>
 488                       Print the document to a PostScript file.
 489                     </para>
 490                     <para>
 491                       Click <guibutton>Save As</guibutton> to display a dialog where you specify the name and location of the PostScript file.
 492                     </para>
 493                   </listitem>
 494                 </varlistentry>
 495                 <varlistentry>
 496                   <term><guilabel>Custom</guilabel></term>
 497                   <listitem>
 498                     <para>
 499                       Use the specified command to print the document.
 500                     </para>
 501                     <para>
 502                       Type the name of the command in the text box. Include all command-line arguments.
 503                     </para>
 504                   </listitem>
 505                 </varlistentry>
 506               </variablelist>
 507             </listitem>
 508           </varlistentry>
 509           <varlistentry> <term><guilabel>State</guilabel> </term>
 510             <listitem>
 511               <para>This functionality is not supported in this version of &app;.
 512               </para>
 513             </listitem>
 514           </varlistentry>
 515           <varlistentry> <term><guilabel>Type</guilabel> </term>
 516             <listitem>
 517               <para>This functionality is not supported in this version of &app;.
 518               </para>
 519             </listitem>
 520           </varlistentry>
 521           <varlistentry> <term><guilabel>Comment</guilabel> </term>
 522             <listitem>
 523               <para>This functionality is not supported in this version of &app;.
 524               </para>
 525             </listitem>
 526           </varlistentry>
 527         </variablelist>
 528         </sect3>
 529
 530         <sect3 id="print-dialog-paper">
 531         <title>Paper</title>
 532         <variablelist>
 533           <varlistentry> <term><guilabel>Paper size</guilabel> </term>
 534             <listitem>
 535               <para>Use this drop-down list to select the size of the paper to which you want to print the document.</para>
 536             </listitem>
 537           </varlistentry>
 538           <varlistentry> <term><guilabel>Width</guilabel> </term>
 539             <listitem>
 540               <para>Use this spin box to specify the width of the paper. Use the adjacent drop-down list to change the measurement unit.</para>
 541             </listitem>
 542           </varlistentry>
 543             <varlistentry> <term><guilabel>Height</guilabel> </term>
 544             <listitem>
 545               <para>Use this spin box to specify the height of the paper.</para>
 546             </listitem>
 547           </varlistentry>
 548           <varlistentry> <term><guilabel>Feed orientation</guilabel> </term>
 549             <listitem>
 550               <para>Use this drop-down list to select the orientation of the paper in the printer.</para>
 551             </listitem>
 552           </varlistentry>
 553           <varlistentry> <term><guilabel>Page orientation</guilabel> </term>
 554             <listitem>
 555               <para>Use this drop-down list to select the page orientation.</para>
 556             </listitem>
 557           </varlistentry>
 558           <varlistentry> <term><guilabel>Layout</guilabel> </term>
 559             <listitem>
 560               <para>Use this drop-down list to select the page layout. A preview of each layout that you select is displayed in the <guilabel>Preview</guilabel> area.</para>
 561             </listitem>
 562           </varlistentry>
 563           <varlistentry> <term><guilabel>Paper Tray</guilabel> </term>
 564             <listitem>
 565               <para>Use this drop-down list to select the paper tray.
 566               </para>
 567             </listitem>
 568           </varlistentry>
 569         </variablelist>
 570       </sect3>
 571     </sect2>
 572
 573     <!-- ================ Usage Subsection ================================ -->
 574     <sect2 id="evince-copy-file">
 575       <title>To Copy a Document</title>
 576       <para>To copy a file, perform the following steps:
 577       </para>
 578       <orderedlist>
 579         <listitem>
 580           <para>
 581             Choose <menuchoice> <guimenu>File</guimenu> <guimenuitem>Save a Copy</guimenuitem> </menuchoice>.
 582           </para>
 583         </listitem>
 584         <listitem>
 585           <para>
 586             Type the new filename in the <guilabel>Filename</guilabel> text box in the <guilabel>Save a Copy</guilabel> dialog.
 587           </para>
 588           <para>
 589             If necessary, specify the location of the copied document. By default, copies are saved in your home directory.
 590           </para>
 591         </listitem>
 592         <listitem>
 593           <para>
 594             Click <guibutton>Save</guibutton>.
 595           </para>
 596         </listitem>
 597       </orderedlist>
 598     </sect2>
 599
 600     <!-- this id must be kept in sync with evince-persist-file.cc/evince-persist-stream.cc -->
 601     <sect2 id="evince-password">
 602       <title>To Work With Password-Protected Documents</title>
 603       <para>
 604         An author can use the following password levels to protect a document:
 605       </para>
 606       <itemizedlist>
 607         <listitem>
 608           <para>User password that allows others only to read the document.
 609           </para>
 610         </listitem>
 611         <listitem>
 612           <para>Master password that allows others to perform additional actions, such as print the document.
 613           </para>
 614         </listitem>
 615       </itemizedlist>
 616       <para>
 617         When you try to open a password-protected document, &app; displays a security dialog. Type either the user password or the master password in the <guilabel>Enter document password</guilabel> text box, then click <guibutton>Open Document</guibutton>.
 618       </para>
 619     </sect2>
 620
 621     <!-- ================ Usage Subsection ================================ -->
 622     <sect2 id="evince-close-file">
 623       <title>To Close a Document</title>
 624       <para>To close a document, choose <menuchoice> <guimenu>File</guimenu> <guimenuitem>Close</guimenuitem> </menuchoice>.
 625       </para>
 626       <para>
 627         If the window is the last &app; window open, the application exits.
 628       </para>
 629       <para>To quit &app; at any time, no matter how many windows are open, choose <menuchoice> <guimenu>File</guimenu> <guimenuitem>Quit</guimenuitem> </menuchoice>. </para>
 630       <note>
 631       <para>When you quit, &app; closes all documents opened in the current session.</para>
 632       </note>
 633     </sect2>
 634
 635   </sect1>
 636
 637 </article>