office/okular
office/okular
1
0
Fork 0
mirror of https://invent.kde.org/graphics/okular synced 2024-08-25 10:55:37 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add some documentation about usage of Okular annotating tools

Browse source 
REVIEW: 112569
This commit is contained in:
Yuri Chornoivan 2013-09-21 19:07:37 +03:00
parent 159264ade0
commit 452f7705a7
10 changed files with 243 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

249
doc/index.docbook
View file

@ -488,7 +488,249 @@ Context menu actions like Rename Bookmarks etc.)
its buttons or use keyboard shortcuts (keys from <keycap>1</keycap> to <keycap>9</keycap>) to start constructing that annotation.
</para>
<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.
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>
</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>
</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>
</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>
</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>
</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>
</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>
</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>
</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 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>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<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.
@ -516,11 +758,6 @@ Context menu actions like Rename Bookmarks etc.)
<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>
<note>
<para>Using stamps 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>
</note>
</sect2>
<sect2 id="annotations-remove">
<title>Removing annotations</title>

BIN
doc/tool-ellipse-okular.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 1.1 KiB

BIN
doc/tool-highlighter-okular.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 1.5 KiB

BIN
doc/tool-ink-okular.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 1.7 KiB

BIN
doc/tool-line-okular.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 849 B

BIN
doc/tool-note-inline-okular.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 803 B

BIN
doc/tool-note-okular.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 973 B

BIN
doc/tool-polygon-okular.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 664 B

BIN
doc/tool-stamp-okular.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 1 KiB

BIN
doc/tool-underline-okular.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 629 B