<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
  <!ENTITY latex "L<superscript>A</superscript>T<subscript>E</subscript>X">
  <!ENTITY kpdf "<application>KPDF</application>">
  <!ENTITY % English "INCLUDE">
  <!ENTITY % addindex "IGNORE">
]>
<!-- TODO
add chapter about navigation panel
Show/Hide Contens/Thumbnails/Reviews/Bookmarks bar to save screen space
Use Small Icons and deselect Show Text to minimize the navigation panel
Describe all actions only possible in the navigation bars:
Switching between documents using bookmarks
Context menu actions like Rename Bookmarks etc.)
 -->
<book id="okular" lang="&language;">
	<bookinfo>
		<title>The &okular; Handbook</title>
		<authorgroup>
			<author>
				<firstname>Albert</firstname>
				<surname>Astals Cid</surname>
				<affiliation>
					<address>&Albert.Astals.Cid.mail;</address>
				</affiliation>
			</author>
			<author>
				<firstname>Pino</firstname>
				<surname>Toscano</surname>
				<affiliation>
					<address><email>pino@kde.org</email></address>
				</affiliation>
			</author>
			<!-- TRANS:ROLES_OF_TRANSLATORS -->
		</authorgroup>
		<legalnotice>&FDLNotice;</legalnotice>
		<date>2019-06-24</date>
		<releaseinfo>1.8 (Applications 19.08)</releaseinfo>
		<!-- Abstract about this handbook -->
		<abstract>
			<para>&okular; is a &kde; universal document viewer based on &kpdf; code.</para>
		</abstract>
		<keywordset>
			<keyword>KDE</keyword>
			<keyword>okular</keyword>
			<keyword>pdf</keyword>
			<keyword>ps</keyword>
			<keyword>postscript</keyword>
			<keyword>tiff</keyword>
			<keyword>djvu</keyword>
			<keyword>dvi</keyword>
			<keyword>chm</keyword>
			<keyword>xps</keyword>
			<keyword>comicbook</keyword>
			<keyword>fictionbook</keyword>
			<keyword>markdown</keyword>
			<keyword>mobipocket</keyword>
			<keyword>plucker</keyword>
			<keyword>annotation</keyword>
		</keywordset>
	</bookinfo>
	<chapter id="introduction">
		<title>Introduction</title>
		<para>&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.
		</para>
		<para>
			&okular; supports a lot of different formats like &PDF;, &PostScript;, Tiff, CHM, DjVU, Images (png, jpg, &etc;)
			XPS, Open Document (ODT), Fiction Books, Comic Book, Plucker, EPub, Fax and Markdown.
			For all supported formats and their features see <ulink url="http://okular.kde.org/formats.php">
			&okular; Document Format Handlers</ulink>.
		</para>
		<screenshot>
		<screeninfo>&okular;s Main Window</screeninfo>
		<mediaobject>
		<imageobject>
		<imagedata fileref="mainwindow.png" format="PNG" />
		</imageobject>
		<textobject>
		<phrase>&okular;s Main Window</phrase>
		</textobject>
		</mediaobject>
		</screenshot>
	</chapter>
	<chapter id="use">
		<title>Basic Usage</title>
		<sect1 id="opening">
			<title>Opening Files</title>
			<para>
				To view any supported file in &okular;, select <menuchoice><guimenu>File</guimenu><guimenuitem>Open...</guimenuitem>
				</menuchoice>, choose a supported file in the dialog and click <guibutton>Open</guibutton>.
				Your file should now be displayed in the main window.
			</para>
			<important>
			  <para>
			    The new document will be opened in a new tab should the <guilabel>Open new files in tabs</guilabel> option on the <link linkend="configgeneral">General configuration page</link> is checked.
			  </para>
			</important>
			<para>
				If you have already opened files in &okular; before, you can quickly access them by selecting them in
				the <menuchoice><guimenu>File</guimenu><guisubmenu>Open Recent</guisubmenu></menuchoice> menu.
			</para>
			<para>&okular; is the default &kde; application for &PDF; and &PostScript; files, launched when you click with the
			 &LMB; on such a file type in the filemanager. If you want to open any file whose format is supported by &okular;
			 use <menuchoice><guimenu>Open with...</guimenu><guimenuitem>&okular;</guimenuitem> </menuchoice> from context
			 menu in the filemanager.
			</para>
			<para>
				After having a file opened you probably want to read it and therefore navigate through it. Go to the
				<link linkend="navigating">next section</link> to learn more about this.
			</para>
		</sect1>
		<sect1 id="navigating">
			<title>Navigating</title>
			<para>This section describes how you can navigate through a document in &okular;.</para>
			<para>
				There are multiple ways of scrolling the viewing area. One is to use the
				<keysym>Up Arrow</keysym> and <keysym>Down Arrow</keysym> keys. You may also use
				the scrollbar, your mousewheel or the <keycap>Page Up</keycap> and <keycap>Page Down</keycap>
				keys.
			</para>
			<para>
			  You can also use <application>vim</application>-like navigation keys, namely <keycap>H</keycap> to move to the top of the previous page, <keycap>L</keycap> to move to the top of the next page, <keycap>J</keycap> to move one line down, and <keycap>K</keycap> to move one line up.
			</para>
			<para>
				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 <menuchoice><guimenu>Tools</guimenu>
				<guimenuitem>Browse</guimenuitem></menuchoice>.
			</para>
			<note>
			  <para>
			    When viewing a document in the <link linkend="presentationMode">Presentation mode</link> use <keysym>Up Arrow</keysym> and <keysym>Down Arrow</keysym> keys to switch between pages or slides. The number and the position of the current slide will be shown in the overlay at the right upper corner of screen.
			  </para>
			</note>
			<para>If you want to read a document with several pages use the automatic scrolling feature of &okular;.
			Start automatic scrolling with <keycombo action="simul">&Shift;<keysym>Down Arrow</keysym></keycombo> or
			<keycombo action="simul">&Shift;<keysym>Up Arrow</keysym></keycombo>. Then use these keys to increase and
			decrease the scrolling speed. You can start or stop automatic scrolling temporarily by pressing the &Shift; key;
			pressing any other key deactivates this feature.
			</para>
			<para>Another way to navigate through a document with several pages is to use the mouse pointer. Drag the page up or down, continue to drag even while reaching the bottom or top of the screen and behold.
			Once you cross the border of a page, the mouse cursor appears on top or bottom of the screen again and you can just continue to drag.
			</para>
			<para>
				The navigation panel on the left side of the screen enables two more ways of navigating
				through a document:
			</para>
			<itemizedlist>
				<listitem>
					<para>
						If you click on a page thumbnail the viewing area will be brought to
						that page.
					</para>
				</listitem>
				<listitem>
					<para>
						If the document has a table of contents, clicking on a table
						of contents item will bring the document to the page linked to that
						item.
					</para>
				</listitem>
				<listitem>
					<para>
						If the document has layers, you can control the layers shown by checking or unchecking
						the items in the <guilabel>Layers</guilabel> list.
					</para>
				</listitem>
				<listitem>
					<para>
						If the document has bookmarks, enable the <guilabel>Bookmarks</guilabel> view
						and click them to go to the associated page.
						If bookmarks are not only shown for the current document, you can quickly
						switch to bookmarks in all recently opened files.
					</para>
				</listitem>
				<listitem>
					<para>
						If the document has annotations, enable the <guilabel>Reviews</guilabel> view
						and click the annotations or select them with the <keysym>Up Arrow</keysym> and <keysym>Down Arrow</keysym> keys and press <keycap>Return</keycap> to go to the associated page.
					</para>
				</listitem>
			</itemizedlist>
			<para>
				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.
				For example, clicking on a link pointing to <quote>http://www.kde.org</quote>
				will open the web page in the default &kde;'s web browser.
			</para>
			<important>
			  <para>
			    The document internal links work only when <link linkend="menutools">Browse Tool</link> is used.
			  </para>
			</important>
			<para>
				Additionally, you may use the following functionality to quickly move to specific places
				in the document:
			</para>
			<itemizedlist>
				<listitem>
					<para>
						You can go to the beginning of the document using
						<keycombo action="simul">&Ctrl;<keycap>Home</keycap></keycombo> or
						using
						<menuchoice>
							<guimenu>Go</guimenu>
							<guimenuitem>Beginning of the document</guimenuitem>
						</menuchoice>.
					</para>
				</listitem>
				<listitem>
					<para>
						You can go to the end of the document using
						<keycombo action="simul">&Ctrl;<keycap>End</keycap></keycombo> or
						using
						<menuchoice>
							<guimenu>Go</guimenu>
							<guimenuitem>End of the document</guimenuitem>
						</menuchoice>.
					</para>
				</listitem>
				<listitem>
					<para>
						You can go forward in the document using <keycap>Space</keycap> or <keycap>Page Down</keycap>.
						To go to the next page of the document use the <guibutton>Next Page</guibutton> Toolbar
						button or
						<menuchoice>
							<guimenu>Go</guimenu>
							<guimenuitem>Next Page</guimenuitem>
						</menuchoice> in the menubar.
					</para>
				</listitem>
				<listitem>
					<para>
						You can go back in the document using &Backspace; or <keycap>Page Up</keycap>.
						To go to the previous page of the document use <guibutton>Previous Page</guibutton> Toolbar
						button or
						<menuchoice>
							<guimenu>Go</guimenu>
							<guimenuitem>Previous Page</guimenuitem>
						</menuchoice> in the menubar.
					</para>
				</listitem>
				<listitem>
					<para>
						You can go back to the positions in the document where you came from in a chronological order.
						Consider &eg; reading the phrase <quote>As shown in [15], …</quote>, and you want
						to know quickly lookup reference [15]. So you click on it, and &okular; will jump to the list
						of references. Using <keycombo>&Alt;&Shift;<keysym>Left</keysym></keycombo> or
						<menuchoice>
							<guimenu>Go</guimenu>
							<guimenuitem>Back</guimenuitem>
						</menuchoice> in the menubar will bring you back to exactly the position where you came from.
					</para>
				</listitem>
				<listitem>
					<para>
						You can go forward in the document after the jumping back as described above using
						<keycombo>&Alt;&Shift;<keysym>Right</keysym></keycombo> or
						<menuchoice>
							<guimenu>Go</guimenu>
							<guimenuitem>Forward</guimenuitem>
						</menuchoice> in the menubar.
					</para>
				</listitem>
				<listitem>
					<para>
						You can go to the next match when searching using
						<keycap>F3</keycap> or &Enter; (when the focus is on <guilabel>Find</guilabel> text field) keys or
						<menuchoice>
							<guimenu>Edit</guimenu>
							<guimenuitem>Find Next</guimenuitem>
						</menuchoice>
						menu item or move back to the previous match using
						<keycombo>&Shift;<keysym>F3</keysym></keycombo> or <keycombo>&Shift;&Enter;</keycombo> (when the focus is on <guilabel>Find</guilabel> text field) keys or
						<menuchoice>
							<guimenu>Edit</guimenu>
							<guimenuitem>Find Previous</guimenuitem>
						</menuchoice>
						menu item.
					</para>
				</listitem>
			</itemizedlist>
		</sect1>
		<sect1 id="presentationMode">
			<title>Presentation Mode</title>
			<para>
				The Presentation mode represents another way to view documents in &okular;. It can be
				enabled in
				<menuchoice><guimenu>View</guimenu><guimenuitem>Presentation</guimenuitem></menuchoice>.
				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.
			</para>
			<note>
				<para>
					&PDF; documents can even specify that they are always opened in presentation mode.
				</para>
			</note>
			<para>
				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.
			</para>
			<screenshot>
			<screeninfo>&okular; in Presentation Mode</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="presentation.png" format="PNG" />
			</imageobject>
			<textobject>
			<phrase>&okular; in Presentation Mode</phrase>
			</textobject>
			</mediaobject>
			</screenshot>
			<para>
				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 <link linkend="navigating">Navigating</link>
				section.
			</para>
			<para>
			        Use <guilabel>Play/Pause</guilabel> button in the top bar to start playing presentation or pause it, correspondingly.
			</para>
			<para>
				You can exit presentation mode at any time by pressing the &Esc; key or clicking
				the <guiicon>Quit</guiicon> icon in the top bar.
			</para>
			<para>
				You can also draw on the current page with a pencil. Click on the
				<guilabel>Toggle Drawing Mode</guilabel> icon in the top bar to enable or disable the possibility
				to draw in the presentation mode. The drawings are cleared automatically when leaving the presentation
				mode. You can also click on the <guilabel>Erase Drawings</guilabel> icon to remove the
				drawings in the current page.
			</para>
			<para>
				The presentation mode has support for more than one screen in a multi-monitor configuration.
				With more than one screen a new button will appear in the top bar, with the icon of a screen:
				this is a drop down box that allows you to move the presentation to any of the other available screens.
			</para>
			<para>
				Presentation mode has some configuration options, you can find their
				description in the chapter <link linkend="configpresentation">Configuring &okular;</link>.
			</para>
		</sect1>
		<sect1 id="inverse_search">

		<title>Inverse Search between &latex; Editors and &okular;</title>

		<para>Inverse search is a very useful feature when you are writing a &latex; document yourself. If everything is set up properly, you can
		click into &okular;'s window with the <mousebutton>left</mousebutton> mouse button while pressing &Shift;. After that editor loads the &latex; source file and jumps to
		the proper paragraph.</para>

		<para>Inverse search cannot work unless:</para>

		<itemizedlist>
			<listitem><para>The source file has been compiled successfully.</para></listitem>
			<listitem><para>&okular; knows which editor you would like to use.</para></listitem>
			<listitem><para>The Browse tool has to be enabled, which you can select by choosing
				<menuchoice><guimenu>Tools</guimenu><guimenuitem>Browse
				</guimenuitem></menuchoice>.</para></listitem>
		</itemizedlist>

		<para>With this feature of &okular;, a left mouse click while pressing &Shift; in the &DVI; or &PDF; document will
		result in editor opening the corresponding &latex; document and attempt to go to the
		corresponding line. Remember to tell &okular; to use proper editor, in &okular;'s
		menu item <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Okular...</guimenuitem></menuchoice>
		(on the page <guimenuitem>Editor</guimenuitem>).</para>

		<para>For more details on editor configuration please refer to the <link linkend="configeditor">corresponding section of this manual</link>.</para>

		<screenshot>
			<screeninfo>Configuring &okular;</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="configure-editor.png" format="PNG" />
			</imageobject>
			<textobject>
			<phrase>Configuring editor in &okular;</phrase>
			</textobject>
			<caption><para>Configuring editor in &okular;</para></caption>
			</mediaobject>
		</screenshot>
	</sect1>
	</chapter>

	<chapter id="advanced">
		<title>&okular; Advanced Features</title>
		<sect1 id="embedded-files">
			<title>Embedded Files</title>
			<para>
				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.
			</para>
			<screenshot>
				<screeninfo>The embedded files bar</screeninfo>
				<mediaobject>
					<imageobject>
						<imagedata fileref="embedded-files-bar.png" format="PNG" />
					</imageobject>
					<textobject>
						<phrase>The embedded files bar</phrase>
					</textobject>
				</mediaobject>
			</screenshot>
			<para>
				In this case, you can either click on the link in the text of the bar or choose
				<menuchoice><guimenu>File</guimenu><guimenuitem>Embedded Files</guimenuitem></menuchoice>
				to open the embedded files dialog. The dialog allows you to view the embedded files and
				to extract them.
			</para>
		</sect1>
		<sect1 id="forms">
			<title>Forms</title>
			<para>
				If the current document has forms, when you open it a bar
				will appear above the page view where you can enable the forms.
			</para>
			<screenshot>
				<screeninfo>The forms bar</screeninfo>
				<mediaobject>
					<imageobject>
						<imagedata fileref="forms-bar.png" format="PNG" />
					</imageobject>
					<textobject>
						<phrase>The forms bar</phrase>
					</textobject>
				</mediaobject>
			</screenshot>
			<para>
				In this case, you can either click on <guilabel>Show Forms</guilabel> in the bar or choose
				<menuchoice><guimenu>View</guimenu><guimenuitem>Show Forms</guimenuitem></menuchoice>
				to enter data into the form fields.
			</para>
		</sect1>
		<sect1 id="signatures">
			<title>Signatures</title>
			<para>
				If the current document has signatures a bar
                will appear above the page view after the document opening. It allows you to open the <guilabel>Signatures</guilabel> panel.
			</para>
			<screenshot>
				<screeninfo>The signatures bar</screeninfo>
				<mediaobject>
					<imageobject>
						<imagedata fileref="signatures-bar.png" format="PNG" />
					</imageobject>
					<textobject>
						<phrase>The signatures bar</phrase>
					</textobject>
				</mediaobject>
			</screenshot>
			<para>
				Using the <guilabel>Signatures</guilabel> panel you can inspect the document signature and its certificate.
			</para>
			<screenshot>
				<screeninfo>The signatures panel</screeninfo>
				<mediaobject>
					<imageobject>
						<imagedata fileref="signatures-panel.png" format="PNG" />
					</imageobject>
					<textobject>
						<phrase>The signatures panel</phrase>
					</textobject>
				</mediaobject>
			</screenshot>
			<note>
				<para>
					This feature is available for &PDF; documents only. You need to install at least version 0.51 of <ulink url="http://poppler.freedesktop.org/">Poppler</ulink> to get most signature information, version 0.68 to get signature location/reason information, and version 0.73 to get signature certificate information.
				</para>
			</note>
		</sect1>
		<sect1 id="annotations">
			<title>Annotations</title>
			<para>
				&okular; allows you to review and annotate your documents.
			</para>
			<screenshot>
			<screeninfo>&okular;'s Annotations</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="annotations.png" format="PNG" />
			</imageobject>
			<textobject>
			<phrase>&okular;'s Annotations</phrase>
			</textobject>
			</mediaobject>
			</screenshot>
			<para>&okular; has two different kind of annotations:</para>
			<para>Text annotations like <guilabel>Yellow Highlighter</guilabel> and <guilabel>Black Underlining</guilabel>
			for files with text like &eg; &PDF;.</para>
		      <para>Graphic annotations like <guilabel>Pop-up Note</guilabel>, <guilabel>Inline Note</guilabel>, <guilabel>Freehand Line</guilabel>, <guilabel>Highlighter</guilabel>, <guilabel>Straight Line</guilabel>, <guilabel>Polygon</guilabel>, <guilabel>Stamp</guilabel>, <guilabel>Underline</guilabel>, <guilabel>Ellipse</guilabel>, and <guilabel>Typewriter</guilabel> for all formats supported by &okular;.</para>
			<para>Using the context menu either in the <guilabel>Reviews</guilabel> view of the navigation panel or in the main window you can open a <guilabel>Pop up Note</guilabel> for any kind of annotation and add or edit comments.</para>
			<para>Annotations are not only limited to &PDF; files, they can be used for any format &okular; supports.</para>
			<para>
                &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>Save As</guisubmenu></menuchoice> and selecting <guilabel>Okular document archive</guilabel> in the <guilabel>Filter</guilabel> selector. Documents saved this way will get <filename>.okular</filename> as their filename extension. To open an &okular; document archive, just open it with &okular; as it would be &eg; a &PDF; document.
			</para>
			<para>
			  You can <emphasis>also</emphasis> save annotations directly into &PDF; files. You can use <menuchoice><guimenu>File</guimenu> <guimenuitem>Save</guimenuitem></menuchoice> to save it over the current file or <menuchoice><guimenu>File</guimenu> <guimenuitem>Save As...</guimenuitem></menuchoice> to save it to a new file.
			</para>
				<note>
					<para>
						Due to DRM limitations (typically with &PDF; documents), adding, editing some properties
						or removing annotations could not be possible.
					</para>
				</note>
				<note>
				  <para>
				    Any action on annotations (creation and removal of annotations, editing arbitrary annotation properties, relocating annotations with &Ctrl;+drag, and editing the text contents of an annotation) can be <link linkend="edit-undo">undone</link> or <link linkend="edit-redo">redone</link> using the corresponding item from the <guimenu>Edit</guimenu> menu. It is also possible to undo the action by pressing <keycombo>&Ctrl;<keycap>Z</keycap></keycombo> and redo the undone action by pressing <keycombo>&Ctrl;&Shift;<keycap>Z</keycap></keycombo>.
				  </para>
				</note>
			<para>
			  You can configure the default properties and appearance of each annotating tool. Please refer to the <link linkend="configannotations">corresponding section in this documentation</link>.
			</para>
			<sect2 id="annotations-add">
				<title>Adding annotations</title>
				<para>
					To add some annotations to the document, you have to activate the annotating toolbar.
					This is done by either selecting
					<menuchoice><guimenu>Tools</guimenu><guimenuitem>Review</guimenuitem></menuchoice> or
					pressing <keycap>F6</keycap>. Once the annotating toolbar is shown, just press one of
					its buttons or use keyboard shortcuts (keys from <keycap>1</keycap> to <keycap>9</keycap>) to start constructing that annotation.
				</para>
				<para>
				  The annotating toolbar helps you to make annotations with drawings, shapes, and text messages. You can use the annotating toolbar to mark up a document (&eg; add lines, ellipses, polygons, stamps, highlights, underlines &etc;). The table below describes exactly what the default set of annotating toolbar buttons does.
				</para>
				<informaltable>
				  <tgroup cols="3">
				    <thead>
				      <row>
					<entry>
					  Button
					</entry>
					<entry>
					    Tool Name
					</entry>
					<entry>
					    Description
					</entry>
				      </row>
				    </thead>
				    <tbody>
				      <row>
					<entry>
					  <para>
					      <inlinemediaobject>
						<imageobject>
						  <imagedata fileref="tool-note-okular.png" format="PNG"/>
						</imageobject>
					      </inlinemediaobject>
					  </para>
					</entry>
					<entry>
					  <para>
					    Pop-up Note
					  </para>
					</entry>
					<entry>
					  <para>
					    To draw multiline note. The note will can be viewed by double clicking on an icon in the document.
					  </para>
					  <para>
					    Click on the tool button, then click on the place in the document where the pop-up note should be added. Enter the text of pop-up note then click on the <guilabel>Close this note</guilabel> button in the top right corner of the pop-up window.
					  </para>
					  <para>
                          It is possible to define the <guilabel>Color</guilabel>, <guilabel>Opacity</guilabel>, and <guilabel>Icon</guilabel> for the note. Just right-click on the note icon created and select the <guimenuitem>Properties</guimenuitem> menu item.
					  </para>
					</entry>
				      </row>
				      <row>
					<entry>
					  <para>
					      <inlinemediaobject>
						<imageobject>
						  <imagedata fileref="tool-note-inline-okular.png" format="PNG"/>
						</imageobject>
					      </inlinemediaobject>
					  </para>
					</entry>
					<entry>
					  <para>
					    Inline Note
					  </para>
					</entry>
					<entry>
					  <para>
					    To draw inline note. The note will be shown inline as is.
					  </para>
					  <para>
					    Click on the tool button, then click with the &LMB; and hold to place the top-left corner of the note, then drag to place the bottom-right one. Enter the text of the note then click on the <guibutton>OK</guibutton> to save the note, <guibutton>Cancel</guibutton> to cancel note entering or <guibutton>Clear</guibutton> to clear the note.
					  </para>
					  <para>
                          It is possible to define the <guilabel>Color</guilabel>, <guilabel>Opacity</guilabel>, <guilabel>Font</guilabel>, <guilabel>Align</guilabel>, and <guilabel>Border width</guilabel> for the note. Just right-click on the note icon created and select the <guimenuitem>Properties</guimenuitem> menu item.
					  </para>
					</entry>
				      </row>
				      <row>
					<entry>
					  <para>
					      <inlinemediaobject>
						<imageobject>
						  <imagedata fileref="tool-ink-okular.png" format="PNG"/>
						</imageobject>
					      </inlinemediaobject>
					  </para>
					</entry>
					<entry>
					  <para>
					    Freehand Line
					  </para>
					</entry>
					<entry>
					  <para>
					    To draw free-form lines.
					  </para>
					  <para>
					    Click on the tool button, then click with the &LMB; and hold to place the start of the line, then drag to draw the line.
					  </para>
					  <para>
                          It is possible to define the <guilabel>Color</guilabel>, <guilabel>Opacity</guilabel>, and <guilabel>Width</guilabel> for the line. Just right-click on the line created and select the <guimenuitem>Properties</guimenuitem> menu item.
					  </para>
					</entry>
				      </row>
				      <row>
					<entry>
					  <para>
					      <inlinemediaobject>
						<imageobject>
						  <imagedata fileref="tool-highlighter-okular.png" format="PNG"/>
						</imageobject>
					      </inlinemediaobject>
					  </para>
					</entry>
					<entry>
					  <para>
					    Highlighter
					  </para>
					</entry>
					<entry>
					  <para>
					    To highlight text in the document with some given background color.
					  </para>
					  <para>
					    Click on the tool button, then click with the &LMB; and hold to place the beginning of the highlighted text snippet, then drag to highlight it.
					  </para>
					  <para>
                          It is possible to define the <guilabel>Type</guilabel> (<guimenuitem>Highlight</guimenuitem>, <guimenuitem>Squiggle</guimenuitem>, <guimenuitem>Underline</guimenuitem> or <guimenuitem>Strike out</guimenuitem>), <guilabel>Color</guilabel>, and <guilabel>Opacity</guilabel> for the highlighter. Just right-click on the highlighted text and select the <guimenuitem>Properties</guimenuitem> menu item.
					  </para>
					</entry>
				      </row>
				      <row>
					<entry>
					  <para>
					      <inlinemediaobject>
						<imageobject>
						  <imagedata fileref="tool-line-okular.png" format="PNG"/>
						</imageobject>
					      </inlinemediaobject>
					  </para>
					</entry>
					<entry>
					  <para>
					    Straight Line
					  </para>
					</entry>
					<entry>
					  <para>
					    To mark with a line.
					  </para>
					  <para>
					    Click on the tool button, then click with the &LMB; to place the starting point of the line, then drag to place of the ending point of the line should be and click once more.
					  </para>
					  <para>
                          It is possible to define the <guilabel>Color</guilabel>, <guilabel>Opacity</guilabel>, <guilabel>Width</guilabel>, <guilabel>Line start</guilabel>, <guilabel>Line end</guilabel>, <guilabel>Leader line length</guilabel>, and <guilabel>Leader line extension length</guilabel> for the line. Just right-click on the line created and select the <guimenuitem>Properties</guimenuitem> menu item.
					  </para>
					</entry>
				      </row>
				      <row>
					<entry>
					  <para>
					      <inlinemediaobject>
						<imageobject>
						  <imagedata fileref="tool-polygon-okular.png" format="PNG"/>
						</imageobject>
					      </inlinemediaobject>
					  </para>
					</entry>
					<entry>
					  <para>
					    Polygon
					  </para>
					</entry>
					<entry>
					  <para>
					    To draw a closed plane figure from three or more segments. The corresponding note can be viewed by double clicking inside the polygon.
					  </para>
					  <para>
					    Click on the tool button, then click with the &LMB; to place the first vertex of the polygon, then drag to place of the second vertex. Proceed until you draw the whole polygon up to the first vertex. Click twice if you want to add some note to the polygon.  Enter the text of the note then click on the <guibutton>OK</guibutton> to save the note, <guibutton>Cancel</guibutton> to cancel note entering or <guibutton>Clear</guibutton> to clear the note.
					  </para>
					  <para>
                          It is possible to define the <guilabel>Color</guilabel>, <guilabel>Opacity</guilabel>, <guilabel>Shape fill</guilabel> (and its color), and <guilabel>Width</guilabel> for the polygon. Just right-click on the polygon created and select the <guimenuitem>Properties</guimenuitem> menu item.
					  </para>
					</entry>
				      </row>
				      <row>
					<entry>
					  <para>
					      <inlinemediaobject>
						<imageobject>
						  <imagedata fileref="tool-stamp-okular.png" format="PNG"/>
						</imageobject>
					      </inlinemediaobject>
					  </para>
					</entry>
					<entry>
					  <para>
					    Stamp
					  </para>
					</entry>
					<entry>
					  <para>
					    To mark the text or image with some predefined shape.
					  </para>
					  <para>
					    Click on the tool button then click with the &LMB; to place the stamp.
					  </para>
					  <para>
					    A single click just places a square stamp (useful for icons).
					    To add a rectangular stamp you can click with the &LMB; and hold to place the top-left point, then drag to place the bottom-right one.
					  </para>
					  <para>
                          It is possible to define the <guilabel>Opacity</guilabel> and <guilabel>Stamp symbol</guilabel> for the stamp. Just right-click on the stamp icon created and select the <guimenuitem>Properties</guimenuitem> menu item.
					  </para>
					</entry>
				      </row>
				      <row>
					<entry>
					  <para>
					      <inlinemediaobject>
						<imageobject>
						  <imagedata fileref="tool-underline-okular.png" format="PNG"/>
						</imageobject>
					      </inlinemediaobject>
					  </para>
					</entry>
					<entry>
					  <para>
					    Underline
					  </para>
					</entry>
					<entry>
					  <para>
					    To underline some text.
					  </para>
					  <para>
					    Click on the tool button, then click with the &LMB; and hold to place the beginning of the underlined text snippet, then drag to underline it.
					  </para>
					  <para>
                          It is possible to define the <guilabel>Type</guilabel> (<guimenuitem>Highlight</guimenuitem>, <guimenuitem>Squiggle</guimenuitem>, <guimenuitem>Underline</guimenuitem> or <guimenuitem>Strike out</guimenuitem>), <guilabel>Color</guilabel>, and <guilabel>Opacity</guilabel> for the underline. Just right-click on the underlined text and select the <guimenuitem>Properties</guimenuitem> menu item.
					  </para>
					</entry>
				      </row>
				      <row>
					<entry>
					  <para>
					      <inlinemediaobject>
						<imageobject>
						  <imagedata fileref="tool-ellipse-okular.png" format="PNG"/>
						</imageobject>
					      </inlinemediaobject>
					  </para>
					</entry>
					<entry>
					  <para>
					    Ellipse
					  </para>
					</entry>
					<entry>
					  <para>
					    To draw an ellipse or rectangle around some chosen area.
					  </para>
					  <para>
					    Click on the tool button, then click with the &LMB; and hold to place the top-left corner of the circumscribed rectangular for the ellipse, then drag to place the bottom-right one.
					  </para>
					  <para>
                          It is possible to define the <guilabel>Type</guilabel> (<guimenuitem>Rectangle</guimenuitem> or <guimenuitem>Ellipse</guimenuitem>), <guilabel>Color</guilabel>, <guilabel>Opacity</guilabel>, <guilabel>Shape fill</guilabel> (and its color), and <guilabel>Width</guilabel> for the border. Just right-click on the border created and select the <guimenuitem>Properties</guimenuitem> menu item.
					  </para>
					</entry>
				      </row>
				     <row>
					<entry>
					  <para>
					      <inlinemediaobject>
						<imageobject>
						  <imagedata fileref="tool-typewriter-okular.png" format="PNG"/>
						</imageobject>
					      </inlinemediaobject>
					  </para>
					</entry>
					<entry>
					  <para>
					    Typewriter
					  </para>
					</entry>
					<entry>
					  <para>
					    Typewriter features opaque letters on transparent background, so that it is useful to fill noninteractive forms.
					  </para>
					  <para>
					    Click on the tool button, then click with the &LMB; and hold to place the top-left corner of the note, then drag to place the bottom-right one. Enter the text of the note then click on the <guibutton>OK</guibutton> to save the note, <guibutton>Cancel</guibutton> to cancel note entering or <guibutton>Clear</guibutton> to clear the note.
					  </para>
					  <para>
                          It is possible to define the <guilabel>Font</guilabel> and <guilabel>Text color</guilabel> for the text. Just right-click on the typewriter text created and select the <guimenuitem>Properties</guimenuitem> menu item.
					  </para>
					</entry>
				      </row>
				      </tbody>
				    </tgroup>
				  </informaltable>
                                  <para>These are the default annotations provided by &okular;. Using the <link linkend="configannotations">Annotations page</link> of the configuration dialog
                                    you can add your own annotations like custom stamps, text markup with <guilabel>Squiggle</guilabel> or <guilabel>Strike out</guilabel>, a geometrical shape
                                    like a <guilabel>Rectangle</guilabel> with inner color to highlight regions &etc;
                                  </para>
                                  <note>
                                      <para>
                                          It is possible to add &latex; code into the text of annotations. Please add <userinput>$$<replaceable>code</replaceable>$$</userinput> to the text of annotation, where <replaceable>code</replaceable> is any valid &latex; equation, and follow instructions on the screen to make it render by a &latex; distribution installed in your system.
                                      </para>
                                  </note>
				  <para>
				    The contents of the annotating toolbar can be configured using the <link linkend="configannotations">Annotations page of &okular; configuration dialog</link>. This page can be opened with &RMB; clicking on the annotating toolbar then choosing <guimenuitem>Configure Annotations...</guimenuitem> from the context menu.
				</para>
				<para>
                                        With a single &LMB; click on an annotation tool button you can use a tool once. 
					If you &eg; want to highlight all important parts of a text, activate that tool 
					permanently by double clicking on the tool button. 
					Press the <keycap>Esc</keycap> key or click the tool button again to leave the permanent mode.
				</para>
				<note>
					<para>
						The annotating toolbar can be docked in any side of the viewing area: just drag it to
						move it to another place.
					</para>
				</note>
				<note>
					<para>
						Activating the annotating toolbar will make you switch to the Browse Mode.
					</para>
				</note>
				<para>
					You can stop the construction any time by pressing again on the button of the
					annotation you are constructing, or by pressing the &Esc; key.
				</para>
				<para>
					The newly constructed annotation will have as author the author you set in the
					<link linkend="configannotations"><guilabel>Annotations</guilabel> page</link> in &okular;s
					configuration dialog. The <guilabel>Annotations</guilabel> page can also be used to configure the content of the annotating toolbar.
				</para>
			</sect2>
			<sect2 id="annotations-remove">
				<title>Removing annotations</title>
				<para>
					To remove an annotation, just click on it with the &RMB;, and select
					<guimenuitem>Delete</guimenuitem> or select an annotation using the &LMB; and press the &Del; key.
				</para>
				<para>
					When removing the annotation, its window will be closed if open.
				</para>
				<note>
					<para>
						This option could not be enabled because the document does not allow removing
						annotations.
					</para>
				</note>
			</sect2>
			<sect2 id="annotations-edit">
				<title>Editing annotations</title>
				<para>
					To edit an annotation, click on it with the &RMB; and select
					<guimenuitem>Properties</guimenuitem>. A dialog will appear with the general
					annotation settings (like color and opacity, author, &etc;) and the settings specific
					to that annotation type.
				</para>
				<screenshot>
				<screeninfo>Annotation Property Dialog</screeninfo>
				<mediaobject>
				<imageobject>
				<imagedata fileref="annotation-properties.png" format="PNG" />
				</imageobject>
				<textobject>
				<phrase>Annotation Property Dialog</phrase>
				</textobject>
				</mediaobject>
				</screenshot>
				<para>
					To move an annotation, hold down the &Ctrl; key, move the mouse pointer on it and
					then start dragging with the &LMB;.
				</para>
				<para>If you click with the &LMB; on an annotation, it gets selected. Resize handles appear on the
					selection rectangle. When the cursor is moved over one of the 8 resize handles on
					the corners or edges, the cursor shape changes to indicate the resize mode. Click anywhere
					else on the annotation to move it.
					Pressing &Esc; or clicking an area outside the annotation cancels a selection.
				</para>
				<para>Resizing is only applicable for annotation types Inline Note, Typewriter, Stamp and Ellipse.</para>

				<note>
					<para>
						Depending on the document permissions (typically with &PDF; documents), some options
						can be disabled.
					</para>
				</note>
			</sect2>
		</sect1>
		<sect1 id="bookmark-management">
			<title>Bookmark Management</title>
			<para>
				&okular; has a very flexible bookmark system. &okular; saves the position on the page in bookmark and allows you to define more than one bookmark per page.
			</para>
			<para>
			  To manage bookmarks in &okular; you can use <guilabel>Bookmarks</guilabel> view from <guilabel>Navigation Panel</guilabel>, <link linkend="menubookmarks">Bookmarks menu</link> or context menu of document view (click with &RMB; to open it).
			</para>
			<sect2 id="bookmarks-view">
				<title>Bookmarks view</title>
				<para>
				  To open <guilabel>Bookmarks</guilabel> view click on <guilabel>Bookmarks</guilabel> item on the <guilabel>Navigation Panel</guilabel>. If the <guilabel>Navigation Panel</guilabel> is not shown, use <menuchoice><shortcut><keycap>F7</keycap></shortcut> <guimenu>Settings</guimenu><guimenuitem>Show Navigation Panel</guimenuitem>
				  </menuchoice> main menu item to make it visible.
				</para>
				<screenshot>
				    <screeninfo>Bookmark view context menu</screeninfo>
				    <mediaobject>
				      <imageobject>
					<imagedata fileref="bookmark-management.png" format="PNG" />
				      </imageobject>
				      <textobject>
					<phrase>Bookmark view context menu</phrase>
				      </textobject>
				    </mediaobject>
				</screenshot>
				<para>
				  The filter bar at the top of <guilabel>Bookmarks</guilabel> view can be used to filter the content of bookmark list pane according to the text in the box.
				</para>
				<para>
				  The list pane permits to view the bookmark list in a tree-like fashion: each document in the list can be <quote>expanded</quote> or <quote>collapsed</quote> by clicking on the <guiicon>&lt;</guiicon> or <guiicon>v</guiicon> icon next to it.
				</para>
				<para>
				  Click on <inlinemediaobject><imageobject><imagedata fileref="bookmarks.png" format="PNG"/></imageobject></inlinemediaobject> icon below the list to show only the bookmarks from the current document.
				</para>
				<para>
				  Right-click menu of document item can be used to open document, rename its item or remove it from the list. Remember that the removal of a document item leads to the removal of all bookmarks in the corresponding document.
				</para>
				<para>
				  Right-click menus of individual bookmark items allow you to go to the bookmark, rename or remove it.
				</para>
				<para>
				  The Right-click menu of items in the table of contents can be used to create bookmarks or go to the next or previous bookmark.
				</para>
		      </sect2>
		</sect1>
		<!-- Please keep this section content in sync with man page (man-okular.1.docbook) -->
		<sect1 id="command-line-options">
		    <title>Command Line Options</title>
		    <para>
			Though &okular; may most often be started from the &kde; program menu, or a desktop icon, it can also be opened at the command line prompt of a terminal window.  There are a few useful options that are available when doing this.
		    </para>
		    <sect2 id="specify-a-file">
			<title>Specify a File</title>
			<para>
			    By specifying the path and name of a particular file the user can have &okular; open that file immediately upon startup. This option might look something like the following:
			</para>
			<informalexample><screen><prompt>%</prompt> <userinput><command>okular</command> <option><replaceable>/home/myhome/docs/mydoc.pdf</replaceable></option> </userinput> </screen>
			</informalexample>
			<note>
			    <para>
				For &PDF; documents, the name can be given as <replaceable>document_name</replaceable>#<replaceable>named_destination</replaceable> where <replaceable>named_destination</replaceable> is a particular named destination embedded in the document.
			    </para>
			</note>
		    </sect2>
		    <sect2 id="other-command-line-options">
			<title>Other Command Line Options</title>
			<para>
			    The following command line help options are available
			</para>
			<variablelist>
			    <varlistentry>
				<term><userinput><command>okular</command>
				<option>-p --page <replaceable>number</replaceable></option></userinput></term>
				<listitem><para>Open a page with a given number in the document. Also available through <userinput><command>okular</command> <option>-p <replaceable>number</replaceable></option></userinput></para></listitem>
			    </varlistentry>
			    <varlistentry>
				<term><userinput><command>okular</command>
				<option>--presentation</option></userinput></term>
				<listitem><para>Start the document in presentation mode.</para></listitem>
			    </varlistentry>
			    <varlistentry>
				<term><userinput><command>okular</command>
				<option>--print</option></userinput></term>
				<listitem><para>Start with print dialog.</para></listitem>
				</varlistentry>
                <varlistentry>
				<term><userinput><command>okular</command>
				<option>--print-and-exit</option></userinput></term>
				<listitem><para>Start with print dialog and exit after printing.</para></listitem>
				</varlistentry>
			    <varlistentry>
				<term><userinput><command>okular</command>
				<option>--unique</option></userinput></term>
				<listitem><para>Unique instance control.</para></listitem>
				</varlistentry>
				<varlistentry>
				<term><userinput><command>okular</command>
				<option>--noraise</option></userinput></term>
				<listitem><para>Allows to prevent &okular; window raising after the start.</para></listitem>
				</varlistentry>
                <varlistentry>
				<term><userinput><command>okular</command>
				<option>--find <replaceable>string</replaceable></option></userinput></term>
				<listitem><para>Tries to find and highlight a given string in the document. Only works if just one document is given as an argument of the <userinput><command>okular</command></userinput> command.</para></listitem>
				</varlistentry>
			</variablelist>
		    </sect2>
		</sect1>
		<sect1 id="fit-window-to-page">
			<title>Fit window to page</title>
			<para>
			    The Fit window to page feature resizes the window so that it is exactly the same size as the page at the current zoom factor.
			    If the page doesn't completely fit on the screen, the window is enlarged so that the largest possible part of the page is shown.
			</para>
			<para>
			    This feature can be accessed by using the keyboard shortcut <keycombo action="simul">&Ctrl;<keycap>J</keycap></keycombo>
			</para>
		</sect1>
	</chapter>

	<chapter id="primary-menu-items">
		<title>The Menubar</title>

		<sect1 id="menufile">
			<title>The File Menu</title>
			<variablelist>
				<varlistentry>
					<term>
						<menuchoice>
							<shortcut>
								<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
							</shortcut>
							<guimenu>File</guimenu>
							<guimenuitem>Open...</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para>
							<action>Open</action> a supported file or &okular; document 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>.
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>File</guimenu>
							<guisubmenu>Open Recent</guisubmenu>
						</menuchoice>
					</term>
					<listitem>
						<para>
							<action>Open</action> 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
							<link linkend="opening">Opening Files</link>.
						</para>
					</listitem>
				</varlistentry>
				<!--
				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycap>G</keycap></shortcut>
							<guimenu>File</guimenu>
							<guimenuitem>Get Books From Internet...</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para>to be written</para>
					</listitem>
				</varlistentry>
				<-->
				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>File</guimenu>
							<guimenuitem>Import PostScript as &PDF;...</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para>
							<action>Open</action> a &PostScript; file and convert it to &PDF;.
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>File</guimenu>
							<guimenuitem>Open Containing Folder</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para>
							<action>Open</action> folder that contains the current document in your favorite file manager. This action is especially useful for the case when you have downloaded a &PDF; file from the internet that opens itself in &okular;. The location of this file may not be clear or easy to find without this feature.
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term>
						<menuchoice>
							<shortcut>
							<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
							</shortcut>
							<guimenu>File</guimenu>
							<guimenuitem>Save</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
					  <para><action>Saves</action> the document including all the changes (annotations, form contents, &etc;), provided the document backend supports saving those changes. If the backend does not support saving the changes, the user will be given the option to either discard or to save them together with the document in an &okular; document archive.</para>
					</listitem>
				</varlistentry>

                <varlistentry>
					<term>
						<menuchoice>
							<shortcut>
							<keycombo action="simul">&Ctrl;&Shift;<keycap>S</keycap></keycombo>
							</shortcut>
							<guimenu>File</guimenu>
							<guimenuitem>Save As...</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
					  <para><action>Saves</action> the document under a new name including all the changes (annotations, form contents, &etc;), provided the document backend supports saving changes. If the backend does not support saving the changes, the user will be given the option to either discard or to save them together with the document in an &okular; document archive.</para>
                                        <note>
                                        <para>
                                            Note that, due to the way this is implemented, even if there are no changes to the file, the new file need not to be an exact bit-for-bit copy of the original file (&eg; can have a different SHA-1 hash, &etc;).
                                        </para>
                                        </note>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycap>F5</keycap></shortcut>
							<guimenu>File</guimenu>
							<guimenuitem>Reload</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Reload</action> the currently open file.</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></shortcut>
							<guimenu>File</guimenu>
							<guimenuitem>Print...</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para>
							<action>Print</action> the currently displayed document. Please take into account that &okular; has some specific options for printing &PDF; which are available via pressing the <guibutton>Options >></guibutton> button then choosing the <guilabel>&PDF; Options</guilabel>. Use these options to print your annotations or configure rasterization mode if you have problems with printing some symbols or need to change the scale mode.
						</para>
                                                <note>
                                                    <para>
                                                        The scale mode options are only available when you check the <guilabel>Force rasterization</guilabel> option.
                                                    </para>
                                                </note>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>File</guimenu>
							<guimenuitem>Print Preview...</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para>
							<action>Show a preview</action> of how the currently displayed
							document would be printed with the default options.
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>File</guimenu>
							<guimenuitem>Properties</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Display some basic information</action> about the document, such as
							title, author, creation date, and details about the fonts used. The available information
							depends on the type of document.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>File</guimenu>
							<guimenuitem>Embedded Files...</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Show the files embedded</action> in the document, if the document has any.
							For more information, see the section about the
							<link linkend="embedded-files">Embedded Files</link>.</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>File</guimenu>
							<guisubmenu>Export As</guisubmenu>
						</menuchoice>
					</term>
					<listitem>
						<para>This item contains the export formats the current document can be exported to.
						The first entry for all kind of documents is always <guimenuitem>Plain Text...</guimenuitem></para>
						<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>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>File</guimenu>
							<guisubmenu>Share</guisubmenu>
						</menuchoice>
					</term>
					<listitem>
						<para>This item contains the services which can be used to share the current document with other people or send it to your devices.
						The entries in this sub-menu are controlled by the system. They depend on the current document format and the installed KPurpose plugins.</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></shortcut>
							<guimenu>File</guimenu>
							<guimenuitem>Quit</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Close</action> &okular;.</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</sect1>

		<sect1 id="menuedit">
			<title>The Edit Menu</title>
			<variablelist>
				<varlistentry>
					<term>
					  <anchor id="edit-undo"/>
						<menuchoice>
							<shortcut><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></shortcut>
							<guimenu>Edit</guimenu>
							<guimenuitem>Undo</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Undo</action> the last annotation editing command (creation and removal of annotations, editing arbitrary annotation properties, relocating annotations with &Ctrl;+drag, and editing the text contents of an annotation).</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
					  <anchor id="edit-redo"/>
						<menuchoice>
							<shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></shortcut>
							<guimenu>Edit</guimenu>
							<guimenuitem>Redo</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
					  <para><action>Redo</action> the last undo step when editing annotations.</para>
					</listitem>
				</varlistentry>
			</variablelist>

			<variablelist>
				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo></shortcut>
							<guimenu>Edit</guimenu>
							<guimenuitem>Copy</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Copy</action> the currently selected text in
						<guibutton>Text Selection</guibutton> mode to the clipboard.</para>
					</listitem>
				</varlistentry>
			</variablelist>

			<variablelist>
				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></shortcut>
							<guimenu>Edit</guimenu>
							<guimenuitem>Select All</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Selects</action> all the text (if the document provides it). This works only in
						<guibutton>Text Selection</guibutton> mode.</para>
					</listitem>
				</varlistentry>
			</variablelist>

			<variablelist>
				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>Edit</guimenu>
							<guimenuitem>Select All Text on Current Page</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Selects</action> all the text (if the document provides it) of the current page.
                        </para>
					</listitem>
				</varlistentry>
			</variablelist>

			<variablelist>
				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></shortcut>
							<guimenu>Edit</guimenu>
							<guimenuitem>Find...</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para>
							Show the find bar on the bottom of the viewing area that allows you to
							<action>search for a string in the document</action>.
						</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycap>F3</keycap></shortcut>
							<guimenu>Edit</guimenu>
							<guimenuitem>Find Next</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para>Try to <action>find the previous searched string again</action> in the document.</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycombo action="simul">&Shift;<keycap>F3</keycap></keycombo></shortcut>
							<guimenu>Edit</guimenu>
							<guimenuitem>Find Previous</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Goes to the previous occurrence of the search string</action> in the document.</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</sect1>

		<sect1 id="menuview">
			<title>The View Menu</title>
			<variablelist>
				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>P</keycap></keycombo></shortcut>
							<guimenu>View</guimenu>
							<guimenuitem>Presentation</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Activates</action> the Presentation Mode. For more information, see the
							section about <link linkend="presentationMode">Presentation Mode</link>.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo></shortcut>
							<guimenu>View</guimenu>
							<guimenuitem>Zoom In</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Increase the magnification</action> of the document view.</para>
					</listitem>
				</varlistentry>

				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycombo action="simul">&Ctrl;<keycap>-</keycap></keycombo></shortcut>
							<guimenu>View</guimenu>
							<guimenuitem>Zoom Out</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Decrease the magnification</action> of the document view.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>View</guimenu>
							<guimenuitem>Zoom to 100%</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Zoom the document image to the actual size</action> as prescribed by the document parameters.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>View</guimenu>
							<guimenuitem>Fit Width</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Change the magnification</action> of the document
							view to a value that makes the pages' width equal to the document
							view's width.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>View</guimenu>
							<guimenuitem>Fit Page</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Change the magnification</action> of the document view
							to a value that makes at least one whole page visible.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>View</guimenu>
							<guimenuitem>Auto Fit</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Change the magnification</action> of the document view
							to a value that, depending on the size relation between the page and the view area, automatically either makes the pages' width equal to the document view's width (like fit-width), the pages' height equal to the document view's height (like fit-height), or the whole page visible (like fit-page).</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>View</guimenu>
							<guimenuitem>Continuous</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Enable the continuous page mode</action>. In continuous mode,
							all pages of the document are shown, and you can scroll through
							them without having to use the <menuchoice><guimenu>Go</guimenu>
							<guimenuitem>Previous Page</guimenuitem></menuchoice> and
							<menuchoice><guimenu>Go</guimenu><guimenuitem>Next Page</guimenuitem>
							</menuchoice> options.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>View</guimenu>
							<guisubmenu>View Mode</guisubmenu>
						</menuchoice>
					</term>
					<listitem>
						<para>This submenu makes you choose the view mode for the pages. The possible
							options are: <guimenuitem>Single Page</guimenuitem> (only one page per row),
							<guimenuitem>Facing Pages</guimenuitem> (two pages per row, in a book style),
							<guimenuitem>Facing Pages (Center First Page)</guimenuitem> and
							<guimenuitem>Overview</guimenuitem> (the number of columns is the one
							specified in the <link linkend="configure">&okular; settings</link>).</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>View</guimenu>
							<guisubmenu>Orientation</guisubmenu>
						</menuchoice>
					</term>
					<listitem>
						<para>
							This submenu allows you to <action>changes the orientation</action>
							of the pages of the document.
						</para>
						<note>
							<para>
								The rotation is applied to the orientation of every page.
							</para>
						</note>
						<para>
							You can select <guimenuitem>Original Orientation</guimenuitem> to restore
							the orientation of the document, discarding all the rotations applied
							manually.
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>View</guimenu>
							<guisubmenu>Page Size</guisubmenu>
						</menuchoice>
					</term>
					<listitem>
						<para>
							<action>Changes the size of the pages</action> of the document.
						</para>
						<note>
							<para>
								This submenu is active only if the current type of document
								supports different page sizes.
							</para>
						</note>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>View</guimenu>
							<guisubmenu>Trim View</guisubmenu>
						</menuchoice>
					</term>
					<listitem>
						<para>
						  This submenu allows you to remove the white border of pages when viewing pages (<guimenuitem>Trim Margins</guimenuitem> item) or trim viewport to selection (<guimenuitem>Trim To Selection</guimenuitem> item).
						</para>
						<para>
						  The <quote>trim to selection</quote> mode allows you to draw a selection over the rendered page in order to define a visible bounding box to be applied to <emphasis>all pages</emphasis> in the document. Selecting a small trim bounding box enforces minimum dimensions size (20% as a percentage of total page size).
						</para>
						<para>
						  The <quote>trim margins</quote> mode is persistent across &okular; restarts. The <quote>trim to selection</quote> mode is forgotten across &okular; restarts.
						</para>
						<para>
						  When you switch &okular; from <quote>trim margins</quote> mode to <quote>trim to selection</quote> mode, the view jumps out of <quote>trim margins</quote> mode for the bounding box selection interaction.
						</para>
						<para>
						  The trim mode can be deactivated by selecting the same menu item that activates it once again.
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>View</guimenu>
							<guimenuitem>Show/Hide Forms</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para>
							<action>Show or hides the display</action> of the form fields of the
							document.
						</para>
						<note>
							<para>
								This menu item is active only if the current document has form
								fields.
							</para>
						</note>
					</listitem>
				</varlistentry>
			</variablelist>
			<!-- Crtl + mouse wheel zoom in + out-->
		</sect1>

		<sect1 id="menugo">
			<title>The Go Menu</title>
			<variablelist>
				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>Go</guimenu>
							<guimenuitem>Previous Page</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>View the previous page</action> of the document.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>Go</guimenu>
							<guimenuitem>Next Page</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>View the next page</action> of the document.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycombo action="simul">&Ctrl;<keycap>Home</keycap></keycombo></shortcut>
							<guimenu>Go</guimenu>
							<guimenuitem>Beginning of the document</guimenuitem>
					  </menuchoice>
					</term>
					<listitem>
						<para><action>Go to the beginning</action> of the document.</para>
				  </listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycombo action="simul">&Ctrl;<keycap>End</keycap></keycombo></shortcut>
							<guimenu>Go</guimenu>
							<guimenuitem>End of the document</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Go to the end</action> of the document.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycombo action="simul">&Alt;&Shift;<keysym>Left</keysym></keycombo></shortcut>
							<guimenu>Go</guimenu>
							<guimenuitem>Back</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Go back to the previous view</action> of the document.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycombo action="simul">&Alt;&Shift;<keysym 	>Right</keysym></keycombo></shortcut>
							<guimenu>Go</guimenu>
							<guimenuitem>Forward</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Move forward to the next view</action> of the document. This only works if you have already moved back before.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo></shortcut>
							<guimenu>Go</guimenu>
							<guimenuitem>Go to Page...</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para>Open a dialog which allows you to <action>go to any page</action> of the document.</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</sect1>

		<sect1 id="menubookmarks">
			<title>The Bookmarks Menu</title>
			<variablelist>
				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo></shortcut>
							<guimenu>Bookmarks</guimenu>
							<guimenuitem>Add/Remove Bookmark</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para>
							<action>Add or remove a bookmark for the current position</action>.
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>Bookmarks</guimenu>
							<guimenuitem>Rename Bookmark</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para>
						  <action>Rename a bookmark for the current position</action>.
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>Bookmarks</guimenu>
							<guimenuitem>Previous Bookmark</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Go to the previous bookmark</action>, or do nothing if there
							are no bookmarks prior to the current one.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>Bookmarks</guimenu>
							<guimenuitem>Next Bookmark</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Go to the next bookmark</action>, or do nothing if there
							are no bookmarks after the current one.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>Bookmarks</guimenu>
							<guimenuitem>No Bookmarks</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para>This is an always disabled action that appears in this menu only if the current document has
						no bookmarks. Otherwise a list of all bookmarks is displayed here. Clicking on these bookmarks
						allows you to go directly to the associated position.</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</sect1>

		<sect1 id="menutools">
			<title>The Tools Menu</title>
			<variablelist>
				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycombo action="simul">&Ctrl;<keycap>1</keycap></keycombo></shortcut>
							<guimenu>Tools</guimenu>
							<guimenuitem>Browse</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para>The mouse will have its normal behavior, &LMB; for dragging the document and following links and &RMB; for adding bookmarks and fit to width.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycombo action="simul">&Ctrl;<keycap>2</keycap></keycombo></shortcut>
							<guimenu>Tools</guimenu>
							<guimenuitem>Zoom</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<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>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycombo action="simul">&Ctrl;<keycap>3</keycap></keycombo></shortcut>
							<guimenu>Tools</guimenu>
							<guimenuitem>Area Selection</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para>The mouse will work as a rectangular region selection tool. In that mode clicking &LMB; and dragging will draw a selection box and provide the option of copying the selected content to the clipboard, speaking the selected text, or transforming the selection region into an image and saving it to a file.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycombo action="simul">&Ctrl;<keycap>4</keycap></keycombo></shortcut>
							<guimenu>Tools</guimenu>
							<guimenuitem>Text Selection</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para>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.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycombo action="simul">&Ctrl;<keycap>5</keycap></keycombo></shortcut>
							<guimenu>Tools</guimenu>
							<guimenuitem>Table Selection</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para>Draw a rectangle around the text for the table, then use the click with the &LMB;
						  to divide the text block into rows and columns. A &LMB; click on a existing line removes it and merges the adjacent rows or columns.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycombo action="simul">&Ctrl;<keycap>6</keycap></keycombo></shortcut>
							<guimenu>Tools</guimenu>
							<guimenuitem>Magnifier</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para>Activates the magnifier mode for the mouse pointer. Press and hold the &LMB; to activate magnifier widget, move the pointer for panning through the document. The magnifier scales each pixel in the document into 10 pixels in the magnifier widget.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycap>F6</keycap></shortcut>
							<guimenu>Tools</guimenu>
							<guimenuitem>Review</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Open the review toolbar</action>. The review toolbar allows you to add
							annotations on the document you are reading. For more information, please see the
							section about <link linkend="annotations">Annotations</link>.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>Tools</guimenu>
							<guimenuitem>Speak Whole Document</guimenuitem>
						</menuchoice>
					</term>
					<term>
						<menuchoice>
							<guimenu>Tools</guimenu>
							<guimenuitem>Speak Current Page</guimenuitem>
						</menuchoice>
					</term>
					<term>
						<menuchoice>
							<guimenu>Tools</guimenu>
							<guimenuitem>Stop Speaking</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para>These items allow you to speak the whole document or just the current page and stop speaking using the system speech service.
						This service is provided by a &Qt; library which wraps speech-dispatcher on &Linux;, and native speech systems on other platforms.</para>
						<para>The <guilabel>Speak ...</guilabel> actions are enabled only if a speech service is available in the system.</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</sect1>

		<sect1 id="settings-help-menu">
			<title>The Settings and Help Menu</title>
			<para>Apart from the common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu> menus described
			in the <ulink url="help:/fundamentals/ui.html#menus">Menu</ulink> chapter of the &kde; Fundamentals documentation
			&okular; has these application specific menu entries:</para>
			<variablelist>
				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycap>F7</keycap></shortcut>
							<guimenu>Settings</guimenu>
							<guimenuitem>Show Navigation Panel</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Toggle the navigation panel</action> on and off.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>Settings</guimenu>
							<guimenuitem>Show Page Bar</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Toggle the page bar</action> at the bottom of document area on and off to save vertical place in &okular; window.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo></shortcut>
							<guimenu>Settings</guimenu>
							<guimenuitem>Full Screen Mode</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para><action>Enables the full screen mode</action>. Note that
							full screen mode is different from <link
								linkend="presentationMode">presentation mode</link> insofar as the
							only peculiarity of full screen mode is that it hides the window
							decorations, the menubar and the toolbar.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>
						<menuchoice>
							<guimenu>Settings</guimenu>
							<guimenuitem>Configure Backends...</guimenuitem>
						</menuchoice>
					</term>
					<listitem>
						<para>Opens the <link linkend="configure-backends">Backend Configuration</link>
							window.</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</sect1>

	</chapter>
	<chapter id="configure-backends">
	  <title>Configuring &okular; Backends</title>
	  <para>
	    You can configure &okular; backends by choosing <menuchoice>
	      <guimenu>Settings</guimenu>
	      <guimenuitem>Configure Backends...</guimenuitem>
	    </menuchoice>.
	    Currently, configuration options are provided for EPub, &PostScript;, FictionBook, Txt, OpenDocument Text, and &PDF; backends only.
	  </para>
	  <screenshot>
	    <screeninfo>The backends configuration dialog</screeninfo>
	    <mediaobject>
	      <imageobject>
		<imagedata fileref="configure-backends.png" format="PNG" />
	      </imageobject>
	      <textobject>
		<phrase>The backends configuration dialog</phrase>
	      </textobject>
	    </mediaobject>
	  </screenshot>
	  <para>
	    Using backend configuration pages for EPub, FictionBook, Mobipocket, Markdown, TXT, and OpenDocument Text you can define the font to render documents in the corresponding formats. The <guibutton>Choose...</guibutton> button in these pages opens standard &kde; font configuration window. Please refer to the <ulink url="help:/fundamentals/fonts.html">&kde; Fundamentals documentation</ulink> for the details.
	  </para>
	  <para>
	    The description of Markdown, &PostScript; and &PDF; backends configuration pages can be found below.
	  </para>
	  <sect1 id="config-markdown">
	    <title>Markdown backend configuration</title>
	    <para>
	      You can configure &okular; Markdown rendering backend based on <ulink url="https://www.pell.portland.or.us/~orc/Code/markdown/">Discount</ulink> by choosing <guilabel>Markdown</guilabel> from the list on the left part of the configuration dialog. An additional configurable option is as follows.
	    </para>
	    <para>
	      <variablelist>
		<varlistentry>
		  <term>
		    <guilabel>Enable SmartyPants formatting</guilabel>
		  </term>
		  <listitem>
              <para>When checked this option allows &okular; to process <ulink url="https://daringfireball.net/projects/smartypants/">SmartyPants</ulink> formatting. Such formatting can be troublesome in the technical texts because of unwanted substitutions (&eg;, it replaces <literal>(C)</literal> with a copyright symbol). This option is checked by default.
		    </para>
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </para>
	  </sect1>
	  <sect1 id="config-ghostscript">
	    <title>&PostScript; backend configuration</title>
	    <para>
	      You can configure &okular; &PostScript; rendering backend based on <ulink url="http://www.ghostscript.com/">Ghostscript</ulink> by choosing <guilabel>Ghostscript</guilabel> from the list on the left part of the configuration dialog. The only configurable option is as follows.
	    </para>
	    <para>
	      <variablelist>
		<varlistentry>
		  <term>
		    <guilabel>Use platform fonts</guilabel>
		  </term>
		  <listitem>
		    <para>This option determines whether Ghostscript should be allowed to use platform fonts, if unchecked only usage of fonts embedded in the document will be allowed. This option is checked by default.
		    </para>
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </para>
	  </sect1>
	  <sect1 id="config-pdf">
	    <title>&PDF; backend configuration</title>
	    <para>
	      You can configure &okular; &PDF; rendering backend based on <ulink url="http://poppler.freedesktop.org/">Poppler</ulink> by choosing <guilabel>&PDF;</guilabel> from the list on the left part of the configuration dialog. The only configurable option is as follows.
	    </para>
	    <para>
	      <variablelist>
		<varlistentry>
		  <term>
		    <guilabel>Enhance thin lines</guilabel>
		  </term>
		  <listitem>
		    <para>
		      Drawing lines in &okular; is implemented in two steps: generation of the clipping path and filling this clipping path. When the line in the original document is less than one pixel this two step implementation could cause problems. For those lines, the clipping path is filled with the filling color that depends on the thickness of the line part inside the clipping area. If the part of the line inside the clipping area gets very small the contrast between the shape and the background color can become too low for the line to be recognizable. The grids of such lines then looks very unpretty.
		    </para>
		    <informaltable>
		      <tgroup cols="2">
			<tbody>
			  <row>
			    <entry>
			      <para>
				<screenshot>
				  <mediaobject>
				    <imageobject>
				      <imagedata fileref="enhance-thinline.png" format="PNG"/>
				    </imageobject>
				  </mediaobject>
				</screenshot>
			      </para>
			    </entry>
			    <entry>
			      <para>
				<screenshot>
				  <mediaobject>
				    <imageobject>
				      <imagedata fileref="enhance-lowcontrast.png" format="PNG"/>
				    </imageobject>
				  </mediaobject>
				</screenshot>
			      </para>
			    </entry>
			  </row>
			  <row>
			    <entry>Thin line (red), its clipping path (dashed line) and pixel boundaries (black solid lines)</entry>
			    <entry>Thin line shown at a low contrast</entry>
			  </row>
			</tbody>
		      </tgroup>
		    </informaltable>
		    <para>
		      To enhance the look of the thin lines &okular; implements two options.
		    </para>
		    <para>
		      The first option is <guimenuitem>Solid</guimenuitem>. With this option &okular; adjusts clipping path and line position so that clipping path and line are on the same pixel boundary, &ie; &okular; enlarges the thin lines to one pixel on the output device. This mode is similar to the <guilabel>Enhance thin lines</guilabel> in <trademark class="registered">Adobe</trademark>
		      <trademark class="registered">Reader</trademark>. If this option is chosen, the thin lines are always enlarged.
		    </para>
		    <para>
		      <screenshot>
			<mediaobject>
			  <imageobject>
			    <imagedata fileref="enhance-solid.png" format="PNG"/>
			  </imageobject>
			  <textobject>
			    <phrase>Thin line with <guimenuitem>Solid</guimenuitem> enhancement</phrase>
			  </textobject>
			  <caption>
			    <para>Thin line with <guimenuitem>Solid</guimenuitem> enhancement</para>
			  </caption>
			</mediaobject>
		      </screenshot>
		    </para>
		    <para>
		      The second option is <guimenuitem>Shape</guimenuitem>. With this option the clipping path and line are adjusted to pixel boundary as well, but the line intensity is corrected according to its width.
		    </para>
		    <para>
		      <screenshot>
			<mediaobject>
			  <imageobject>
			    <imagedata fileref="enhance-shape.png" format="PNG"/>
			  </imageobject>
			  <textobject>
			    <phrase>Thin line with <guimenuitem>Shape</guimenuitem> enhancement</phrase>
			  </textobject>
			  <caption>
			    <para>Thin line with <guimenuitem>Shape</guimenuitem> enhancement</para>
			  </caption>
			</mediaobject>
		      </screenshot>
		    </para>
		    <para>
		      The thin lines are not enhanced by default (option <guimenuitem>No</guimenuitem>).
		    </para>
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </para>
	  </sect1>
	</chapter>
	<chapter id="configure">
		<title>Configuring &okular;</title>
		<sect1 id="configindex">
			<title>General configuration</title>
			<para>
				You can configure &okular; by choosing <menuchoice><guimenu>Settings</guimenu>
				<guimenuitem>Configure &okular;...</guimenuitem></menuchoice>.
				The configuration dialog is split into six sections. This chapter describes the available
				options in detail.
			</para>
			<itemizedlist>
				<listitem>
					<para><link linkend="configgeneral">General</link></para>
				</listitem>
				<listitem>
					<para><link linkend="configaccessibility">Accessibility</link></para>
				</listitem>
				<listitem>
					<para><link linkend="configperformance">Performance</link></para>
				</listitem>
				<listitem>
					<para><link linkend="configpresentation">Presentation</link></para>
				</listitem>
				<listitem>
					<para><link linkend="configannotations">Annotations</link></para>
				</listitem>
				<listitem>
					<para><link linkend="configeditor">Editor</link></para>
				</listitem>
			</itemizedlist>
			<screenshot>
				<screeninfo>The configuration dialog</screeninfo>
				<mediaobject>
					<imageobject>
						<imagedata fileref="configure.png" format="PNG" />
					</imageobject>
					<textobject>
						<phrase>The configuration dialog</phrase>
					</textobject>
				</mediaobject>
			</screenshot>
			<para>
				Depending on the currently installed backends, the <menuchoice><guimenu>Settings</guimenu>
				<guimenuitem>Configure Backends...</guimenuitem></menuchoice> menu item could be enabled.
				This particular configuration dialog holds the configurations of the backends that can
				actually be configured.
			</para>
		</sect1>
		<sect1 id="configgeneral">
			<title>General</title>
			<variablelist>
				<varlistentry>
					<term><guilabel>Show scrollbars</guilabel></term>
					<listitem>
						<para>Whether to show scrollbars for the document view.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Link the thumbnails with the page</guilabel></term>
					<listitem>
						<para>Whether the thumbnails view should always display the current
							page or not.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Show hints and info messages</guilabel></term>
					<listitem>
						<para>Whether to show some informative messages on startup, file
							load, &etc;</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Display document title in titlebar if available</guilabel></term>
					<listitem>
						<para>Whether to show the current document title in the titlebar of &okular; window. If no metadata for title
						found in the document or this item is unchecked &okular; shows filename of the document.
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>When not displaying document title</guilabel></term>
					<listitem>
					  <para>You can choose any of two options, <guilabel>Display file name only</guilabel> or <guilabel>Display full file path</guilabel>.
					  </para>
					</listitem>
				</varlistentry>
                                <varlistentry>
					<term><guilabel>Use custom background color</guilabel></term>
					<listitem>
                                            <para>Enables <ulink url="help:/fundamentals/colors.html">choosing the document background color</ulink> (the color around the displayed page). By default, the &Qt; toolkit color is used when this option is unchecked.
						</para>
					</listitem>
				</varlistentry>
                                <varlistentry>
					<term><guilabel>Open new files in tabs</guilabel></term>
					<listitem>
						<para>Whether to open new documents in tabs. The tabs are disabled by default.</para>
						<para>
						  The default shortcuts to switch between tabs are <keycombo>&Ctrl;<keycap>.</keycap></keycombo> (<guilabel>Next tab</guilabel>) and <keycombo>&Ctrl;<keycap>,</keycap></keycombo> (<guilabel>Previous tab</guilabel>).
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Obey DRM limitations</guilabel></term>
					<listitem>
						<para>Whether &okular; should obey <firstterm>DRM</firstterm>
							(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.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Reload document on file change</guilabel></term>
					<listitem>
						<para>Whether opened files should be automatically checked for
							changes and updated, if necessary.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Show backend selection dialog</guilabel></term>
					<listitem>
						<para>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.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Right to left reading direction</guilabel></term>
					<listitem>
						<para>
						  Whether to use right to left reading direction by default for the opened files. Can be useful for <ulink url="https://en.wikipedia.org/wiki/Right-to-left">some writing systems</ulink>.
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Overview columns</guilabel></term>
					<listitem>
						<para>
							This option represents the number of columns to use in the overview mode.
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Page Up/Down overlap</guilabel></term>
					<listitem>
						<para>
						  Here you can define the percentage of the current viewing area that should be visible after pressing <keycap>Page Up</keycap>/<keycap>Page Down</keycap> keys.
						</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Default Zoom</guilabel></term>
					<listitem>
						<para>
							This options specifies the default zoom mode for file which were never
							opened before. For those files which were opened before the previous zoom mode
							is applied.
						</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</sect1>
		<sect1 id="configaccessibility">
			<title>Accessibility</title>
			<variablelist>
				<varlistentry>
					<term><guilabel>Draw border around links</guilabel></term>
					<listitem>
						<para>Whether to draw a border around links.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Change colors</guilabel></term>
					<listitem>
						<para><action>Enables</action> the color changing options.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Invert Colors</guilabel></term>
					<listitem>
						<para><action>Inverts</action> colors on the view, &ie; black objects will be shown white.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Change Paper Color</guilabel></term>
					<listitem>
						<para><action>Changes</action> the paper's color, &ie; the document's background.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Change Dark &amp; Light Colors</guilabel></term>
					<listitem>
						<para><action>Changes</action> 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.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Convert to Black &amp; White</guilabel></term>
					<listitem>
						<para><action>Converts</action> the document to black and white. You can set the
							threshold and the contrast. Setting the threshold to a higher value
							by moving it to the right will result in lighter grays used.</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</sect1>
		<sect1 id="configperformance">
			<title>Performance</title>
			<variablelist>
				<varlistentry>
					<term><guilabel>Enable transparency effects</guilabel></term>
					<listitem>
						<para>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.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Memory Usage</guilabel></term>
					<listitem>
						<para>&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. Use Greedy profile to preload all
							pages without risk of system memory overfull (only 50% of total memory or free memory will be used).</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Rendering</guilabel></term>
					<listitem>
						<para>Using this group of options you can improve text and image rendering in &okular;. The result depends on the device to display the document. 
						 <guilabel>Enable Text Antialias</guilabel> and <guilabel>Enable Graphics Antialias</guilabel> items can be used to switch on and off <ulink url="http://en.wikipedia.org/wiki/Spatial_anti-aliasing">spatial anti-aliasing</ulink> of text and images in document, correspondingly.
						 <guilabel>Enable Text Hinting</guilabel> item is meant to be a switcher for <ulink url="http://en.wikipedia.org/wiki/Font_hinting">font hinting</ulink>.
						 Antialiasing and hinting change how the documents are displayed, you may want to tweak them to your preference.</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</sect1>
		<sect1 id="configpresentation">
			<title>Presentation</title>
			<variablelist>
				<varlistentry>
					<term><guilabel>Advance every</guilabel></term>
					<listitem>
						<para>Enables automatic advancing of pages given a time period.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Loop after last page</guilabel></term>
					<listitem>
						<para>When navigating on presentation mode and going past the last page the first page will appear.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Touch navigation</guilabel></term>
					<listitem>
						<para>Allows you to fine-tune touchscreen navigation with tapping in the presentation using the following three possible values:</para>
                        <itemizedlist>
							<listitem>
								<para><guilabel>Tap left/right side to go back/forward</guilabel>: Tapping on the left (right) half of the screen makes the presentation go to the previous (next) slide.</para>
							</listitem>
							<listitem>
								<para><guilabel>Tap anywhere to go forward</guilabel> (default): Tapping on the screen makes the presentation go to the next slide, no matter where the screen is being tapped.</para>
							</listitem>
							<listitem>
								<para><guilabel>Disabled</guilabel>: Screen tapping does not do anything.</para>
							</listitem>
						</itemizedlist>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Background color</guilabel></term>
					<listitem>
						<para>The color that will fill the part of the screen not covered by the page when on presentation mode.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Mouse cursor</guilabel></term>
					<listitem>
						<para>Whether the mouse should be always hidden, always shown or hidden after a small time of inactivity.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Show progress indicator</guilabel></term>
					<listitem>
						<para>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 every time you change the page.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Show summary page</guilabel></term>
					<listitem>
						<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>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Enable transitions</guilabel></term>
					<listitem>
						<para>Use this check box to enable or disable transition effects between pages.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Default transition</guilabel></term>
					<listitem>
						<para>The transition effect between page and page if the document does not specify one. Set this to <guilabel>Random
							Transition</guilabel> to make &okular; randomly choose one of the available effects.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Placement</guilabel></term>
					<listitem>
						<para>In this section you can select the <guilabel>Screen</guilabel> used to display the presentation.</para>
						<para><guilabel>Current Screen</guilabel> is same screen of the &okular; window that starts the presentation mode.</para>
						<para><guilabel>Default Screen</guilabel> is the screen marked as default in the xinerama configuration.</para>
						<para><guilabel>Screen 0</guilabel>, <guilabel>Screen 1</guilabel> &etc; are the available screens.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Drawing Tool Configuration</guilabel></term>
					<listitem>
						<para>Manage the colors of the pencil used when drawing on the pages during the presentation mode.</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</sect1>
		<sect1 id="configannotations">
			<title>Annotations</title>
			<screenshot>
				<screeninfo>The Annotations page of the configuration dialog</screeninfo>
				<mediaobject>
					<imageobject>
						<imagedata fileref="configure-annotations.png" format="PNG" />
					</imageobject>
					<textobject>
						<phrase>The Annotations page of the configuration dialog</phrase>
					</textobject>
				</mediaobject>
			</screenshot>
			<variablelist>
				<varlistentry>
					<term><guilabel>Author</guilabel></term>
					<listitem>
						<para>The author of the contents added on a document.
						Default is the name from the <guilabel>Password &amp; User Account</guilabel> page of the &systemsettings; module <guilabel>Account Details</guilabel>.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Annotation tools</guilabel></term>
					<listitem>
					  <para>
					    This pane is used to configure your <link linkend="annotations-add">annotating toolbar</link>.
					  </para>
					  <para>
					    There are five buttons (<guibutton>Add</guibutton>, <guibutton>Edit</guibutton>, <guibutton>Remove</guibutton>, <guibutton>Move Up</guibutton>, <guibutton>Move Down</guibutton>) and a list box (which lists the contents of the current annotating toolbar) which are used to configure the toolbar.
					  </para>
					  <para>
					    If you need to add some tool button on the toolbar click on the <guibutton>Add</guibutton> button. You can choose the <guilabel>Name</guilabel>, the <guilabel>Type</guilabel> and the <guilabel>Appearance</guilabel> of the created tool.
					  </para>
					  <note>
					    <para>
					      Please remember that annotation tools in &okular; are highly configurable. For example, you can have two buttons of the same tool but with different color. Do not hesitate to experiment in choosing the button set that is exactly tailored to your workflow.
					    </para>
					  </note>
					  <para>
					    Click on some item in the list box then click on the corresponding button at the right part of the page to edit, remove, move up or move down the item. The keyboard shortcut of the tool (keys from <keycap>1</keycap> to <keycap>9</keycap>) depends on its position in the list of annotating toolbar.
					  </para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>Using Custom Stamps</term>
					<listitem>
					<orderedlist>
					<listitem><para>Create the icon you want to use for your own stamp and save it in any graphics format supported by &okular;</para></listitem>
					<listitem><para>Click the <guibutton>Add</guibutton> button, select type <guilabel>Stamp</guilabel> and enter a name for your stamp.</para></listitem>
					<listitem><para>Enter the full path to your custom icon into the dropdown box in the <guilabel>Stamp Symbol</guilabel> group</para></listitem>
					</orderedlist>
					</listitem>
				</varlistentry>
			</variablelist>
		</sect1>
		<sect1 id="configeditor">
			<title>Editor</title>
			<variablelist>
				<varlistentry>
					<term><guilabel>Editor</guilabel></term>
					<listitem>
						<para>Choose the editor you want to launch when &okular; wants to open a source file.
						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>).
						</para>
						<para>
						  &okular; ships with preconfigured settings for the following editors: <ulink url="https://kate-editor.org/">&kate;</ulink>, <ulink url="https://kile.sourceforge.io/">Kile</ulink>, <ulink url="https://www.scintilla.org/SciTE.html">SciTE</ulink>, <ulink url="https://www.gnu.org/software/emacs/">&Emacs; client</ulink>, <ulink url="https://www.lyx.org/">LyX client</ulink>, and <ulink url="https://www.texstudio.org/">TeXstudio</ulink>.
						</para>
						<note>
						  <para>
						    To use inverse search in <application>Kile</application>, you have to compile your &latex; file with the <guilabel>Modern</guilabel> configuration.
						  </para>
						</note>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guilabel>Command</guilabel></term>
					<listitem>
						<para>This is the command and its parameters to invoke the selected editor with the source file of the actual document.</para>
						<para>This field will be filled automatically if you use one of the preconfigured editors. Otherwise, please choose <guimenuitem>Custom Text Editor</guimenuitem> in <guilabel>Editor</guilabel> drop down box and refer to the documentation on your favorite editor to find the proper command.
					        </para>
						<para>You can use the following placeholders:</para>
						<itemizedlist>
						  <listitem>
						    <para>%f - the file name</para>
						  </listitem>
						  <listitem>
						    <para>%l - the line of the file to be reached</para>
						  </listitem>
						  <listitem>
						    <para>%c - the column of the file to be reached</para>
						  </listitem>
						</itemizedlist>
						<para>If %f is not specified, then the document name is appended to the specified command.</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</sect1>
	</chapter>
	<chapter id="credits">
		<title>Credits and License</title>

		<itemizedlist>
			<title>Program Copyright:</title>
			<listitem><para>&Albert.Astals.Cid; &Albert.Astals.Cid.mail; Current maintainer</para></listitem>
			<listitem><para>Pino Toscano <email>pino@kde.org</email></para></listitem>
			<listitem><para>Enrico Ros <email>eros.kde@email.it</email> &kpdf; developer</para></listitem>
		</itemizedlist>

		<itemizedlist>
			<title>Documentation Copyright:</title>
			<listitem><para>&Albert.Astals.Cid; &Albert.Astals.Cid.mail; Author</para></listitem>
			<listitem><para>Titus Laska <email>titus.laska@gmx.de</email> Some updates and additions</para></listitem>
			<listitem><para>Pino Toscano <email>pino@kde.org</email></para></listitem>
		</itemizedlist>
		<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
		&underFDL;
		&underGPL;
	</chapter>

	&documentation.index;
</book>


<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

// vim:ts=2:sw=2:tw=78:noet
-->
