updated documentation for 4.2

svn path=/trunk/KDE/kdegraphics/doc/okular/; revision=920426
remotes/origin/old/work/record-presentation
Burkhard Lück 17 years ago
parent 71b007ee5a
commit 6f06acb215
  1. 64
      doc/index.docbook

@ -29,8 +29,8 @@
<!-- TRANS:ROLES_OF_TRANSLATORS --> <!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup> </authorgroup>
<legalnotice>&FDLNotice;</legalnotice> <legalnotice>&FDLNotice;</legalnotice>
<date>2008-08-21</date> <date>2009-01-25</date>
<releaseinfo>0.7</releaseinfo> <releaseinfo>0.8</releaseinfo>
<!-- Abstract about this handbook --> <!-- Abstract about this handbook -->
<abstract> <abstract>
<para>&okular; is a &kde; universal document viewer based on &kpdf; code.</para> <para>&okular; is a &kde; universal document viewer based on &kpdf; code.</para>
@ -148,24 +148,24 @@
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
You can go to the next page of the document using You can go forward in the document using <keycap>Space</keycap> or <keycap>Page Down</keycap>.
<keycap>Space</keycap>, <keycap>Page Down</keycap>, the <guibutton>Next Page</guibutton> Toolbar To go to the next page of the document use the <guibutton>Next Page</guibutton> Toolbar
button or using button or
<menuchoice> <menuchoice>
<guimenu>Go</guimenu> <guimenu>Go</guimenu>
<guimenuitem>Next Page</guimenuitem> <guimenuitem>Next Page</guimenuitem>
</menuchoice>. </menuchoice> in the menubar.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
You can go to the previous page of the document using You can go bach in the document using <keycap>Backspace</keycap> or <keycap>Page Up</keycap>.
<keycap>Backspace</keycap>, <keycap>Page Up</keycap>, the <guibutton>Previous Page</guibutton> Toolbar To go to the previous page of the document use <guibutton>Previous Page</guibutton> Toolbar
button or using button or
<menuchoice> <menuchoice>
<guimenu>Go</guimenu> <guimenu>Go</guimenu>
<guimenuitem>Previous Page</guimenuitem> <guimenuitem>Previous Page</guimenuitem>
</menuchoice>. </menuchoice> in the menubar.
</para> </para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
@ -246,7 +246,10 @@
<sect1 id="annotations"> <sect1 id="annotations">
<title>Annotations</title> <title>Annotations</title>
<para> <para>
&okular; allows you to review and annotate your documents. &okular; allows you to review and annotate your documents. Annotations created in &okular; are saved internally in the local data folder for each user.
</para>
<para>
Since &kde; 4.2, &okular; has the "document archiving" feature. This is an &okular;-specific format for carrying the document plus various metadata related to it (currently only annotations). You can save a "document archive" from the open document by choosing <menuchoice><guimenu>File</guimenu><guisubmenu>Export As</guisubmenu><guimenuitem>Document Archive</guimenuitem></menuchoice>. To open an &okular; document archive, just open it with &okular; as it would be &eg; a &PDF; document.
</para> </para>
<note> <note>
<para> <para>
@ -304,7 +307,7 @@
<title>Editing annotations</title> <title>Editing annotations</title>
<para> <para>
To edit an annotation, click on it with the &RMB; and select To edit an annotation, click on it with the &RMB; and select
<guimenuitem>Properties...</guimenuitem> A dialog will appear with the general <guimenuitem>Properties</guimenuitem>. A dialog will appear with the general
annotation settings (like color and opacity, author, &etc;) and the settings specific annotation settings (like color and opacity, author, &etc;) and the settings specific
to that annotation type. to that annotation type.
</para> </para>
@ -340,8 +343,7 @@
</term> </term>
<listitem> <listitem>
<para> <para>
<action>Open</action> a supported file. If there is already an opened file it will be closed. <action>Open</action> a supported file or okular archive. If there is already an opened file it will be closed. For more information, see the section about <link linkend="opening">Opening Files</link>.
For more information, see the section about <link linkend="opening">Opening Files</link>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -380,7 +382,7 @@
<term> <term>
<menuchoice> <menuchoice>
<guimenu>File</guimenu> <guimenu>File</guimenu>
<guimenuitem>Import PostScript as PDF...</guimenuitem> <guimenuitem>Import PostScript as &PDF;...</guimenuitem>
</menuchoice> </menuchoice>
</term> </term>
<listitem> <listitem>
@ -410,7 +412,7 @@
</menuchoice> </menuchoice>
</term> </term>
<listitem> <listitem>
<para><action>Save</action> a copy the currently open file under a different name <para><action>Save</action> a copy of the currently open file under a different name
without using the current document backend.</para> without using the current document backend.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -495,6 +497,7 @@
<listitem> <listitem>
<para>This item contains the export formats the current document can be exported to. <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> 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> </listitem>
</varlistentry> </varlistentry>
@ -723,7 +726,7 @@
<term> <term>
<menuchoice> <menuchoice>
<guimenu>View</guimenu> <guimenu>View</guimenu>
<guimenuitem>Trim Borders</guimenuitem> <guimenuitem>Trim Margins</guimenuitem>
</menuchoice> </menuchoice>
</term> </term>
<listitem> <listitem>
@ -1225,19 +1228,19 @@
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><guilabel>Change Colors</guilabel></term> <term><guilabel>Change colors</guilabel></term>
<listitem> <listitem>
<para><action>Enables</action> the color changing options.</para> <para><action>Enables</action> the color changing options.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><guilabel>Invert colors</guilabel></term> <term><guilabel>Invert Colors</guilabel></term>
<listitem> <listitem>
<para><action>Inverts</action> colors on the view, &ie; black objects will be shown white.</para> <para><action>Inverts</action> colors on the view, &ie; black objects will be shown white.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><guilabel>Change paper color</guilabel></term> <term><guilabel>Change Paper Color</guilabel></term>
<listitem> <listitem>
<para><action>Changes</action> the paper's color, &ie; the document's background.</para> <para><action>Changes</action> the paper's color, &ie; the document's background.</para>
</listitem> </listitem>
@ -1280,7 +1283,7 @@
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><guilabel>Memory usage profiles</guilabel></term> <term><guilabel>Memory Usage</guilabel></term>
<listitem> <listitem>
<para>&okular; can achieve best performance by tuning the memory usage, based on your system and your tastes. <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 The more memory you let it to use, the faster the program will behave. The Default profile is good
@ -1365,6 +1368,25 @@
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect1> </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>
</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>
</listitem>
</varlistentry>
</variablelist>
</sect1>
</chapter> </chapter>
<chapter id="credits"> <chapter id="credits">
<title>Credits and License</title> <title>Credits and License</title>

Loading…
Cancel
Save