KPDF"> PDF"> ]> Albert Astals Cid

aacid@kde.org

Pino Toscano

pino@kde.org

&FDLNotice; 2008-01-10 0.6.80 &okular; is a &kde; universal document viewer based on &kpdf; code. KDE okular pdf ps tiff djvu dvi chm xps &okular; is a &kde; universal 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. 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 &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. Go to the next section to learn more about this. 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 the scrollbar, your mousewheel or the Page Up and Page Down keys. Another way is to hold the &LMB; down at any place on the document while dragging the mouse in the opposite direction of where you want to move. This procedure only works if the Browse Tool is enabled, which you can select by choosing ToolsBrowse Tool . The navigation panel on the left side of the screen enables two more ways of navigating through a document: If you click on a page thumbnail the viewing area will be brought to that page. If the document has a table of contents, clicking on a table of contents item will bring the document to to the page linked to that item. 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 or some other document the default &kde; handler for that format will be invoked. Additionally, you may use the following functionality to quickly move to specific places in the document: You can go to the first page of the document using &Ctrl;Home or using Go First Page . You can go to the last page of the document using &Ctrl;End or using Go Last Page . You can go to the next page of the document using Space, Page Down, the Next Page Toolbar button or using Go Next Page . You can go to the previous page of the document using Backspace, Page Up, the Previous Page Toolbar button or using Go Previous Page . 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 zoom to page, that means all the page is visible. &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 or the line edit in the top bar, or the keys specified in the Navigating section. You can exit presentation mode at any time by pressing the ESC key or clicking the Quit icon in the top bar. You can also draw on the current page with a pencil. Click on the Toggle Drawing Mode icon in the top bar to enable or disable the possibility of draw in the presentation mode. The drawings are cleared automatically when switching to another page, or manually selecting the Erase Drawings icon in the top bar. Presentation mode has some configuration options, you can find their description at Configuring &okular;. If the current document has some files embedded in it, when you open it a yellow bar will appear above the page view to notify you about the embedded files. The embedded files bar The embedded files bar In this case, you can either click on the link in the text of the bar or choose FileEmbedded Files to open the embedded files dialog. The dialog allows you to view the embedded files and to extract them. &okular; allows you to review and annotate your documents. Due to DRM limitations (typically with &PDF; documents), adding, editing some properties or removing annotations could not be possible. To add some annotations to the document, you have to activate the annotating toolbar. This is done by either selecting ToolsReview or pressing F6. Once the annotating toolbar is shown, just press one of its buttons to start constructing that annotation. The annotating toolbar can be docked in any side of the viewing area: just drag it to move it to another place. Activating the annotating toolbar will make you switch to the Normal Mode. You can stop the construction any time by pressing again on the button of the annotation you are constructing. The newly constructed annotation will have as author the author you set in the Identity section in the settings. To remove an annotation, just click on it with the &RMB;, and select Delete. When removing the annotation, its window will be closed if open. This option could not be enabled because the document does not allow removing annotations. To edit an annotation, click on it with the &RMB; and select Properties.... A dialog will appear with the general annotation settings (like color and opacity, author, &etc;) and the settings specific to that annotation type. To move an annotation, hold down the &Ctrl; key, move the mouse pointer on it and then start dragging with the &LMB;. Depending on the document permissions (typically with &PDF; documents), some options can be disabled. &Ctrl;O File Open... Open a supported file. If there is already an opened file it will be closed. For more information, see the section about Opening Files. File Open Recent Open a file which was used previously from a submenu. If a file is currently being displayed it will be closed. For more information, see the section about Opening Files. File Import PostScript as PDF... Open a PostScript file and convert it to &PDF;. File Save As... Save the currently open file under a different name. F5 File Reload Reload the currently open file. &Ctrl;P File Print... Print the currently displayed document. File Print Preview... Show a preview of how the currently displayed document would be printed with the default options. File Properties Display some basic information about the document, such as title, author, creation date, and details about the fonts used. The available information depends on the type of document. File Embedded Files... Show the files embedded in the document, if the document has any. For more information, see the section about the Embedded Files. File Export As This item contains the export formats the current document can be exported to. The first entry for all kind of documents is always Plain Text.... &Ctrl;Q File Quit Close &okular;. &Ctrl;C Edit Copy Copy the currently selected text in Text Selection mode to the clipboard. &Ctrl;A Edit Select All Selects all the text (if the document provides it). This works only in Text Selection mode. &Ctrl;F Edit Find... Show the find bar on the bottom of the viewing area that allows you to search for a string in the document. F3 Edit Find Next Try to find the previous searched string again in the document. &Ctrl;&Shift;P View Presentation Activates the Presentation Mode. For more information, see the section about Presentation Mode. &Ctrl;+ View Zoom In Increase the magnification of the document view. &Ctrl;- View Zoom Out Decrease the magnification of the document view. View Fit Width Change the magnification of the document view to a value that makes the pages' width equal to the document view's width. View Fit Page Change the magnification of the document view to a value that makes at least one whole page visible. View Continuous Enable the continuous page mode. In continuous mode, all pages of the document are shown, and you can scroll through them without having to use the Go Previous Page and GoNext Page options. View View Mode This submenu makes you choose the view mode for the pages. The possible options are: Single Page (only one page per row), Facing Pages (two pages per row, in a book style) and Overview (the number of columns is the one specified in the &okular; settings). View Orientation This submenu allows you to changes the orientation of the pages of the document. The rotation is applied to the orientation of every page. You can select Original Orientation to restore the orientation of the document, discarding all the rotations applied manually. View Page Size Changes the size of the pages of the document. This submenu is active only if the current type of document supports different page sizes. View Show/Hide Forms Show or hides the display of the form fields of the document. This menu item is active only if the current document has form fields. Backspace Go Previous Page View the previous page of the document. Space Go Next Page View the next page of the document. &Ctrl;Home Go First Page Go to the first page of the document. &Ctrl;End Go Last Page Go to the last page of the document. Go Back in the Document Go back to the previous view of the document. Go Forward in the Document Move forward to the next view of the document. This only works if you have already moved back before. &Ctrl;G Go Go to Page... Open a dialog which allows you to go to any page of the document. &Ctrl;B Bookmarks Add/Remove Bookmark Add or remove a bookmark for the current page. Bookmarks Previous Bookmark Go to the previous bookmarked page, or do nothing if there are no bookmarked pages prior to the current one. Bookmarks Next Bookmark Go to the next bookmarked page, or do nothing if there are no bookmarked pages after the current one. Bookmarks No Bookmarks This is an always disabled action that appears in this menu only if the current document has no bookmarks. Otherwise a list of all bookmarked pages is displayed here. Clicking on these bookmarks allows you to go directly to the associated pages. &Ctrl;1 Tools Browse Tool The mouse will have its normal behaviour, &LMB; for dragging the document and following links and &RMB; for adding bookmarks and fit to width. &Ctrl;2 Tools Zoom Tool 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. &Ctrl;3 Tools Selection Tool 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. &Ctrl;4 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. F6 Tools Review Open the review toolbar. The review toolbar allows you to add annotations on the document you are reading. For more information, please see the section about Annotations. &Ctrl;M Settings Show Menubar Toggle the Menubar display on and off. Once hidden it can be made visible using the &RMB; menu. Settings Show Toolbar Toggle the Toolbar display on and off. F7 Settings Show Navigation Panel Toggle the navigation panel on and off. &Ctrl;&Shift;F Settings Full Screen Mode Enables the full screen mode. Note that full screen mode is different from presentation mode insofar as the only peculiarity of full screen mode is that it hides the window decorations, the menubar and the toolbar. Settings Configure Shortcuts... Opens a window that lets you configure the keyboard shortcuts for many menu commands. Settings Configure Toolbars... Opens a window that lets you choose which icons are visible in the toolbar. Settings Configure Backends... Opens the Backend Configuration window. Settings Configure &okular;... Opens the Configure window. &help.menu.documentation; 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. General Accessibility Performance Presentation Identity The configuration dialogue The configuration dialogue Depending on the currently installed backends, the Settings Configure Backends... menu item could be enabled. This particular configuration dialogue holds the configurations of the backends that can actually be configured. Show scrollbars Whether to show scrollbars for the document view. Link the thumbnails with the page Whether the thumbnails view should always display the current page or not. Show hints and info messages Whether to show some informative messages on startup, file load, &etc;. Obey DRM limitations 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. Reload document on file change Whether opened files should be automatically checked for changes and updated, if necessary. Show backend selection dialog Whether &okular; should ask the user which backend to use in case of more than one backend able to open the current file. If unchecked, &okular; will use the backend with the highest priority. Center first page Whether the first page should be centered or aligned to the right when displaying the pages in facing mode. Overview columns This options represent the number of columns to use in the overview mode. Draw border around links Whether to draw a border around links. Change Colors Enables the color changing options. Invert colors Inverts colors on the view, &ie; black objects will be shown white. Change paper color Changes the paper's color, &ie; the document's background. Change dark and light colors Changes the dark and light color to your preference, that means black will not be rendered as black but as the selected dark color and white will not be rendered as white but as the selected light color. Convert to black and white Converts the document to black and white. You can set the threshold and the contrast. Setting the threshold to a higher value will result in darker grays used. Enable transparency effects Draw selections and other special graphics using transparency effects. Disable the option to draw them using outline or opaque fill styles and increase speed on selections. Enable background generation Use a background thread to generate the pages. By disabling this option the user interface will become less reactive (will be blocked if necessary), but pages will be displayed a bit faster. Memory usage profiles &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 &okular; from using more memory than necessary by selecting the Low profile, or let it get the most out of your system using Aggressive. Advance every Enables automatic advancing of pages given a time period. Loop after last page When navigating on presentation mode and going past the last page the first page will appear. Background color The color that will fill the part of the screen not covered by the page when on presentation mode. Default transition The transition effect between page and page if the document does not specify one. Set this to Random Transition to make &okular; randomly choose one of the available effects. Mouse cursor Whether the mouse should be always hidden, always shown or hidden after a small time of inactivity. Show progress indicator Whether to show a progress circle that shows the current page and the total number of pages on the upper right corner of the presentation screen everytime you change the page. Show summary page Whether to show a summary page at the beginning of the presentation with the title, author and number of pages of the document. Pencil color The color of the pencil used when drawing on the pages during the presentation mode. Author The author of the contents added on a document. Albert Astals Cidaacid@kde.org Pino Toscano pino@kde.org Current maintainer Enrico Roseros.kde@email.it &kpdf; developer Albert Astals Cidaacid@kde.org Author Titus Laskatitus.laska@gmx.de Some updates and additions Pino Toscano pino@kde.org &underFDL; &underGPL; &install.intro.documentation; 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. &install.compile.documentation; &documentation.index;