diff --git a/doc/index.docbook b/doc/index.docbook index 7da3ab5fb..5dc1c1770 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -1,21 +1,22 @@ KPDF"> - + okular"> + + KPDF"> ]> - The &kpdf; Handbook + The &okular; Handbook Albert Astals Cid -
tsdgeos@yahoo.es
+
aacid@kde.org
 @@ -25,55 +26,68 @@
titus.laska@gmx.de
 + + Pino + Toscano + +
pino@kde.org
+ + &FDLNotice; - 2006-05-20 - 0.5 + 2006-10-16 + 0.5.81 - &kpdf; is a &kde; PDF viewer based on xpdf code. + &okular; is a &kde; universal document viewer based on &kpdf; code. KDE - kpdf + okular pdf + ps + tiff + djvu + dvi Introduction - &kpdf; is a &kde; PDF (Portable Document Format) viewer - based on the code of the xpdf application. Although being based on xpdf code, &kpdf; - has some unique features such as continuous mode and presentation support. + &okular; is a &kde; univeral document viewer based on the code of the &kpdf; application. + Although being based on &kpdf; code, &okular; has some unique features such as overview mode, + improved presentation support and annotation support. + - Using &kpdf; + Using &okular; Opening Files - To view a PDF file in &kpdf;, select FileOpen... - , choose a PDF or PS file in the dialogue and click Open. + To view any supported file in &okular;, select FileOpen... + , choose a supported file in the dialogue and click Open. Your file should now be displayed in the main window. - If you have already opened files in &kpdf; before, you can quickly access them by selecting them in + If you have already opened files in &okular; before, you can quickly access them by selecting them in the FileOpen Recent menu. - After having a file opened you probably want to read it and therefore navigate through it. Click - Next to learn more about this. + After having a file opened you probably want to read it and therefore navigate through it. Go to the + next section to learn more about this. Navigating - This section describes how you can navigate through a document in &kpdf;. + This section describes how you can navigate through a document in &okular;. There are multiple ways of scrolling the viewing area. One is to use the Up Arrow and Down Arrow keys. You may also use @@ -107,7 +121,7 @@ Some documents have links. In this case you can click on them and the view will - change to the page it links to. If the link is to a web page the default + change to the page it links to. If the link is to a web page the default &kde; browser will be invoked. @@ -164,7 +178,7 @@ Presentation Mode - The Presentation mode represents another way to view PDF documents in &kpdf;. It can be + The Presentation mode represents another way to view documents in &okular;. It can be enabled in ViewPresentation. It shows the document on a page per page basis. The pages are shown with @@ -175,21 +189,24 @@ PDF documents can even specify that they are always opened in presentation mode. + + When in presentation mode, you have an helper bar located on the top of the screen. Just move + the mouse cursor to the top of the screen to make it appear. + To navigate between pages you may use the &LMB; (next page) and the &RMB; (previous page), the mouse - wheel, the arrow icons that appear as soon as you move the mouse cursor to the top of the screen, + wheel, the arrow icons or the line edit in the top bar, or the keys specified in the Navigating - section. + section. You can exit presentation mode at any time by pressing the ESC key or clicking - the Quit icon appearing if you move the mouse cursor to the top of the - screen. + the Quit icon in the top bar. Presentation mode has some configuration options, you can find their - description at Configuring &kpdf;. + description at Configuring &okular;. @@ -212,7 +229,7 @@ - Open a PDF or PS file. If there is already an opened file it will be closed. + Open a supported file. If there is already an opened file it will be closed. For more information, see the section about Opening Files. @@ -286,7 +303,8 @@ Display some basic information about the document, such as - title, author, creation date, and details about the fonts used. + title, author, creation date, and details about the fonts used. The available information + depends on the type of document. @@ -299,7 +317,7 @@ - Close &kpdf;. + Close &okular;. @@ -423,12 +441,43 @@ View - Two Pages + Render Mode - Enable the two page mode, which shows two pages of - the document next to each other.. + This submenu makes you choose the view mode for the pages. The possible + options are: Single (only one page per row), + Facing (two pages per row, in a book style) and + Overview (the number of columns is the one + specified in the &okular; settings). + + + + + + View + Orientation + + + + Changes the orientation of the pages of the + document. + The rotation is applied to the orientation of every + page. + + + + + + View + Paper sizes + + + + Changes the size of the paper fo the pages of the + document. + This submenu is active only if the current type of document + supports different paper sizes. @@ -509,6 +558,32 @@ Move forward to the next view of the document. This only works if you have already moved back before. + + + + &Alt; Left + Go + Previous Bookmark + + + + Go to the previous bookmarked page, or do nothing if there + are no bookmarked pages prior to the current one. + + + + + + &Alt;Right + Go + Next Bookmark + + + + Go to the next bookmarked page, or do nothing if there + are no bookmarked pages after the current one. + + @@ -560,6 +635,31 @@ 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 the selected area to the clipboard, speak a text or to save an image to a file. + + + + Tools + Text Selection Tool + + + + The mouse will work as a text selection tool. In that mode clicking &LMB; and + dragging will give the option of selecting the text of the document. Then, just + click with the &RMB; to copy to the clipboard or speak the current selection. + + + + + + Tools + Review + + + + Open the review toolbar. The review toolbar allows you to add + annotations on the document you are reading. + + @@ -646,7 +746,7 @@ Settings - Configure &kpdf;... + Configure &okular;... @@ -654,6 +754,18 @@ window. + + + + Settings + Configure Backends... + + + + Opens the Backend Configuration + window. + + @@ -664,12 +776,12 @@ - Configuring &kpdf; + Configuring &okular; - Overview + General configuration - You can configure &kpdf; by choosing Settings - Configure &kpdf;.... + You can configure &okular; by choosing Settings + Configure &okular;.... The configuration dialogue is split into four sections. This chapter describes the available options in detail. @@ -698,10 +810,22 @@ + + Depending on the current installed plugins, the Settings + Configure Backends... menu item could be enabled. + This particular configuration dialogue holds the configurations of the plugins that can + actually be configured. + General + + Show scrollbars + + Whether to show scrollbars for the document view. + + Show search bar in thumbnails list @@ -718,22 +842,27 @@ - Show scrollbars + Show hints and info messages - Whether to show scrollbars for the document view. + Whether to show some informative messages on startup, file + load, &etc;. - Show hints and info messages + Center first page in facing mode - Whether to show some informative messages on startup, file - load, etc. + Whether the first page should be centered or aligned to the right when + displaying the pages in facing mode. Obey DRM limitations - Whether &kpdf; should obey DRM (Digital Rights Management) restrictions. DRM limitations are used to make it impossible to perform certain actions with PDF documents, such as copying content to the clipboard. Note that in some configurations of &kpdf;, this option is not available. + Whether &okular; should obey DRM + (Digital Rights Management) restrictions. DRM limitations are used + to make it impossible to perform certain actions with PDF documents, + such as copying content to the clipboard. Note that in some configurations + of &okular;, this option is not available. @@ -743,6 +872,21 @@ changes and updated, if necessary. + + Show generator selection dialog + + Whether &okular; should ask the user which generator to use in case of more + than one generator able to open the current file. If unchecked, &okular; will + use the generaor with the highest priority. + + + + Overview rows/columns + + These options represent the number of rows and columns to use in the overview + mode. + + @@ -818,9 +962,9 @@ Memory usage profiles - &kpdf; can achieve best performance by tuning the memory usage, based on your system and your tastes. + &okular; can achieve best performance by tuning the memory usage, based on your system and your tastes. The more memory you let it to use, the faster the program will behave. The Default profile is good - for every system, but you can prevent &kpdf; from using more memory than necessary by selecting the Low + for every system, but you can prevent &okular; from using more memory than necessary by selecting the Low profile, or let it get the most out of your system using Aggressive. @@ -851,7 +995,7 @@ Default transition The transition effect between page and page if the document does not specify one. Set this to Random - Transition to make &kpdf; randomly choose one of the available effects. + Transition to make &okular; randomly choose one of the available effects. @@ -881,7 +1025,8 @@ Program Copyright: - Albert Astals Cidtsdgeos@yahoo.es Current maintainer + Albert Astals Cidaacid@kde.org Current maintainer + Pino Toscano pino@kde.org Christophe Devrieseoelewapperke@ulyssis.org &Wilco.Greven; &Wilco.Greven.mail; Original author Enrico Roseros.kde@email.it Refactoring for 3.4 @@ -890,8 +1035,9 @@ Documentation Copyright: - Albert Astals Cidtsdgeos@yahoo.es Author + Albert Astals Cidaacid@kde.org Author Titus Laskatitus.laska@gmx.de Some updates and additions + Pino Toscano pino@kde.org &underFDL; @@ -901,14 +1047,14 @@ Installation - How to obtain &kpdf; + How to obtain &okular; &install.intro.documentation; Compilation and Installation - If you are reading this help in the &khelpcenter;, &kpdf; has already been + If you are reading this help in the &khelpcenter;, &okular; has already been installed on this system and you do not need install it anymore.