doc/okular/index.docbook

   1 <?xml version="1.0" ?>
   2 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
   3   <!ENTITY kappname "&okular;">
   4   <!ENTITY package "kdegraphics">
   5   <!ENTITY kpdf "<application>KPDF</application>">
   6   <!ENTITY PDF "<acronym>PDF</acronym>">
   7   <!ENTITY % English "INCLUDE">
   8   <!ENTITY % addindex "IGNORE">
   9 ]>
  10
  11 <book lang="&language;">
  12         <bookinfo>
  13                 <title>The &okular; Handbook</title>
  14                 <authorgroup>
  15                         <author>
  16                                 <firstname>Albert</firstname>
  17                                 <surname>Astals Cid</surname>
  18                                 <affiliation>
  19                                         <address><email>aacid@kde.org</email></address>
  20                                 </affiliation>
  21                         </author>
  22                         <author>
  23                                 <firstname>Pino</firstname>
  24                                 <surname>Toscano</surname>
  25                                 <affiliation>
  26                                         <address><email>pino@kde.org</email></address>
  27                                 </affiliation>
  28                         </author>
  29                         <!-- TRANS:ROLES_OF_TRANSLATORS -->
  30                 </authorgroup>
  31                 <legalnotice>&FDLNotice;</legalnotice>
  32                 <date>2009-01-25</date>
  33                 <releaseinfo>0.8</releaseinfo>
  34                 <!-- Abstract about this handbook -->
  35                 <abstract>
  36                         <para>&okular; is a &kde; universal document viewer based on &kpdf; code.</para>
  37                 </abstract>
  38                 <keywordset>
  39                         <keyword>KDE</keyword>
  40                         <keyword>okular</keyword>
  41                         <keyword>pdf</keyword>
  42                         <keyword>ps</keyword>
  43                         <keyword>postscript</keyword>
  44                         <keyword>tiff</keyword>
  45                         <keyword>djvu</keyword>
  46                         <keyword>dvi</keyword>
  47                         <keyword>chm</keyword>
  48                         <keyword>xps</keyword>
  49                         <keyword>comicbook</keyword>
  50                         <keyword>fictionbook</keyword>
  51                         <keyword>mobipocket</keyword>
  52                         <keyword>plucker</keyword>
  53                         <keyword>annotation</keyword>
  54                 </keywordset>
  55         </bookinfo>
  56         <chapter id="introduction">
  57                 <title>Introduction</title>
  58                 <para>&okular; is a &kde; universal document viewer based on the code of the &kpdf; application.
  59                         Although being based on &kpdf; code, &okular; has some unique features such as overview mode,
  60                         improved presentation support and annotation support.
  61                 </para>
  62 <!--
  63                 <para>
  64                         The PDF format is widely used for publishing documents that are
  65                         mostly not meant to be edited again. &okular; is only a viewer
  66                         for these files and therefore it doesn't provide any functionality
  67                         to edit or create PDF documents.
  68                 </para>
  69 -->
  70         </chapter>
  71         <chapter id="use">
  72                 <title>Basic Usage</title>
  73                 <sect1 id="opening">
  74                         <title>Opening Files</title>
  75                         <para>
  76                                 To view any supported file in &okular;, select <menuchoice><guimenu>File</guimenu><guimenuitem>Open...</guimenuitem>
  77                                 </menuchoice>, choose a supported file in the dialogue and click <guibutton>Open</guibutton>.
  78                                 Your file should now be displayed in the main window.
  79                         </para>
  80                         <para>
  81                                 If you have already opened files in &okular; before, you can quickly access them by selecting them in
  82                                 the <menuchoice><guimenu>File</guimenu><guisubmenu>Open Recent</guisubmenu></menuchoice> menu.
  83                         </para>
  84                         <para>
  85                                 After having a file opened you probably want to read it and therefore navigate through it. Go to the
  86                                 <link linkend="navigating">next section</link> to learn more about this.
  87                         </para>
  88                 </sect1>
  89                 <sect1 id="navigating">
  90                         <title>Navigating</title>
  91                         <para>This section describes how you can navigate through a document in &okular;.</para>
  92                         <para>
  93                                 There are multiple ways of scrolling the viewing area. One is to use the
  94                                 <keycap>Up Arrow</keycap> and <keycap>Down Arrow</keycap> keys. You may also use
  95                                 the scrollbar, your mousewheel or the <keycap>Page Up</keycap> and <keycap>Page Down</keycap>
  96                                 keys.
  97                         </para>
  98                         <para>
  99                                 Another way is to hold the &LMB; down at any place on the document while dragging the mouse in the
 100                                 opposite direction of where you want to move. This procedure only works if the Browse Tool is
 101                                 enabled, which you can select by choosing <menuchoice><guimenu>Tools</guimenu><guimenuitem>Browse Tool
 102                                 </guimenuitem></menuchoice>.
 103                         </para>
 104                         <para>
 105                                 The navigation panel on the left side of the screen enables two more ways of navigating
 106                                 through a document:
 107                         </para>
 108                         <itemizedlist>
 109                                 <listitem>
 110                                         <para>
 111                                                 If you click on a page thumbnail the viewing area will be brought to
 112                                                 that page.
 113                                         </para>
 114                                 </listitem>
 115                                 <listitem>
 116                                         <para>
 117                                                 If the document has a table of contents, clicking on a table
 118                                                 of contents item will bring the document to to the page linked to that
 119                                                 item.
 120                                         </para>
 121                                 </listitem>
 122                         </itemizedlist>
 123                         <para>
 124                                 Some documents have links. In this case you can click on them and the view will
 125                                 change to the page it links to. If the link is to a web page or some
 126                                 other document the default &kde; handler for that format will be invoked.
 127                                 For example, clicking on a link pointing to <quote>http://www.kde.org</quote>
 128                                 will open the web page in the default &kde;'s web browser.
 129                         </para>
 130                         <para>
 131                                 Additionally, you may use the following functionality to quickly move to specific places
 132                                 in the document:
 133                         </para>
 134                         <itemizedlist>
 135                                 <listitem>
 136                                         <para>
 137                                                 You can go to the first page of the document using
 138                                                 <keycombo action="simul">&Ctrl;<keycap>Home</keycap></keycombo> or
 139                                                 using
 140                                                 <menuchoice>
 141                                                         <guimenu>Go</guimenu>
 142                                                         <guimenuitem>First Page</guimenuitem>
 143                                                 </menuchoice>.
 144                                         </para>
 145                                 </listitem>
 146                                 <listitem>
 147                                         <para>
 148                                                 You can go to the last page of the document using
 149                                                 <keycombo action="simul">&Ctrl;<keycap>End</keycap></keycombo> or
 150                                                 using
 151                                                 <menuchoice>
 152                                                         <guimenu>Go</guimenu>
 153                                                         <guimenuitem>Last Page</guimenuitem>
 154                                                 </menuchoice>.
 155                                         </para>
 156                                 </listitem>
 157                                 <listitem>
 158                                         <para>
 159                                                 You can go forward in the document using <keycap>Space</keycap> or <keycap>Page Down</keycap>.
 160                                                 To go to the next page of the document use the <guibutton>Next Page</guibutton> Toolbar
 161                                                 button or
 162                                                 <menuchoice>
 163                                                         <guimenu>Go</guimenu>
 164                                                         <guimenuitem>Next Page</guimenuitem>
 165                                                 </menuchoice> in the menubar.
 166                                         </para>
 167                                 </listitem>
 168                                 <listitem>
 169                                         <para>
 170                                                 You can go back in the document using <keycap>Backspace</keycap> or <keycap>Page Up</keycap>.
 171                                                 To go to the previous page of the document use <guibutton>Previous Page</guibutton> Toolbar
 172                                                 button or
 173                                                 <menuchoice>
 174                                                         <guimenu>Go</guimenu>
 175                                                         <guimenuitem>Previous Page</guimenuitem>
 176                                                 </menuchoice> in the menubar.
 177                                         </para>
 178                                 </listitem>
 179                         </itemizedlist>
 180                 </sect1>
 181                 <sect1 id="presentationMode">
 182                         <title>Presentation Mode</title>
 183                         <para>
 184                                 The Presentation mode represents another way to view documents in &okular;. It can be
 185                                 enabled in
 186                                 <menuchoice><guimenu>View</guimenu><guimenuitem>Presentation</guimenuitem></menuchoice>.
 187                                 It shows the document on a page per page basis. The pages are shown with
 188                                 zoom to page, that means all the page is visible.
 189                         </para>
 190                         <note>
 191                                 <para>
 192                                         &PDF; documents can even specify that they are always opened in presentation mode.
 193                                 </para>
 194                         </note>
 195                         <para>
 196                                 When in presentation mode, you have an helper bar located on the top of the screen. Just move
 197                                 the mouse cursor to the top of the screen to make it appear.
 198                         </para>
 199                         <para>
 200                                 To navigate between
 201                                 pages you may use the &LMB; (next page) and the &RMB; (previous page), the mouse
 202                                 wheel, the arrow icons or the line edit in the top bar,
 203                                 or the keys specified in the <link linkend="navigating">Navigating</link>
 204                                 section.
 205                         </para>
 206                         <para>
 207                                 You can exit presentation mode at any time by pressing the <keycap>ESC</keycap> key or clicking
 208                                 the <guiicon>Quit</guiicon> icon in the top bar.
 209                         </para>
 210                         <para>
 211                                 You can also draw on the current page with a pencil. Click on the
 212                                 <guilabel>Toggle Drawing Mode</guilabel> icon in the top bar to enable or disable the possibility
 213                                 of draw in the presentation mode. The drawings are cleared automatically when switching to
 214                                 another page, or manually selecting the <guilabel>Erase Drawings</guilabel> icon in the top bar.
 215                         </para>
 216                         <para>
 217                                 The presentation mode has support for more than one screen in a multi-monitor configuration.
 218                                 With more than one screen a new button will appear in the top bar, with the icon of a screen:
 219                                 this is a drop down box that allows you to move the presentation to any of the other available screens.
 220                         </para>
 221                         <para>
 222                                 Presentation mode has some configuration options, you can find their
 223                                 description in the chapter <link linkend="configpresentation">Configuring &okular;</link>.
 224                         </para>
 225                 </sect1>
 226         </chapter>
 227
 228         <chapter id="advanced">
 229                 <title>&okular; Advanced Features</title>
 230                 <sect1 id="embedded-files">
 231                         <title>Embedded Files</title>
 232                         <para>
 233                                 If the current document has some files embedded in it, when you open it a yellow bar
 234                                 will appear above the page view to notify you about the embedded files.
 235                         </para>
 236                         <screenshot>
 237                                 <screeninfo>The embedded files bar</screeninfo>
 238                                 <mediaobject>
 239                                         <imageobject>
 240                                                 <imagedata fileref="embedded-files-bar.png" format="PNG" />
 241                                         </imageobject>
 242                                         <textobject>
 243                                                 <phrase>The embedded files bar</phrase>
 244                                         </textobject>
 245                                 </mediaobject>
 246                         </screenshot>
 247                         <para>
 248                                 In this case, you can either click on the link in the text of the bar or choose
 249                                 <menuchoice><guimenu>File</guimenu><guimenuitem>Embedded Files</guimenuitem></menuchoice>
 250                                 to open the embedded files dialog. The dialog allows you to view the embedded files and
 251                                 to extract them.
 252                         </para>
 253                 </sect1>
 254                 <sect1 id="annotations">
 255                         <title>Annotations</title>
 256                         <para>
 257                                 &okular; allows you to review and annotate your documents.
 258                                 Annotations created in &okular; are automatically saved in the internal local data folder
 259                                 for each user.
 260                                 &okular; does not implicitly change any document it opens.
 261                         </para>
 262                         <para>
 263                                 Since &kde; 4.2, &okular; has the "document archiving" feature. This is an &okular;-specific format for carrying the document plus various metadata related to it (currently only annotations). You can save a "document archive" from the open document by choosing <menuchoice><guimenu>File</guimenu><guisubmenu>Export As</guisubmenu><guimenuitem>Document Archive</guimenuitem></menuchoice>. To open an &okular; document archive, just open it with &okular; as it would be &eg; a &PDF; document.
 264                         </para>
 265                                 <note>
 266                                         <para>
 267                                                 Due to DRM limitations (typically with &PDF; documents), adding, editing some properties
 268                                                 or removing annotations could not be possible.
 269                                         </para>
 270                                 </note>
 271                         <sect2 id="annotations-add">
 272                                 <title>Adding annotations</title>
 273                                 <para>
 274                                         To add some annotations to the document, you have to activate the annotating toolbar.
 275                                         This is done by either selecting
 276                                         <menuchoice><guimenu>Tools</guimenu><guimenuitem>Review</guimenuitem></menuchoice> or
 277                                         pressing <keycap>F6</keycap>. Once the annotating toolbar is shown, just press one of
 278                                         its buttons to start constructing that annotation.
 279                                 </para>
 280                                 <note>
 281                                         <para>
 282                                                 The annotating toolbar can be docked in any side of the viewing area: just drag it to
 283                                                 move it to another place.
 284                                         </para>
 285                                 </note>
 286                                 <note>
 287                                         <para>
 288                                                 Activating the annotating toolbar will make you switch to the Normal Mode.
 289                                         </para>
 290                                 </note>
 291                                 <para>
 292                                         You can stop the construction any time by pressing again on the button of the
 293                                         annotation you are constructing, or by pressing the <keycap>ESC</keycap> key.
 294                                 </para>
 295                                 <para>
 296                                         The newly constructed annotation will have as author the author you set in the
 297                                         <guilabel>Identity</guilabel> page in &okular;s
 298                                         <link linkend="configure">configuration</link> dialog.
 299                                 </para>
 300                         </sect2>
 301                         <sect2 id="annotations-remove">
 302                                 <title>Removing annotations</title>
 303                                 <para>
 304                                         To remove an annotation, just click on it with the &RMB;, and select
 305                                         <guimenuitem>Delete</guimenuitem>.
 306                                 </para>
 307                                 <para>
 308                                         When removing the annotation, its window will be closed if open.
 309                                 </para>
 310                                 <note>
 311                                         <para>
 312                                                 This option could not be enabled because the document does not allow removing
 313                                                 annotations.
 314                                         </para>
 315                                 </note>
 316                         </sect2>
 317                         <sect2 id="annotations-edit">
 318                                 <title>Editing annotations</title>
 319                                 <para>
 320                                         To edit an annotation, click on it with the &RMB; and select
 321                                         <guimenuitem>Properties</guimenuitem>. A dialog will appear with the general
 322                                         annotation settings (like color and opacity, author, &etc;) and the settings specific
 323                                         to that annotation type.
 324                                 </para>
 325                                 <para>
 326                                         To move an annotation, hold down the &Ctrl; key, move the mouse pointer on it and
 327                                         then start dragging with the &LMB;.
 328                                 </para>
 329                                 <note>
 330                                         <para>
 331                                                 Depending on the document permissions (typically with &PDF; documents), some options
 332                                                 can be disabled.
 333                                         </para>
 334                                 </note>
 335                         </sect2>
 336                 </sect1>
 337         </chapter>
 338
 339         <chapter id="primary-menu-items">
 340                 <title>The Menubar</title>
 341
 342                 <sect1 id="menufile">
 343                         <title>The <guimenu>File</guimenu> Menu</title>
 344                         <variablelist>
 345                                 <varlistentry>
 346                                         <term>
 347                                                 <menuchoice>
 348                                                         <shortcut>
 349                                                                 <keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
 350                                                         </shortcut>
 351                                                         <guimenu>File</guimenu>
 352                                                         <guimenuitem>Open...</guimenuitem>
 353                                                 </menuchoice>
 354                                         </term>
 355                                         <listitem>
 356                                                 <para>
 357                                                         <action>Open</action> a supported file or okular archive. If there is already an opened file it will be closed. For more information, see the section about <link linkend="opening">Opening Files</link>.
 358                                                 </para>
 359                                         </listitem>
 360                                 </varlistentry>
 361
 362                                 <varlistentry>
 363                                         <term>
 364                                                 <menuchoice>
 365                                                         <guimenu>File</guimenu>
 366                                                         <guisubmenu>Open Recent</guisubmenu>
 367                                                 </menuchoice>
 368                                         </term>
 369                                         <listitem>
 370                                                 <para>
 371                                                         <action>Open</action> a file which was used previously from a
 372                                                         submenu. If a file is currently being displayed it
 373                                                         will be closed. For more information, see the section about
 374                                                         <link linkend="opening">Opening Files</link>.
 375                                                 </para>
 376                                         </listitem>
 377                                 </varlistentry>
 378                                 <!--
 379                                 <varlistentry>
 380                                         <term>
 381                                                 <menuchoice>
 382                                                         <shortcut><keycap>G</keycap></shortcut>
 383                                                         <guimenu>File</guimenu>
 384                                                         <guimenuitem>Get Books From Internet...</guimenuitem>
 385                                                 </menuchoice>
 386                                         </term>
 387                                         <listitem>
 388                                                 <para>to be written</para>
 389                                         </listitem>
 390                                 </varlistentry>
 391                                 <-->
 392                                 <varlistentry>
 393                                         <term>
 394                                                 <menuchoice>
 395                                                         <guimenu>File</guimenu>
 396                                                         <guimenuitem>Import PostScript as &PDF;...</guimenuitem>
 397                                                 </menuchoice>
 398                                         </term>
 399                                         <listitem>
 400                                                 <para>
 401                                                         <action>Open</action> a PostScript file and convert it to &PDF;.
 402                                                 </para>
 403                                         </listitem>
 404                                 </varlistentry>
 405
 406                                 <varlistentry>
 407                                         <term>
 408                                                 <menuchoice>
 409                                                         <guimenu>File</guimenu>
 410                                                         <guimenuitem>Save As...</guimenuitem>
 411                                                 </menuchoice>
 412                                         </term>
 413                                         <listitem>
 414                                                 <para><action>Save</action> the currently open file under a different name using the document backend. With the &PDF; backend (Poppler >= 0.8 required) it is possible to save the document with the changed values of the form fields.</para>
 415                                         </listitem>
 416                                 </varlistentry>
 417
 418                                 <varlistentry>
 419                                         <term>
 420                                                 <menuchoice>
 421                                                         <guimenu>File</guimenu>
 422                                                         <guimenuitem>Save Copy As...</guimenuitem>
 423                                                 </menuchoice>
 424                                         </term>
 425                                         <listitem>
 426                                                 <para><action>Save</action> a copy of the currently open file under a different name
 427                                                 without using the current document backend.</para>
 428                                         </listitem>
 429                                 </varlistentry>
 430
 431                                 <varlistentry>
 432                                         <term>
 433                                                 <menuchoice>
 434                                                         <shortcut><keycap>F5</keycap></shortcut>
 435                                                         <guimenu>File</guimenu>
 436                                                         <guimenuitem>Reload</guimenuitem>
 437                                                 </menuchoice>
 438                                         </term>
 439                                         <listitem>
 440                                                 <para><action>Reload</action> the currently open file.</para>
 441                                         </listitem>
 442                                 </varlistentry>
 443
 444                                 <varlistentry>
 445                                         <term>
 446                                                 <menuchoice>
 447                                                         <shortcut><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></shortcut>
 448                                                         <guimenu>File</guimenu>
 449                                                         <guimenuitem>Print...</guimenuitem>
 450                                                 </menuchoice>
 451                                         </term>
 452                                         <listitem>
 453                                                 <para>
 454                                                         <action>Print</action> the currently displayed document.
 455                                                 </para>
 456                                         </listitem>
 457                                 </varlistentry>
 458
 459                                 <varlistentry>
 460                                         <term>
 461                                                 <menuchoice>
 462                                                         <guimenu>File</guimenu>
 463                                                         <guimenuitem>Print Preview...</guimenuitem>
 464                                                 </menuchoice>
 465                                         </term>
 466                                         <listitem>
 467                                                 <para>
 468                                                         <action>Show a preview</action> of how the currently displayed
 469                                                         document would be printed with the default options.
 470                                                 </para>
 471                                         </listitem>
 472                                 </varlistentry>
 473
 474                                 <varlistentry>
 475                                         <term>
 476                                                 <menuchoice>
 477                                                         <guimenu>File</guimenu>
 478                                                         <guimenuitem>Properties</guimenuitem>
 479                                                 </menuchoice>
 480                                         </term>
 481                                         <listitem>
 482                                                 <para><action>Display some basic information</action> about the document, such as
 483                                                         title, author, creation date, and details about the fonts used. The available information
 484                                                         depends on the type of document.</para>
 485                                         </listitem>
 486                                 </varlistentry>
 487                                 <varlistentry>
 488                                         <term>
 489                                                 <menuchoice>
 490                                                         <guimenu>File</guimenu>
 491                                                         <guimenuitem>Embedded Files...</guimenuitem>
 492                                                 </menuchoice>
 493                                         </term>
 494                                         <listitem>
 495                                                 <para><action>Show the files embedded</action> in the document, if the document has any.
 496                                                         For more information, see the section about the
 497                                                         <link linkend="embedded-files">Embedded Files</link>.</para>
 498                                         </listitem>
 499                                 </varlistentry>
 500
 501                                 <varlistentry>
 502                                         <term>
 503                                                 <menuchoice>
 504                                                         <guimenu>File</guimenu>
 505                                                         <guisubmenu>Export As</guisubmenu>
 506                                                 </menuchoice>
 507                                         </term>
 508                                         <listitem>
 509                                                 <para>This item contains the export formats the current document can be exported to.
 510                                                 The first entry for all kind of documents is always <guimenuitem>Plain Text...</guimenuitem></para>
 511                                                 <para>The second entry is <guimenuitem>Document Archive</guimenuitem>, which allows you to save the document with your annotations into an &okular;-specific archive format. Thus it is easily possible to share the original document and your annotations with other &okular; users or work with them collaboratively.</para>
 512                                         </listitem>
 513                                 </varlistentry>
 514
 515                                 <varlistentry>
 516                                         <term>
 517                                                 <menuchoice>
 518                                                         <shortcut><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></shortcut>
 519                                                         <guimenu>File</guimenu>
 520                                                         <guimenuitem>Quit</guimenuitem>
 521                                                 </menuchoice>
 522                                         </term>
 523                                         <listitem>
 524                                                 <para><action>Close</action> &okular;.</para>
 525                                         </listitem>
 526                                 </varlistentry>
 527                         </variablelist>
 528                 </sect1>
 529
 530                 <sect1 id="menuedit">
 531                         <title>The <guimenu>Edit</guimenu> Menu</title>
 532                         <variablelist>
 533                                 <varlistentry>
 534                                         <term>
 535                                                 <menuchoice>
 536                                                         <shortcut><keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo></shortcut>
 537                                                         <guimenu>Edit</guimenu>
 538                                                         <guimenuitem>Copy</guimenuitem>
 539                                                 </menuchoice>
 540                                         </term>
 541                                         <listitem>
 542                                                 <para><action>Copy</action> the currently selected text in
 543                                                 <guibutton>Text Selection</guibutton> mode to the clipboard.</para>
 544                                         </listitem>
 545                                 </varlistentry>
 546                         </variablelist>
 547
 548                         <variablelist>
 549                                 <varlistentry>
 550                                         <term>
 551                                                 <menuchoice>
 552                                                         <shortcut><keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></shortcut>
 553                                                         <guimenu>Edit</guimenu>
 554                                                         <guimenuitem>Select All</guimenuitem>
 555                                                 </menuchoice>
 556                                         </term>
 557                                         <listitem>
 558                                                 <para><action>Selects</action> all the text (if the document provides it). This works only in
 559                                                 <guibutton>Text Selection</guibutton> mode.</para>
 560                                         </listitem>
 561                                 </varlistentry>
 562                         </variablelist>
 563
 564                         <variablelist>
 565                                 <varlistentry>
 566                                         <term>
 567                                                 <menuchoice>
 568                                                         <shortcut><keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></shortcut>
 569                                                         <guimenu>Edit</guimenu>
 570                                                         <guimenuitem>Find...</guimenuitem>
 571                                                 </menuchoice>
 572                                         </term>
 573                                         <listitem>
 574                                                 <para>
 575                                                         Show the find bar on the bottom of the viewing area that allows you to
 576                                                         <action>search for a string in the document</action>.
 577                                                 </para>
 578                                         </listitem>
 579                                 </varlistentry>
 580
 581                                 <varlistentry>
 582                                         <term>
 583                                                 <menuchoice>
 584                                                         <shortcut><keycap>F3</keycap></shortcut>
 585                                                         <guimenu>Edit</guimenu>
 586                                                         <guimenuitem>Find Next</guimenuitem>
 587                                                 </menuchoice>
 588                                         </term>
 589                                         <listitem>
 590                                                 <para>Try to <action>find the previous searched string again</action> in the document.</para>
 591                                         </listitem>
 592                                 </varlistentry>
 593
 594                                 <varlistentry>
 595                                         <term>
 596                                                 <menuchoice>
 597                                                         <shortcut><keycombo action="simul">&Shift;<keycap>F3</keycap></keycombo></shortcut>
 598                                                         <guimenu>Edit</guimenu>
 599                                                         <guimenuitem>Find Previous</guimenuitem>
 600                                                 </menuchoice>
 601                                         </term>
 602                                         <listitem>
 603                                                 <para><action>Goes to the previous occurrence of the search string</action> in the document.</para>
 604                                         </listitem>
 605                                 </varlistentry>
 606                         </variablelist>
 607                 </sect1>
 608
 609                 <sect1 id="menuview">
 610                         <title>The <guimenu>View</guimenu> Menu</title>
 611                         <variablelist>
 612                                 <varlistentry>
 613                                         <term>
 614                                                 <menuchoice>
 615                                                         <shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>P</keycap></keycombo></shortcut>
 616                                                         <guimenu>View</guimenu>
 617                                                         <guimenuitem>Presentation</guimenuitem>
 618                                                 </menuchoice>
 619                                         </term>
 620                                         <listitem>
 621                                                 <para><action>Activates</action> the Presentation Mode. For more information, see the
 622                                                         section about <link linkend="presentationMode">Presentation Mode</link>.</para>
 623                                         </listitem>
 624                                 </varlistentry>
 625                                 <varlistentry>
 626                                         <term>
 627                                                 <menuchoice>
 628                                                         <shortcut><keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo></shortcut>
 629                                                         <guimenu>View</guimenu>
 630                                                         <guimenuitem>Zoom In</guimenuitem>
 631                                                 </menuchoice>
 632                                         </term>
 633                                         <listitem>
 634                                                 <para><action>Increase the magnification</action> of the document view.</para>
 635                                         </listitem>
 636                                 </varlistentry>
 637
 638                                 <varlistentry>
 639                                         <term>
 640                                                 <menuchoice>
 641                                                         <shortcut><keycombo action="simul">&Ctrl;<keycap>-</keycap></keycombo></shortcut>
 642                                                         <guimenu>View</guimenu>
 643                                                         <guimenuitem>Zoom Out</guimenuitem>
 644                                                 </menuchoice>
 645                                         </term>
 646                                         <listitem>
 647                                                 <para><action>Decrease the magnification</action> of the document view.</para>
 648                                         </listitem>
 649                                 </varlistentry>
 650                                 <varlistentry>
 651                                         <term>
 652                                                 <menuchoice>
 653                                                         <guimenu>View</guimenu>
 654                                                         <guimenuitem>Fit Width</guimenuitem>
 655                                                 </menuchoice>
 656                                         </term>
 657                                         <listitem>
 658                                                 <para><action>Change the magnification</action> of the document
 659                                                         view to a value that makes the pages' width equal to the document
 660                                                         view's width.</para>
 661                                         </listitem>
 662                                 </varlistentry>
 663                                 <varlistentry>
 664                                         <term>
 665                                                 <menuchoice>
 666                                                         <guimenu>View</guimenu>
 667                                                         <guimenuitem>Fit Page</guimenuitem>
 668                                                 </menuchoice>
 669                                         </term>
 670                                         <listitem>
 671                                                 <para><action>Change the magnification</action> of the document view
 672                                                         to a value that makes at least one whole page visible.</para>
 673                                         </listitem>
 674                                 </varlistentry>
 675                                 <varlistentry>
 676                                         <term>
 677                                                 <menuchoice>
 678                                                         <guimenu>View</guimenu>
 679                                                         <guimenuitem>Continuous</guimenuitem>
 680                                                 </menuchoice>
 681                                         </term>
 682                                         <listitem>
 683                                                 <para><action>Enable the continuous page mode</action>. In continuous mode,
 684                                                         all pages of the document are shown, and you can scroll through
 685                                                         them without having to use the <menuchoice><guimenu>Go</guimenu>
 686                                                         <guimenuitem>Previous Page</guimenuitem></menuchoice> and
 687                                                         <menuchoice><guimenu>Go</guimenu><guimenuitem>Next Page</guimenuitem>
 688                                                         </menuchoice> options.</para>
 689                                         </listitem>
 690                                 </varlistentry>
 691                                 <varlistentry>
 692                                         <term>
 693                                                 <menuchoice>
 694                                                         <guimenu>View</guimenu>
 695                                                         <guisubmenu>View Mode</guisubmenu>
 696                                                 </menuchoice>
 697                                         </term>
 698                                         <listitem>
 699                                                 <para>This submenu makes you choose the view mode for the pages. The possible
 700                                                         options are: <guimenuitem>Single Page</guimenuitem> (only one page per row),
 701                                                         <guimenuitem>Facing Pages</guimenuitem> (two pages per row, in a book style) and
 702                                                         <guimenuitem>Overview</guimenuitem> (the number of columns is the one
 703                                                         specified in the <link linkend="configure">&okular; settings</link>).</para>
 704                                         </listitem>
 705                                 </varlistentry>
 706                                 <varlistentry>
 707                                         <term>
 708                                                 <menuchoice>
 709                                                         <guimenu>View</guimenu>
 710                                                         <guisubmenu>Orientation</guisubmenu>
 711                                                 </menuchoice>
 712                                         </term>
 713                                         <listitem>
 714                                                 <para>
 715                                                         This submenu allows you to <action>changes the orientation</action>
 716                                                         of the pages of the document.
 717                                                 </para>
 718                                                 <note>
 719                                                         <para>
 720                                                                 The rotation is applied to the orientation of every page.
 721                                                         </para>
 722                                                 </note>
 723                                                 <para>
 724                                                         You can select <guimenuitem>Original Orientation</guimenuitem> to restore
 725                                                         the orientation of the document, discarding all the rotations applied
 726                                                         manually.
 727                                                 </para>
 728                                         </listitem>
 729                                 </varlistentry>
 730                                 <varlistentry>
 731                                         <term>
 732                                                 <menuchoice>
 733                                                         <guimenu>View</guimenu>
 734                                                         <guisubmenu>Page Size</guisubmenu>
 735                                                 </menuchoice>
 736                                         </term>
 737                                         <listitem>
 738                                                 <para>
 739                                                         <action>Changes the size of the pages</action> of the document.
 740                                                 </para>
 741                                                 <note>
 742                                                         <para>
 743                                                                 This submenu is active only if the current type of document
 744                                                                 supports different page sizes.
 745                                                         </para>
 746                                                 </note>
 747                                         </listitem>
 748                                 </varlistentry>
 749                                 <varlistentry>
 750                                         <term>
 751                                                 <menuchoice>
 752                                                         <guimenu>View</guimenu>
 753                                                         <guimenuitem>Trim Margins</guimenuitem>
 754                                                 </menuchoice>
 755                                         </term>
 756                                         <listitem>
 757                                                 <para>
 758                                                         Remove the white border of pages when viewing pages.
 759                                                 </para>
 760                                         </listitem>
 761                                 </varlistentry>
 762                                 <varlistentry>
 763                                         <term>
 764                                                 <menuchoice>
 765                                                         <guimenu>View</guimenu>
 766                                                         <guimenuitem>Show/Hide Forms</guimenuitem>
 767                                                 </menuchoice>
 768                                         </term>
 769                                         <listitem>
 770                                                 <para>
 771                                                         <action>Show or hides the display</action> of the form fields of the
 772                                                         document.
 773                                                 </para>
 774                                                 <note>
 775                                                         <para>
 776                                                                 This menu item is active only if the current document has form
 777                                                                 fields.
 778                                                         </para>
 779                                                 </note>
 780                                         </listitem>
 781                                 </varlistentry>
 782                         </variablelist>
 783                 </sect1>
 784
 785                 <sect1 id="menugo">
 786                         <title>The <guimenu>Go</guimenu> Menu</title>
 787                         <variablelist>
 788                                 <varlistentry>
 789                                         <term>
 790                                                 <menuchoice>
 791                                                         <shortcut><keycap>Backspace</keycap></shortcut>
 792                                                         <guimenu>Go</guimenu>
 793                                                         <guimenuitem>Previous Page</guimenuitem>
 794                                                 </menuchoice>
 795                                         </term>
 796                                         <listitem>
 797                                                 <para><action>View the previous page</action> of the document.</para>
 798                                         </listitem>
 799                                 </varlistentry>
 800                                 <varlistentry>
 801                                         <term>
 802                                                 <menuchoice>
 803                                                         <shortcut><keycap>Space</keycap></shortcut>
 804                                                         <guimenu>Go</guimenu>
 805                                                         <guimenuitem>Next Page</guimenuitem>
 806                                                 </menuchoice>
 807                                         </term>
 808                                         <listitem>
 809                                                 <para><action>View the next page</action> of the document.</para>
 810                                         </listitem>
 811                                 </varlistentry>
 812                                 <varlistentry>
 813                                         <term>
 814                                                 <menuchoice>
 815                                                         <shortcut><keycombo action="simul">&Ctrl;<keycap>Home</keycap></keycombo></shortcut>
 816                                                         <guimenu>Go</guimenu>
 817                                                         <guimenuitem>First Page</guimenuitem>
 818                                           </menuchoice>
 819                                         </term>
 820                                         <listitem>
 821                                                 <para><action>Go to the first page</action> of the document.</para>
 822                                   </listitem>
 823                                 </varlistentry>
 824                                 <varlistentry>
 825                                         <term>
 826                                                 <menuchoice>
 827                                                         <shortcut><keycombo action="simul">&Ctrl;<keycap>End</keycap></keycombo></shortcut>
 828                                                         <guimenu>Go</guimenu>
 829                                                         <guimenuitem>Last Page</guimenuitem>
 830                                                 </menuchoice>
 831                                         </term>
 832                                         <listitem>
 833                                                 <para><action>Go to the last page</action> of the document.</para>
 834                                         </listitem>
 835                                 </varlistentry>
 836                                 <varlistentry>
 837                                         <term>
 838                                                 <menuchoice>
 839                                                         <guimenu>Go</guimenu>
 840                                                         <guimenuitem>Back in the Document</guimenuitem>
 841                                                 </menuchoice>
 842                                         </term>
 843                                         <listitem>
 844                                                 <para><action>Go back to the previous view</action> of the document.</para>
 845                                         </listitem>
 846                                 </varlistentry>
 847                                 <varlistentry>
 848                                         <term>
 849                                                 <menuchoice>
 850                                                         <guimenu>Go</guimenu>
 851                                                         <guimenuitem>Forward in the Document</guimenuitem>
 852                                                 </menuchoice>
 853                                         </term>
 854                                         <listitem>
 855                                                 <para><action>Move forward to the next view</action> of the document. This only works if you have already moved back before.</para>
 856                                         </listitem>
 857                                 </varlistentry>
 858                                 <varlistentry>
 859                                         <term>
 860                                                 <menuchoice>
 861                                                         <shortcut><keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo></shortcut>
 862                                                         <guimenu>Go</guimenu>
 863                                                         <guimenuitem>Go to Page...</guimenuitem>
 864                                                 </menuchoice>
 865                                         </term>
 866                                         <listitem>
 867                                                 <para>Open a dialog which allows you to <action>go to any page</action> of the document.</para>
 868                                         </listitem>
 869                                 </varlistentry>
 870                         </variablelist>
 871                 </sect1>
 872
 873                 <sect1 id="menubookmarks">
 874                         <title>The <guimenu>Bookmarks</guimenu> Menu</title>
 875                         <variablelist>
 876                                 <varlistentry>
 877                                         <term>
 878                                                 <menuchoice>
 879                                                         <shortcut><keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo></shortcut>
 880                                                         <guimenu>Bookmarks</guimenu>
 881                                                         <guimenuitem>Add/Remove Bookmark</guimenuitem>
 882                                                 </menuchoice>
 883                                         </term>
 884                                         <listitem>
 885                                                 <para>
 886                                                         <action>Add or remove a bookmark for the current page</action>.
 887                                                 </para>
 888                                         </listitem>
 889                                 </varlistentry>
 890                                 <varlistentry>
 891                                         <term>
 892                                                 <menuchoice>
 893                                                         <guimenu>Bookmarks</guimenu>
 894                                                         <guimenuitem>Previous Bookmark</guimenuitem>
 895                                                 </menuchoice>
 896                                         </term>
 897                                         <listitem>
 898                                                 <para><action>Go to the previous bookmarked page</action>, or do nothing if there
 899                                                         are no bookmarked pages prior to the current one.</para>
 900                                         </listitem>
 901                                 </varlistentry>
 902                                 <varlistentry>
 903                                         <term>
 904                                                 <menuchoice>
 905                                                         <guimenu>Bookmarks</guimenu>
 906                                                         <guimenuitem>Next Bookmark</guimenuitem>
 907                                                 </menuchoice>
 908                                         </term>
 909                                         <listitem>
 910                                                 <para><action>Go to the next bookmarked page</action>, or do nothing if there
 911                                                         are no bookmarked pages after the current one.</para>
 912                                         </listitem>
 913                                 </varlistentry>
 914                                 <varlistentry>
 915                                         <term>
 916                                                 <menuchoice>
 917                                                         <guimenu>Bookmarks</guimenu>
 918                                                         <guimenuitem>No Bookmarks</guimenuitem>
 919                                                 </menuchoice>
 920                                         </term>
 921                                         <listitem>
 922                                                 <para>This is an always disabled action that appears in this menu only if the current document has
 923                                                 no bookmarks. Otherwise a list of all bookmarked pages is displayed here. Clicking on these bookmarks
 924                                                 allows you to go directly to the associated pages.</para>
 925                                         </listitem>
 926                                 </varlistentry>
 927                         </variablelist>
 928                 </sect1>
 929
 930                 <sect1 id="menutools">
 931                         <title>The <guimenu>Tools</guimenu> Menu</title>
 932                         <variablelist>
 933                                 <varlistentry>
 934                                         <term>
 935                                                 <menuchoice>
 936                                                         <shortcut><keycombo action="simul">&Ctrl;<keycap>1</keycap></keycombo></shortcut>
 937                                                         <guimenu>Tools</guimenu>
 938                                                         <guimenuitem>Browse Tool</guimenuitem>
 939                                                 </menuchoice>
 940                                         </term>
 941                                         <listitem>
 942                                                 <para>The mouse will have its normal behaviour, &LMB; for dragging the document and following links and &RMB; for adding bookmarks and fit to width.</para>
 943                                         </listitem>
 944                                 </varlistentry>
 945                                 <varlistentry>
 946                                         <term>
 947                                                 <menuchoice>
 948                                                         <shortcut><keycombo action="simul">&Ctrl;<keycap>2</keycap></keycombo></shortcut>
 949                                                         <guimenu>Tools</guimenu>
 950                                                         <guimenuitem>Zoom Tool</guimenuitem>
 951                                                 </menuchoice>
 952                                         </term>
 953                                         <listitem>
 954                                                 <para>The mouse will work as a zoom tool. Clicking &LMB; and dragging will zoom the view to the selected area, clicking &RMB; will bring the document back to the previous zoom.</para>
 955                                         </listitem>
 956                                 </varlistentry>
 957                                 <varlistentry>
 958                                         <term>
 959                                                 <menuchoice>
 960                                                         <shortcut><keycombo action="simul">&Ctrl;<keycap>3</keycap></keycombo></shortcut>
 961                                                         <guimenu>Tools</guimenu>
 962                                                         <guimenuitem>Selection Tool</guimenuitem>
 963                                                 </menuchoice>
 964                                         </term>
 965                                         <listitem>
 966                                                 <para>The mouse will work as a select tool. In that mode clicking &LMB; and dragging will give the option of copying the text/image of current selected area to the clipboard, speak a text or to save an image to a file.</para>
 967                                         </listitem>
 968                                 </varlistentry>
 969                                 <varlistentry>
 970                                         <term>
 971                                                 <menuchoice>
 972                                                         <shortcut><keycombo action="simul">&Ctrl;<keycap>4</keycap></keycombo></shortcut>
 973                                                         <guimenu>Tools</guimenu>
 974                                                         <guimenuitem>Text Selection Tool</guimenuitem>
 975                                                 </menuchoice>
 976                                         </term>
 977                                         <listitem>
 978                                                 <para>The mouse will work as a text selection tool. In that mode clicking &LMB; and
 979                                                         dragging will give the option of selecting the text of the document. Then, just
 980                                                         click with the &RMB; to copy to the clipboard or speak the current selection.</para>
 981                                         </listitem>
 982                                 </varlistentry>
 983                                 <varlistentry>
 984                                         <term>
 985                                                 <menuchoice>
 986                                                         <shortcut><keycap>F6</keycap></shortcut>
 987                                                         <guimenu>Tools</guimenu>
 988                                                         <guimenuitem>Review</guimenuitem>
 989                                                 </menuchoice>
 990                                         </term>
 991                                         <listitem>
 992                                                 <para><action>Open the review toolbar</action>. The review toolbar allows you to add
 993                                                         annotations on the document you are reading. For more information, please see the
 994                                                         section about <link linkend="annotations">Annotations</link>.</para>
 995                                         </listitem>
 996                                 </varlistentry>
 997                                 <varlistentry>
 998                                         <term>
 999                                                 <menuchoice>
1000                                                         <guimenu>Tools</guimenu>
1001                                                         <guimenuitem>Speak Whole Document</guimenuitem>
1002                                                 </menuchoice>
1003                                         </term>
1004                                         <term>
1005                                                 <menuchoice>
1006                                                         <guimenu>Tools</guimenu>
1007                                                         <guimenuitem>Speak Current Page</guimenuitem>
1008                                                 </menuchoice>
1009                                         </term>
1010                                         <term>
1011                                                 <menuchoice>
1012                                                         <guimenu>Tools</guimenu>
1013                                                         <guimenuitem>Stop Speaking</guimenuitem>
1014                                                 </menuchoice>
1015                                         </term>
1016                                         <listitem>
1017                                                 <para>These items allow you to speak the whole document or just the current page and stop speaking using the &kde; Text-to-Speech system <application>KTTS</application>.</para>
1018                                                 <para>The <guilabel>Speak ...</guilabel> actions are enabled only if <application>KTTS</application> is available in the system.</para>
1019                                         </listitem>
1020                                 </varlistentry>
1021                         </variablelist>
1022                 </sect1>
1023
1024                 <sect1 id="settings-menu">
1025                         <title>The <guimenu>Settings</guimenu> Menu</title>
1026                         <variablelist>
1027                                 <varlistentry>
1028                                         <term>
1029                                                 <menuchoice>
1030                                                         <shortcut><keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo></shortcut>
1031                                                         <guimenu>Settings</guimenu>
1032                                                         <guimenuitem>Show Menubar</guimenuitem>
1033                                                 </menuchoice>
1034                                         </term>
1035                                         <listitem>
1036                                                 <para><action>Toggle the Menubar display</action> on and off. Once
1037                                                 hidden it can be made visible using the shortcut
1038                                                 <keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo> again.</para>
1039                                         </listitem>
1040                                 </varlistentry>
1041                                 <varlistentry>
1042                                         <term>
1043                                                 <menuchoice>
1044                                                         <guimenu>Settings</guimenu>
1045                                                         <guimenuitem>Show Toolbar</guimenuitem>
1046                                                 </menuchoice>
1047                                         </term>
1048                                         <listitem>
1049                                                 <para><action>Toggle the Toolbar display</action> on and off.</para>
1050                                         </listitem>
1051                                 </varlistentry>
1052                                 <varlistentry>
1053                                         <term>
1054                                                 <menuchoice>
1055                                                         <shortcut><keycap>F7</keycap></shortcut>
1056                                                         <guimenu>Settings</guimenu>
1057                                                         <guimenuitem>Show Navigation Panel</guimenuitem>
1058                                                 </menuchoice>
1059                                         </term>
1060                                         <listitem>
1061                                                 <para><action>Toggle the navigation panel</action> on and off.</para>
1062                                         </listitem>
1063                                 </varlistentry>
1064                                 <varlistentry>
1065                                         <term>
1066                                                 <menuchoice>
1067                                                         <shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo></shortcut>
1068                                                         <guimenu>Settings</guimenu>
1069                                                         <guimenuitem>Full Screen Mode</guimenuitem>
1070                                                 </menuchoice>
1071                                         </term>
1072                                         <listitem>
1073                                                 <para><action>Enables the full screen mode</action>. Note that
1074                                                         full screen mode is different from <link
1075                                                                 linkend="presentationMode">presentation mode</link> insofar as the
1076                                                         only peculiarity of full screen mode is that it hides the window
1077                                                         decorations, the menubar and the toolbar.</para>
1078                                         </listitem>
1079                                 </varlistentry>
1080                                 <varlistentry>
1081                                         <term>
1082                                                 <menuchoice>
1083                                                         <guimenu>Settings</guimenu>
1084                                                         <guimenuitem>Configure Shortcuts...</guimenuitem>
1085                                                 </menuchoice>
1086                                         </term>
1087                                         <listitem>
1088                                                 <para>Opens a window that lets you <action>configure the keyboard
1089                                                         shortcuts</action> for many menu commands.</para>
1090                                         </listitem>
1091                                 </varlistentry>
1092                                 <varlistentry>
1093                                         <term>
1094                                                 <menuchoice>
1095                                                         <guimenu>Settings</guimenu>
1096                                                         <guimenuitem>Configure Toolbars...</guimenuitem>
1097                                                 </menuchoice>
1098                                         </term>
1099                                         <listitem>
1100                                                 <para>Opens a window that lets you choose which icons are visible
1101                                                         in the toolbar.</para>
1102                                         </listitem>
1103                                 </varlistentry>
1104                                 <varlistentry>
1105                                         <term>
1106                                                 <menuchoice>
1107                                                         <guimenu>Settings</guimenu>
1108                                                         <guimenuitem>Configure Backends...</guimenuitem>
1109                                                 </menuchoice>
1110                                         </term>
1111                                         <listitem>
1112                                                 <para>Opens the <link linkend="configure">Backend Configuration</link>
1113                                                         window.</para>
1114                                         </listitem>
1115                                 </varlistentry>
1116                                 <varlistentry>
1117                                         <term>
1118                                                 <menuchoice>
1119                                                         <guimenu>Settings</guimenu>
1120                                                         <guimenuitem>Configure &okular;...</guimenuitem>
1121                                                 </menuchoice>
1122                                         </term>
1123                                         <listitem>
1124                                                 <para>Opens the <link linkend="configure">Configure</link>
1125                                                         window.</para>
1126                                         </listitem>
1127                                 </varlistentry>
1128
1129                         </variablelist>
1130                 </sect1>
1131                 <sect1 id="menuhelp">
1132                         <title>The <guimenu>Help</guimenu> Menu</title>
1133                         &help.menu.documentation;
1134                 </sect1>
1135
1136         </chapter>
1137         <chapter id="configure">
1138                 <title>Configuring &okular;</title>
1139                 <sect1 id="configindex">
1140                         <title>General configuration</title>
1141                         <para>
1142                                 You can configure &okular; by choosing <menuchoice><guimenu>Settings</guimenu>
1143                                 <guimenuitem>Configure &okular;...</guimenuitem></menuchoice>.
1144                                 The configuration dialogue is split into five sections. This chapter describes the available
1145                                 options in detail.
1146                         </para>
1147                         <itemizedlist>
1148                                 <listitem>
1149                                         <para><link linkend="configgeneral">General</link></para>
1150                                 </listitem>
1151                                 <listitem>
1152                                         <para><link linkend="configaccessibility">Accessibility</link></para>
1153                                 </listitem>
1154                                 <listitem>
1155                                         <para><link linkend="configperformance">Performance</link></para>
1156                                 </listitem>
1157                                 <listitem>
1158                                         <para><link linkend="configpresentation">Presentation</link></para>
1159                                 </listitem>
1160                                 <listitem>
1161                                         <para><link linkend="configidentity">Identity</link></para>
1162                                 </listitem>
1163                         </itemizedlist>
1164                         <screenshot>
1165                                 <screeninfo>The configuration dialogue</screeninfo>
1166                                 <mediaobject>
1167                                         <imageobject>
1168                                                 <imagedata fileref="configure.png" format="PNG" />
1169                                         </imageobject>
1170                                         <textobject>
1171                                                 <phrase>The configuration dialogue</phrase>
1172                                         </textobject>
1173                                 </mediaobject>
1174                         </screenshot>
1175                         <para>
1176                                 Depending on the currently installed backends, the <menuchoice><guimenu>Settings</guimenu>
1177                                 <guimenuitem>Configure Backends...</guimenuitem></menuchoice> menu item could be enabled.
1178                                 This particular configuration dialogue holds the configurations of the backends that can
1179                                 actually be configured.
1180                         </para>
1181                 </sect1>
1182                 <sect1 id="configgeneral">
1183                         <title>General</title>
1184                         <variablelist>
1185                                 <varlistentry>
1186                                         <term><guilabel>Show scrollbars</guilabel></term>
1187                                         <listitem>
1188                                                 <para>Whether to show scrollbars for the document view.</para>
1189                                         </listitem>
1190                                 </varlistentry>
1191                                 <varlistentry>
1192                                         <term><guilabel>Link the thumbnails with the page</guilabel></term>
1193                                         <listitem>
1194                                                 <para>Whether the thumbnails view should always display the current
1195                                                         page or not.</para>
1196                                         </listitem>
1197                                 </varlistentry>
1198                                 <varlistentry>
1199                                         <term><guilabel>Show hints and info messages</guilabel></term>
1200                                         <listitem>
1201                                                 <para>Whether to show some informative messages on startup, file
1202                                                         load, &etc;.</para>
1203                                         </listitem>
1204                                 </varlistentry>
1205                                 <varlistentry>
1206                                         <term><guilabel>Obey DRM limitations</guilabel></term>
1207                                         <listitem>
1208                                                 <para>Whether &okular; should obey <firstterm>DRM</firstterm>
1209                                                         (Digital Rights Management) restrictions. DRM limitations are used
1210                                                         to make it impossible to perform certain actions with &PDF; documents,
1211                                                         such as copying content to the clipboard. Note that in some configurations
1212                                                         of &okular;, this option is not available.</para>
1213                                         </listitem>
1214                                 </varlistentry>
1215                                 <varlistentry>
1216                                         <term><guilabel>Reload document on file change</guilabel></term>
1217                                         <listitem>
1218                                                 <para>Whether opened files should be automatically checked for
1219                                                         changes and updated, if necessary.</para>
1220                                         </listitem>
1221                                 </varlistentry>
1222                                 <varlistentry>
1223                                         <term><guilabel>Show backend selection dialog</guilabel></term>
1224                                         <listitem>
1225                                                 <para>Whether &okular; should ask the user which backend to use in case of more
1226                                                         than one backend able to open the current file. If unchecked, &okular; will
1227                                                         use the backend with the highest priority.</para>
1228                                         </listitem>
1229                                 </varlistentry>
1230                                 <varlistentry>
1231                                         <term><guilabel>Center first page</guilabel></term>
1232                                         <listitem>
1233                                                 <para>Whether the first page should be centered or aligned to the left when
1234                                                         displaying the pages in facing and overview mode.</para>
1235                                         </listitem>
1236                                 </varlistentry>
1237                                 <varlistentry>
1238                                         <term><guilabel>Overview columns</guilabel></term>
1239                                         <listitem>
1240                                                 <para>
1241                                                         This options represent the number of columns to use in the overview mode.
1242                                                 </para>
1243                                         </listitem>
1244                                 </varlistentry>
1245                         </variablelist>
1246                 </sect1>
1247                 <sect1 id="configaccessibility">
1248                         <title>Accessibility</title>
1249                         <variablelist>
1250                                 <varlistentry>
1251                                         <term><guilabel>Draw border around links</guilabel></term>
1252                                         <listitem>
1253                                                 <para>Whether to draw a border around links.</para>
1254                                         </listitem>
1255                                 </varlistentry>
1256                                 <varlistentry>
1257                                         <term><guilabel>Change colors</guilabel></term>
1258                                         <listitem>
1259                                                 <para><action>Enables</action> the color changing options.</para>
1260                                         </listitem>
1261                                 </varlistentry>
1262                                 <varlistentry>
1263                                         <term><guilabel>Invert Colors</guilabel></term>
1264                                         <listitem>
1265                                                 <para><action>Inverts</action> colors on the view, &ie; black objects will be shown white.</para>
1266                                         </listitem>
1267                                 </varlistentry>
1268                                 <varlistentry>
1269                                         <term><guilabel>Change Paper Color</guilabel></term>
1270                                         <listitem>
1271                                                 <para><action>Changes</action> the paper's color, &ie; the document's background.</para>
1272                                         </listitem>
1273                                 </varlistentry>
1274                                 <varlistentry>
1275                                         <term><guilabel>Change Dark &amp; Light Colors</guilabel></term>
1276                                         <listitem>
1277                                                 <para><action>Changes</action> the dark and light color to your preference, that means
1278                                                         black will not be rendered as black but as the selected dark color and white
1279                                                         will not be rendered as white but as the selected light color.</para>
1280                                         </listitem>
1281                                 </varlistentry>
1282                                 <varlistentry>
1283                                         <term><guilabel>Convert to Black &amp; White</guilabel></term>
1284                                         <listitem>
1285                                                 <para><action>Converts</action> the document to black and white. You can set the
1286                                                         threshold and the contrast. Setting the threshold to a higher value
1287                                                         will result in darker grays used.</para>
1288                                         </listitem>
1289                                 </varlistentry>
1290                         </variablelist>
1291                 </sect1>
1292                 <sect1 id="configperformance">
1293                         <title>Performance</title>
1294                         <variablelist>
1295                                 <varlistentry>
1296                                         <term><guilabel>Enable transparency effects</guilabel></term>
1297                                         <listitem>
1298                                                 <para>Draw selections and other special graphics using
1299                                                         transparency effects. Disable the option to draw them using
1300                                                         outline or opaque fill styles and increase speed on selections.</para>
1301                                         </listitem>
1302                                 </varlistentry>
1303                                 <varlistentry>
1304                                         <term><guilabel>Enable background generation</guilabel></term>
1305                                         <listitem>
1306                                                 <para>Use a background thread to generate the pages. By disabling
1307                                                         this option the user interface will become less reactive (will be blocked
1308                                                         if necessary), but pages will be displayed a bit faster.</para>
1309                                         </listitem>
1310                                 </varlistentry>
1311                                 <varlistentry>
1312                                         <term><guilabel>Memory Usage</guilabel></term>
1313                                         <listitem>
1314                                                 <para>&okular; can achieve best performance by tuning the memory usage, based on your system and your tastes.
1315                                                         The more memory you let it to use, the faster the program will behave. The Default profile is good
1316                                                         for every system, but you can prevent &okular; from using more memory than necessary by selecting the Low
1317                                                         profile, or let it get the most out of your system using Aggressive.</para>
1318                                         </listitem>
1319                                 </varlistentry>
1320                         </variablelist>
1321                 </sect1>
1322                 <sect1 id="configpresentation">
1323                         <title>Presentation</title>
1324                         <variablelist>
1325                                 <varlistentry>
1326                                         <term><guilabel>Advance every</guilabel></term>
1327                                         <listitem>
1328                                                 <para>Enables automatic advancing of pages given a time period.</para>
1329                                         </listitem>
1330                                 </varlistentry>
1331                                 <varlistentry>
1332                                         <term><guilabel>Loop after last page</guilabel></term>
1333                                         <listitem>
1334                                                 <para>When navigating on presentation mode and going past the last page the first page will appear.</para>
1335                                         </listitem>
1336                                 </varlistentry>
1337                                 <varlistentry>
1338                                         <term><guilabel>Background color</guilabel></term>
1339                                         <listitem>
1340                                                 <para>The color that will fill the part of the screen not covered by the page when on presentation mode.</para>
1341                                         </listitem>
1342                                 </varlistentry>
1343                                 <varlistentry>
1344                                         <term><guilabel>Pencil color</guilabel></term>
1345                                         <listitem>
1346                                                 <para>The color of the pencil used when drawing on the pages during the presentation mode.</para>
1347                                         </listitem>
1348                                 </varlistentry>
1349                                 <varlistentry>
1350                                         <term><guilabel>Mouse cursor</guilabel></term>
1351                                         <listitem>
1352                                                 <para>Whether the mouse should be always hidden, always shown or hidden after a small time of inactivity.</para>
1353                                         </listitem>
1354                                 </varlistentry>
1355                                 <varlistentry>
1356                                         <term><guilabel>Show progress indicator</guilabel></term>
1357                                         <listitem>
1358                                                 <para>Whether to show a progress circle that shows the current page and the total number of pages on the upper
1359                                                         right corner of the presentation screen every time you change the page.</para>
1360                                         </listitem>
1361                                 </varlistentry>
1362                                 <varlistentry>
1363                                         <term><guilabel>Show summary page</guilabel></term>
1364                                         <listitem>
1365                                                 <para>Whether to show a summary page at the beginning of the presentation with the title, author and number of pages of the document.</para>
1366                                         </listitem>
1367                                 </varlistentry>
1368                                 <varlistentry>
1369                                         <term><guilabel>Default transition</guilabel></term>
1370                                         <listitem>
1371                                                 <para>The transition effect between page and page if the document does not specify one. Set this to <guilabel>Random
1372                                                         Transition</guilabel> to make &okular; randomly choose one of the available effects.</para>
1373                                         </listitem>
1374                                 </varlistentry>
1375                                 <varlistentry>
1376                                         <term><guilabel>Placement</guilabel></term>
1377                                         <listitem>
1378                                                 <para>In this section you can select the <guilabel>Screen</guilabel> used to display the presentation.</para>
1379                                                 <para><guilabel>Current Screen</guilabel> is same screen of the &okular; window that starts the presentation mode.</para>
1380                                                 <para><guilabel>Default Screen</guilabel> is the screen marked as default in the xinerama configuration.</para>
1381                                                 <para><guilabel>Screen 0</guilabel>, <guilabel>Screen 1</guilabel> &etc; are the available screens.</para>
1382                                         </listitem>
1383                                 </varlistentry>
1384                         </variablelist>
1385                 </sect1>
1386                 <sect1 id="configidentity">
1387                         <title>Identity</title>
1388                         <variablelist>
1389                                 <varlistentry>
1390                                         <term><guilabel>Author</guilabel></term>
1391                                         <listitem>
1392                                                 <para>The author of the contents added on a document.</para>
1393                                         </listitem>
1394                                 </varlistentry>
1395                         </variablelist>
1396                 </sect1>
1397                 <sect1 id="configeditor">
1398                         <title>Editor</title>
1399                         <variablelist>
1400                                 <varlistentry>
1401                                         <term><guilabel>Editor</guilabel></term>
1402                                         <listitem>
1403                                                 <para>Choose the editor you want to launch when &okular; wants to open a source file.
1404                                                 This is the case when the document has references to the various points (usually row and column number) of sources it was generated from. The &DVI; format supports natively the addition of the information about the sources the LaTeX document was generated from. A similar system exists for &PDF; documents, called <acronym>pdfsync</acronym>, which stores these extra information in an external file named after the &PDF; file itself (for example <filename>mydocument.pdfsync</filename> for <filename>mydocument.pdf</filename>).
1405                                                 </para>
1406                                         </listitem>
1407                                 </varlistentry>
1408                                 <varlistentry>
1409                                         <term><guilabel>Command</guilabel></term>
1410                                         <listitem>
1411                                                 <para>This is the command and its parameters to invoke the selected editor with the source file of the actual document.</para>
1412                                         </listitem>
1413                                 </varlistentry>
1414                         </variablelist>
1415                 </sect1>
1416         </chapter>
1417         <chapter id="credits">
1418                 <title>Credits and License</title>
1419
1420                 <itemizedlist>
1421                         <title>Program Copyright:</title>
1422                         <listitem><para>Albert Astals Cid<email>aacid@kde.org</email> </para></listitem>
1423                         <listitem><para>Pino Toscano <email>pino@kde.org</email> Current maintainer</para></listitem>
1424                         <listitem><para>Enrico Ros<email>eros.kde@email.it</email> &kpdf; developer</para></listitem>
1425                 </itemizedlist>
1426
1427                 <itemizedlist>
1428                         <title>Documentation Copyright:</title>
1429                         <listitem><para>Albert Astals Cid<email>aacid@kde.org</email> Author</para></listitem>
1430                         <listitem><para>Titus Laska<email>titus.laska@gmx.de</email> Some updates and additions</para></listitem>
1431                         <listitem><para>Pino Toscano <email>pino@kde.org</email></para></listitem>
1432                 </itemizedlist>
1433                 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
1434                 &underFDL;
1435                 &underGPL;
1436         </chapter>
1437
1438         <appendix id="installation">
1439                 <title>Installation</title>
1440                 <sect1 id="getting-kapp">
1441                         <title>How to obtain &okular;</title>
1442                         &install.intro.documentation;
1443                 </sect1>
1444                 <sect1 id="compilation">
1445                         <title>Compilation and Installation</title>
1446                         <note>
1447                                 <para>
1448                                         If you are reading this help in the &khelpcenter;, &okular; has already been
1449                                         installed on this system and you do not need install it anymore.
1450                                 </para>
1451                         </note>
1452                         &install.compile.documentation;
1453                 </sect1>
1454         </appendix>
1455         &documentation.index;
1456 </book>
1457
1458
1459 <!--
1460 Local Variables:
1461 mode: sgml
1462 sgml-minimize-attributes:nil
1463 sgml-general-insert-case:lower
1464 sgml-indent-step:0
1465 sgml-indent-data:nil
1466 End:
1467
1468 // vim:ts=2:sw=2:tw=78:noet
1469 -->