Changeset View
Changeset View
Standalone View
Standalone View
doc/index.docbook
1 | <?xml version="1.0" ?> | 1 | <?xml version="1.0" ?> | ||
---|---|---|---|---|---|
2 | <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [ | 2 | <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [ | ||
3 | <!ENTITY latex "L<superscript>A</superscript>T<subscript>E</subscript>X"> | 3 | <!ENTITY latex "L<superscript>A</superscript>T<subscript>E</subscript>X"> | ||
4 | <!ENTITY kpdf "<application>KPDF</application>"> | 4 | <!ENTITY kpdf "<application>KPDF</application>"> | ||
5 | <!ENTITY % English "INCLUDE"> | 5 | <!ENTITY % English "INCLUDE"> | ||
6 | <!ENTITY % addindex "IGNORE"> | 6 | <!ENTITY % addindex "IGNORE"> | ||
7 | ]> | 7 | ]> | ||
8 | <!-- TODO | 8 | <!-- TODO | ||
9 | add chapter about navigation panel | 9 | add chapter about navigation panel | ||
10 | Show/Hide Contens/Thumbnails/Reviews/Bookmarks bar to save screen space | 10 | Show/Hide Contens/Thumbnails/Annotations/Bookmarks bar to save screen space | ||
11 | Use Small Icons and deselect Show Text to minimize the navigation panel | 11 | Use Small Icons and deselect Show Text to minimize the navigation panel | ||
12 | Describe all actions only possible in the navigation bars: | 12 | Describe all actions only possible in the navigation bars: | ||
13 | Switching between documents using bookmarks | 13 | Switching between documents using bookmarks | ||
14 | Context menu actions like Rename Bookmarks etc.) | 14 | Context menu actions like Rename Bookmarks etc.) | ||
15 | --> | 15 | --> | ||
16 | <book id="okular" lang="&language;"> | 16 | <book id="okular" lang="&language;"> | ||
17 | <bookinfo> | 17 | <bookinfo> | ||
18 | <title>The &okular; Handbook</title> | 18 | <title>The &okular; Handbook</title> | ||
▲ Show 20 Lines • Show All 153 Lines • ▼ Show 20 Line(s) | 171 | <para> | |||
172 | If the document has bookmarks, enable the <guilabel>Bookmarks</guilabel> view | 172 | If the document has bookmarks, enable the <guilabel>Bookmarks</guilabel> view | ||
173 | and click them to go to the associated page. | 173 | and click them to go to the associated page. | ||
174 | If bookmarks are not only shown for the current document, you can quickly | 174 | If bookmarks are not only shown for the current document, you can quickly | ||
175 | switch to bookmarks in all recently opened files. | 175 | switch to bookmarks in all recently opened files. | ||
176 | </para> | 176 | </para> | ||
177 | </listitem> | 177 | </listitem> | ||
178 | <listitem> | 178 | <listitem> | ||
179 | <para> | 179 | <para> | ||
180 | If the document has annotations, enable the <guilabel>Reviews</guilabel> view | 180 | If the document has annotations, enable the <guilabel>Annotations</guilabel> view | ||
181 | 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. | 181 | 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. | ||
182 | </para> | 182 | </para> | ||
183 | </listitem> | 183 | </listitem> | ||
184 | </itemizedlist> | 184 | </itemizedlist> | ||
185 | <para> | 185 | <para> | ||
186 | Some documents have links. In this case you can click on them and the view will | 186 | Some documents have links. In this case you can click on them and the view will | ||
187 | change to the page it links to. If the link is to a web page or some | 187 | change to the page it links to. If the link is to a web page or some | ||
188 | other document the default &kde; handler for that format will be invoked. | 188 | other document the default &kde; handler for that format will be invoked. | ||
▲ Show 20 Lines • Show All 297 Lines • ▼ Show 20 Line(s) | 474 | <sect1 id="annotations"> | |||
486 | <phrase>&okular;'s Annotations</phrase> | 486 | <phrase>&okular;'s Annotations</phrase> | ||
487 | </textobject> | 487 | </textobject> | ||
488 | </mediaobject> | 488 | </mediaobject> | ||
489 | </screenshot> | 489 | </screenshot> | ||
490 | <para>&okular; has two different kind of annotations:</para> | 490 | <para>&okular; has two different kind of annotations:</para> | ||
491 | <para>Text annotations like <guilabel>Yellow Highlighter</guilabel> and <guilabel>Black Underlining</guilabel> | 491 | <para>Text annotations like <guilabel>Yellow Highlighter</guilabel> and <guilabel>Black Underlining</guilabel> | ||
492 | for files with text like ⪚ &PDF;.</para> | 492 | for files with text like ⪚ &PDF;.</para> | ||
493 | <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> | 493 | <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> | ||
494 | <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> | 494 | <para>Using the context menu either in the <guilabel>Annotations</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> | ||
495 | <para>Annotations are not only limited to &PDF; files, they can be used for any format &okular; supports.</para> | 495 | <para>Annotations are not only limited to &PDF; files, they can be used for any format &okular; supports.</para> | ||
496 | <para> | 496 | <para> | ||
497 | &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 ⪚ a &PDF; document. | 497 | &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 ⪚ a &PDF; document. | ||
498 | </para> | 498 | </para> | ||
499 | <para> | 499 | <para> | ||
500 | 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. | 500 | 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. | ||
501 | </para> | 501 | </para> | ||
502 | <note> | 502 | <note> | ||
503 | <para> | 503 | <para> | ||
504 | Due to DRM limitations (typically with &PDF; documents), adding, editing some properties | 504 | Due to DRM limitations (typically with &PDF; documents), adding, editing some properties | ||
505 | or removing annotations could not be possible. | 505 | or removing annotations could not be possible. | ||
506 | </para> | 506 | </para> | ||
507 | </note> | 507 | </note> | ||
508 | <note> | 508 | <note> | ||
509 | <para> | 509 | <para> | ||
510 | 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>. | 510 | 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>. | ||
511 | </para> | 511 | </para> | ||
512 | </note> | 512 | </note> | ||
513 | <para> | 513 | <para> | ||
514 | 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>. | 514 | 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>. | ||
515 | </para> | 515 | </para> | ||
516 | <sect2 id="annotations-add"> | 516 | <sect2 id="annotations-add"> | ||
517 | <title>Adding annotations</title> | 517 | <title>Adding annotations</title> | ||
518 | <para> | 518 | <para> | ||
519 | To add some annotations to the document, you have to activate the annotating toolbar. | 519 | To add some annotations to the document, you have to use <guilabel>Quick Annotations</guilabel> button on the main &okular; toolbar or activate the annotating toolbar. | ||
520 | This is done by either selecting | 520 | This is done by either selecting | ||
521 | <menuchoice><guimenu>Tools</guimenu><guimenuitem>Review</guimenuitem></menuchoice> or | 521 | <menuchoice><guimenu>Tools</guimenu><guimenuitem>Annotations</guimenuitem></menuchoice> or | ||
522 | pressing <keycap>F6</keycap>. Once the annotating toolbar is shown, just press one of | 522 | pressing <keycap>F6</keycap>. Once the annotating toolbar is shown, just press one of | ||
523 | its buttons or use keyboard shortcuts (keys from <keycap>1</keycap> to <keycap>9</keycap>) to start constructing that annotation. | 523 | its buttons or use keyboard shortcuts (keys from <keycap>1</keycap> to <keycap>9</keycap>) to start constructing that annotation. | ||
524 | </para> | 524 | </para> | ||
525 | <para> | 525 | <para> | ||
526 | 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 (⪚ add lines, ellipses, polygons, stamps, highlights, underlines &etc;). The table below describes exactly what the default set of annotating toolbar buttons does. | 526 | 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 (⪚ add lines, ellipses, polygons, stamps, highlights, underlines &etc;). The table below describes exactly what the default set of annotating toolbar buttons does. | ||
527 | </para> | 527 | </para> | ||
528 | <informaltable> | 528 | <informaltable> | ||
529 | <tgroup cols="3"> | 529 | <tgroup cols="3"> | ||
Show All 11 Lines | 540 | </entry> | |||
541 | </row> | 541 | </row> | ||
542 | </thead> | 542 | </thead> | ||
543 | <tbody> | 543 | <tbody> | ||
544 | <row> | 544 | <row> | ||
545 | <entry> | 545 | <entry> | ||
546 | <para> | 546 | <para> | ||
547 | <inlinemediaobject> | 547 | <inlinemediaobject> | ||
548 | <imageobject> | 548 | <imageobject> | ||
549 | <imagedata fileref="tool-note-okular.png" format="PNG"/> | 549 | <imagedata fileref="tool-draw-highlight.png" format="PNG"/> | ||
550 | </imageobject> | 550 | </imageobject> | ||
551 | </inlinemediaobject> | 551 | </inlinemediaobject> | ||
552 | </para> | 552 | </para> | ||
553 | </entry> | 553 | </entry> | ||
554 | <entry> | 554 | <entry> | ||
555 | <para> | 555 | <para> | ||
556 | Pop-up Note | 556 | Highlighter | ||
557 | </para> | 557 | </para> | ||
558 | </entry> | 558 | </entry> | ||
559 | <entry> | 559 | <entry> | ||
560 | <para> | 560 | <para> | ||
561 | To draw multiline note. The note will can be viewed by double clicking on an icon in the document. | 561 | To highlight text in the document with some given background color. | ||
562 | </para> | 562 | </para> | ||
563 | <para> | 563 | <para> | ||
564 | 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. | 564 | 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. | ||
565 | </para> | 565 | </para> | ||
566 | <para> | 566 | <para> | ||
567 | 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. | 567 | 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. | ||
568 | </para> | 568 | </para> | ||
569 | </entry> | 569 | </entry> | ||
570 | </row> | 570 | </row> | ||
571 | <row> | 571 | <row> | ||
572 | <entry> | 572 | <entry> | ||
573 | <para> | 573 | <para> | ||
574 | <inlinemediaobject> | 574 | <inlinemediaobject> | ||
575 | <imageobject> | 575 | <imageobject> | ||
576 | <imagedata fileref="tool-note-inline-okular.png" format="PNG"/> | 576 | <imagedata fileref="tool-format-text-underline.png" format="PNG"/> | ||
577 | </imageobject> | ||||
578 | </inlinemediaobject> | ||||
579 | </para> | ||||
580 | </entry> | ||||
581 | <entry> | ||||
582 | <para> | ||||
583 | Underline | ||||
584 | </para> | ||||
585 | </entry> | ||||
586 | <entry> | ||||
587 | <para> | ||||
588 | To underline some text. | ||||
589 | </para> | ||||
590 | <para> | ||||
591 | 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. | ||||
592 | </para> | ||||
593 | <para> | ||||
594 | 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. | ||||
595 | </para> | ||||
596 | </entry> | ||||
597 | </row> | ||||
598 | <row> | ||||
599 | <entry> | ||||
600 | <para> | ||||
601 | <inlinemediaobject> | ||||
602 | <imageobject> | ||||
603 | <imagedata fileref="tool-format-text-underline-squiggle.png" format="PNG"/> | ||||
604 | </imageobject> | ||||
605 | </inlinemediaobject> | ||||
606 | </para> | ||||
607 | </entry> | ||||
608 | <entry> | ||||
609 | <para> | ||||
610 | Squiggle | ||||
611 | </para> | ||||
612 | </entry> | ||||
613 | <entry> | ||||
614 | <para> | ||||
615 | To underline some text by a squiggle line. | ||||
616 | </para> | ||||
617 | <para> | ||||
618 | 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. | ||||
619 | </para> | ||||
620 | <para> | ||||
621 | 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. | ||||
622 | </para> | ||||
623 | </entry> | ||||
624 | </row> | ||||
625 | <row> | ||||
626 | <entry> | ||||
627 | <para> | ||||
628 | <inlinemediaobject> | ||||
629 | <imageobject> | ||||
630 | <imagedata fileref="tool-format-text-strikethrough.png" format="PNG"/> | ||||
631 | </imageobject> | ||||
632 | </inlinemediaobject> | ||||
633 | </para> | ||||
634 | </entry> | ||||
635 | <entry> | ||||
636 | <para> | ||||
637 | Strike Out | ||||
638 | </para> | ||||
639 | </entry> | ||||
640 | <entry> | ||||
641 | <para> | ||||
642 | To strike out some text. | ||||
643 | </para> | ||||
644 | <para> | ||||
645 | 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. | ||||
646 | </para> | ||||
647 | <para> | ||||
648 | 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. | ||||
649 | </para> | ||||
650 | </entry> | ||||
651 | </row> | ||||
652 | <row> | ||||
653 | <entry> | ||||
654 | <para> | ||||
655 | <inlinemediaobject> | ||||
656 | <imageobject> | ||||
657 | <imagedata fileref="tool-tool-text.png" format="PNG"/> | ||||
658 | </imageobject> | ||||
659 | </inlinemediaobject> | ||||
660 | </para> | ||||
661 | </entry> | ||||
662 | <entry> | ||||
663 | <para> | ||||
664 | Typewriter | ||||
665 | </para> | ||||
666 | </entry> | ||||
667 | <entry> | ||||
668 | <para> | ||||
669 | Typewriter features opaque letters on transparent background, so that it is useful to fill noninteractive forms. | ||||
670 | </para> | ||||
671 | <para> | ||||
672 | 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. | ||||
673 | </para> | ||||
674 | <para> | ||||
675 | 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. | ||||
676 | </para> | ||||
677 | </entry> | ||||
678 | </row> | ||||
679 | <row> | ||||
680 | <entry> | ||||
681 | <para> | ||||
682 | <inlinemediaobject> | ||||
683 | <imageobject> | ||||
684 | <imagedata fileref="tool-note.png" format="PNG"/> | ||||
577 | </imageobject> | 685 | </imageobject> | ||
578 | </inlinemediaobject> | 686 | </inlinemediaobject> | ||
579 | </para> | 687 | </para> | ||
580 | </entry> | 688 | </entry> | ||
581 | <entry> | 689 | <entry> | ||
582 | <para> | 690 | <para> | ||
583 | Inline Note | 691 | Inline Note | ||
584 | </para> | 692 | </para> | ||
Show All 10 Lines | 694 | <entry> | |||
595 | </para> | 703 | </para> | ||
596 | </entry> | 704 | </entry> | ||
597 | </row> | 705 | </row> | ||
598 | <row> | 706 | <row> | ||
599 | <entry> | 707 | <entry> | ||
600 | <para> | 708 | <para> | ||
601 | <inlinemediaobject> | 709 | <inlinemediaobject> | ||
602 | <imageobject> | 710 | <imageobject> | ||
603 | <imagedata fileref="tool-ink-okular.png" format="PNG"/> | 711 | <imagedata fileref="tool-edit-comment.png" format="PNG"/> | ||
712 | </imageobject> | ||||
713 | </inlinemediaobject> | ||||
714 | </para> | ||||
715 | </entry> | ||||
716 | <entry> | ||||
717 | <para> | ||||
718 | Pop-up Note | ||||
719 | </para> | ||||
720 | </entry> | ||||
721 | <entry> | ||||
722 | <para> | ||||
723 | To draw multiline note. The note will can be viewed by double clicking on an icon in the document. | ||||
724 | </para> | ||||
725 | <para> | ||||
726 | 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. | ||||
727 | </para> | ||||
728 | <para> | ||||
729 | 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. | ||||
730 | </para> | ||||
731 | </entry> | ||||
732 | </row> | ||||
733 | <row> | ||||
734 | <entry> | ||||
735 | <para> | ||||
736 | <inlinemediaobject> | ||||
737 | <imageobject> | ||||
738 | <imagedata fileref="tool-draw-freehand.png" format="PNG"/> | ||||
604 | </imageobject> | 739 | </imageobject> | ||
605 | </inlinemediaobject> | 740 | </inlinemediaobject> | ||
606 | </para> | 741 | </para> | ||
607 | </entry> | 742 | </entry> | ||
608 | <entry> | 743 | <entry> | ||
609 | <para> | 744 | <para> | ||
610 | Freehand Line | 745 | Freehand Line | ||
611 | </para> | 746 | </para> | ||
Show All 10 Lines | 748 | <entry> | |||
622 | </para> | 757 | </para> | ||
623 | </entry> | 758 | </entry> | ||
624 | </row> | 759 | </row> | ||
625 | <row> | 760 | <row> | ||
626 | <entry> | 761 | <entry> | ||
627 | <para> | 762 | <para> | ||
628 | <inlinemediaobject> | 763 | <inlinemediaobject> | ||
629 | <imageobject> | 764 | <imageobject> | ||
630 | <imagedata fileref="tool-highlighter-okular.png" format="PNG"/> | 765 | <imagedata fileref="tool-draw-arrow.png" format="PNG"/> | ||
631 | </imageobject> | 766 | </imageobject> | ||
632 | </inlinemediaobject> | 767 | </inlinemediaobject> | ||
633 | </para> | 768 | </para> | ||
634 | </entry> | 769 | </entry> | ||
635 | <entry> | 770 | <entry> | ||
636 | <para> | 771 | <para> | ||
637 | Highlighter | 772 | Arrow (drop-down list) | ||
638 | </para> | 773 | </para> | ||
639 | </entry> | 774 | </entry> | ||
640 | <entry> | 775 | <entry> | ||
641 | <para> | 776 | <para> | ||
642 | To highlight text in the document with some given background color. | 777 | To mark with an arrow. | ||
643 | </para> | 778 | </para> | ||
644 | <para> | 779 | <para> | ||
645 | 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. | 780 | 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. | ||
646 | </para> | 781 | </para> | ||
647 | <para> | 782 | <para> | ||
648 | 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. | 783 | 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. | ||
649 | </para> | 784 | </para> | ||
650 | </entry> | 785 | </entry> | ||
651 | </row> | 786 | </row> | ||
652 | <row> | 787 | <row> | ||
653 | <entry> | 788 | <entry> | ||
654 | <para> | 789 | <para> | ||
655 | <inlinemediaobject> | 790 | <inlinemediaobject> | ||
656 | <imageobject> | 791 | <imageobject> | ||
657 | <imagedata fileref="tool-line-okular.png" format="PNG"/> | 792 | <imagedata fileref="tool-draw-line.png" format="PNG"/> | ||
658 | </imageobject> | 793 | </imageobject> | ||
659 | </inlinemediaobject> | 794 | </inlinemediaobject> | ||
660 | </para> | 795 | </para> | ||
661 | </entry> | 796 | </entry> | ||
662 | <entry> | 797 | <entry> | ||
663 | <para> | 798 | <para> | ||
664 | Straight Line | 799 | Straight line (drop-down list) | ||
665 | </para> | 800 | </para> | ||
666 | </entry> | 801 | </entry> | ||
667 | <entry> | 802 | <entry> | ||
668 | <para> | 803 | <para> | ||
669 | To mark with a line. | 804 | To mark with a line. | ||
670 | </para> | 805 | </para> | ||
671 | <para> | 806 | <para> | ||
672 | 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. | 807 | 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. | ||
673 | </para> | 808 | </para> | ||
674 | <para> | 809 | <para> | ||
675 | 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. | 810 | 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. | ||
676 | </para> | 811 | </para> | ||
677 | </entry> | 812 | </entry> | ||
678 | </row> | 813 | </row> | ||
679 | <row> | 814 | <row> | ||
680 | <entry> | 815 | <entry> | ||
681 | <para> | 816 | <para> | ||
682 | <inlinemediaobject> | 817 | <inlinemediaobject> | ||
683 | <imageobject> | 818 | <imageobject> | ||
684 | <imagedata fileref="tool-polygon-okular.png" format="PNG"/> | 819 | <imagedata fileref="tool-draw-rectangle.png" format="PNG"/> | ||
820 | </imageobject> | ||||
821 | </inlinemediaobject> | ||||
822 | </para> | ||||
823 | </entry> | ||||
824 | <entry> | ||||
825 | <para> | ||||
826 | Rectangle (drop-down list) | ||||
827 | </para> | ||||
828 | </entry> | ||||
829 | <entry> | ||||
830 | <para> | ||||
831 | To draw a rectangle around some chosen area. | ||||
832 | </para> | ||||
833 | <para> | ||||
834 | Click on the tool button, then click with the &LMB; and hold to place the top-left corner of the rectangle, then drag to place the bottom-right one. | ||||
835 | </para> | ||||
836 | <para> | ||||
837 | 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. | ||||
838 | </para> | ||||
839 | </entry> | ||||
840 | </row> | ||||
841 | <row> | ||||
842 | <entry> | ||||
843 | <para> | ||||
844 | <inlinemediaobject> | ||||
845 | <imageobject> | ||||
846 | <imagedata fileref="tool-draw-ellipse.png" format="PNG"/> | ||||
685 | </imageobject> | 847 | </imageobject> | ||
686 | </inlinemediaobject> | 848 | </inlinemediaobject> | ||
687 | </para> | 849 | </para> | ||
688 | </entry> | 850 | </entry> | ||
689 | <entry> | 851 | <entry> | ||
690 | <para> | 852 | <para> | ||
691 | Polygon | 853 | Ellipse (drop-down list) | ||
854 | </para> | ||||
855 | </entry> | ||||
856 | <entry> | ||||
857 | <para> | ||||
858 | To draw an ellipse or rectangle around some chosen area. | ||||
859 | </para> | ||||
860 | <para> | ||||
861 | 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. | ||||
862 | </para> | ||||
863 | <para> | ||||
864 | 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. | ||||
865 | </para> | ||||
866 | </entry> | ||||
867 | </row> | ||||
868 | <row> | ||||
869 | <entry> | ||||
870 | <para> | ||||
871 | <inlinemediaobject> | ||||
872 | <imageobject> | ||||
873 | <imagedata fileref="tool-draw-polyline.png" format="PNG"/> | ||||
874 | </imageobject> | ||||
875 | </inlinemediaobject> | ||||
876 | </para> | ||||
877 | </entry> | ||||
878 | <entry> | ||||
879 | <para> | ||||
880 | Polygon (drop-down list) | ||||
692 | </para> | 881 | </para> | ||
693 | </entry> | 882 | </entry> | ||
694 | <entry> | 883 | <entry> | ||
695 | <para> | 884 | <para> | ||
696 | To draw a closed plane figure from three or more segments. The corresponding note can be viewed by double clicking inside the polygon. | 885 | To draw a closed plane figure from three or more segments. The corresponding note can be viewed by double clicking inside the polygon. | ||
697 | </para> | 886 | </para> | ||
698 | <para> | 887 | <para> | ||
699 | 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. | 888 | 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. | ||
700 | </para> | 889 | </para> | ||
701 | <para> | 890 | <para> | ||
702 | 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. | 891 | 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. | ||
703 | </para> | 892 | </para> | ||
704 | </entry> | 893 | </entry> | ||
705 | </row> | 894 | </row> | ||
706 | <row> | 895 | <row> | ||
707 | <entry> | 896 | <entry> | ||
708 | <para> | 897 | <para> | ||
709 | <inlinemediaobject> | 898 | <inlinemediaobject> | ||
710 | <imageobject> | 899 | <imageobject> | ||
711 | <imagedata fileref="tool-stamp-okular.png" format="PNG"/> | 900 | <imagedata fileref="tool-tag.png" format="PNG"/> | ||
712 | </imageobject> | 901 | </imageobject> | ||
713 | </inlinemediaobject> | 902 | </inlinemediaobject> | ||
714 | </para> | 903 | </para> | ||
715 | </entry> | 904 | </entry> | ||
716 | <entry> | 905 | <entry> | ||
717 | <para> | 906 | <para> | ||
718 | Stamp | 907 | Stamp | ||
719 | </para> | 908 | </para> | ||
720 | </entry> | 909 | </entry> | ||
721 | <entry> | 910 | <entry> | ||
722 | <para> | 911 | <para> | ||
723 | To mark the text or image with some predefined shape. | 912 | To mark the text or image with some predefined shape. | ||
724 | </para> | 913 | </para> | ||
725 | <para> | 914 | <para> | ||
726 | Click on the tool button then click with the &LMB; to place the stamp. | 915 | Click on the tool button to choose the stamp from the drop-down list then click with the &LMB; to place the stamp. | ||
727 | </para> | 916 | </para> | ||
728 | <para> | 917 | <para> | ||
729 | A single click just places a square stamp (useful for icons). | 918 | A single click just places a square stamp (useful for icons). | ||
730 | 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. | 919 | 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. | ||
731 | </para> | 920 | </para> | ||
732 | <para> | 921 | <para> | ||
733 | 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. | 922 | 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. | ||
734 | </para> | 923 | </para> | ||
735 | <warning> | 924 | <warning> | ||
736 | <para> | 925 | <para> | ||
737 | This feature is experimental. Custom stamps inserted in &PDF; documents are not visible in &PDF; readers other than &okular;. | 926 | This feature is experimental. Custom stamps inserted in &PDF; documents are not visible in &PDF; readers other than &okular;. | ||
738 | </para> | 927 | </para> | ||
739 | </warning> | 928 | </warning> | ||
740 | </entry> | 929 | </entry> | ||
741 | </row> | 930 | </row> | ||
931 | </tbody> | ||||
932 | </tgroup> | ||||
933 | </informaltable> | ||||
934 | <para>These are the default annotations provided by &okular;. Using the <link linkend="configannotations">Annotations page</link> of the configuration dialog | ||||
935 | you can add your own annotations like custom stamps, text markup or a geometrical shape with inner color to highlight regions &etc; | ||||
936 | </para> | ||||
937 | <note> | ||||
938 | <para> | ||||
939 | 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. | ||||
940 | </para> | ||||
941 | </note> | ||||
942 | <para> | ||||
943 | It is possible to configure the current tool options using the annotating toolbar itself. The table below describes exactly what the default set of annotating toolbar configuring buttons does. | ||||
944 | </para> | ||||
945 | <informaltable> | ||||
946 | <tgroup cols="3"> | ||||
947 | <thead> | ||||
948 | <row> | ||||
949 | <entry> | ||||
950 | Button | ||||
951 | </entry> | ||||
952 | <entry> | ||||
953 | Option Name | ||||
954 | </entry> | ||||
955 | <entry> | ||||
956 | Description | ||||
957 | </entry> | ||||
958 | </row> | ||||
959 | </thead> | ||||
960 | <tbody> | ||||
742 | <row> | 961 | <row> | ||
743 | <entry> | 962 | <entry> | ||
744 | <para> | 963 | <para> | ||
745 | <inlinemediaobject> | 964 | <inlinemediaobject> | ||
746 | <imageobject> | 965 | <imageobject> | ||
747 | <imagedata fileref="tool-underline-okular.png" format="PNG"/> | 966 | <imagedata fileref="tool-edit-line-width.png" format="PNG"/> | ||
748 | </imageobject> | 967 | </imageobject> | ||
749 | </inlinemediaobject> | 968 | </inlinemediaobject> | ||
750 | </para> | 969 | </para> | ||
751 | </entry> | 970 | </entry> | ||
752 | <entry> | 971 | <entry> | ||
753 | <para> | 972 | <para> | ||
754 | Underline | 973 | Line width | ||
755 | </para> | 974 | </para> | ||
756 | </entry> | 975 | </entry> | ||
757 | <entry> | 976 | <entry> | ||
758 | <para> | 977 | <para> | ||
759 | To underline some text. | 978 | Click on the tool button to choose the width from the drop-down list. | ||
760 | </para> | 979 | </para> | ||
980 | </entry> | ||||
981 | </row> | ||||
982 | <row> | ||||
983 | <entry> | ||||
761 | <para> | 984 | <para> | ||
762 | 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. | 985 | <inlinemediaobject> | ||
986 | <imageobject> | ||||
987 | <imagedata fileref="tool-format-text-color.png" format="PNG"/> | ||||
988 | </imageobject> | ||||
989 | </inlinemediaobject> | ||||
990 | / | ||||
991 | <inlinemediaobject> | ||||
992 | <imageobject> | ||||
993 | <imagedata fileref="tool-bordertool.png" format="PNG"/> | ||||
994 | </imageobject> | ||||
995 | </inlinemediaobject> | ||||
996 | </para> | ||||
997 | </entry> | ||||
998 | <entry> | ||||
999 | <para> | ||||
1000 | Annotation color | ||||
763 | </para> | 1001 | </para> | ||
1002 | </entry> | ||||
1003 | <entry> | ||||
764 | <para> | 1004 | <para> | ||
765 | 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. | 1005 | Click on the tool button to choose color of text or border of your annotation. You can chose one of the predefined colors or click on the <guimenuitem>Custom Color...</guimenuitem> item to open the color selection dialog. | ||
766 | </para> | 1006 | </para> | ||
767 | </entry> | 1007 | </entry> | ||
768 | </row> | 1008 | </row> | ||
769 | <row> | 1009 | <row> | ||
770 | <entry> | 1010 | <entry> | ||
771 | <para> | 1011 | <para> | ||
772 | <inlinemediaobject> | 1012 | <inlinemediaobject> | ||
773 | <imageobject> | 1013 | <imageobject> | ||
774 | <imagedata fileref="tool-ellipse-okular.png" format="PNG"/> | 1014 | <imagedata fileref="tool-fill-color.png" format="PNG"/> | ||
775 | </imageobject> | 1015 | </imageobject> | ||
776 | </inlinemediaobject> | 1016 | </inlinemediaobject> | ||
777 | </para> | 1017 | </para> | ||
778 | </entry> | 1018 | </entry> | ||
779 | <entry> | 1019 | <entry> | ||
780 | <para> | 1020 | <para> | ||
781 | Ellipse | 1021 | Annotation fill color | ||
782 | </para> | 1022 | </para> | ||
783 | </entry> | 1023 | </entry> | ||
784 | <entry> | 1024 | <entry> | ||
785 | <para> | 1025 | <para> | ||
786 | To draw an ellipse or rectangle around some chosen area. | 1026 | Click on the tool button to choose a fill color of your annotation. You can chose one of the predefined colors or click on the <guimenuitem>Custom Color...</guimenuitem> item to open the color selection dialog. | ||
787 | </para> | 1027 | </para> | ||
1028 | </entry> | ||||
1029 | </row> | ||||
1030 | <row> | ||||
1031 | <entry> | ||||
788 | <para> | 1032 | <para> | ||
789 | 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. | 1033 | <inlinemediaobject> | ||
1034 | <imageobject> | ||||
1035 | <imagedata fileref="tool-edit-opacity.png" format="PNG"/> | ||||
1036 | </imageobject> | ||||
1037 | </inlinemediaobject> | ||||
790 | </para> | 1038 | </para> | ||
1039 | </entry> | ||||
1040 | <entry> | ||||
791 | <para> | 1041 | <para> | ||
792 | 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. | 1042 | Annotation opacity | ||
1043 | </para> | ||||
1044 | </entry> | ||||
1045 | <entry> | ||||
1046 | <para> | ||||
1047 | Click on the tool button to choose annotation level of opacity from the drop-down list (<guimenuitem>100%</guimenuitem> is for the opaque annotations). | ||||
793 | </para> | 1048 | </para> | ||
794 | </entry> | 1049 | </entry> | ||
795 | </row> | 1050 | </row> | ||
796 | <row> | 1051 | <row> | ||
797 | <entry> | 1052 | <entry> | ||
798 | <para> | 1053 | <para> | ||
799 | <inlinemediaobject> | 1054 | <inlinemediaobject> | ||
800 | <imageobject> | 1055 | <imageobject> | ||
801 | <imagedata fileref="tool-typewriter-okular.png" format="PNG"/> | 1056 | <imagedata fileref="tool-font-face.png" format="PNG"/> | ||
802 | </imageobject> | 1057 | </imageobject> | ||
803 | </inlinemediaobject> | 1058 | </inlinemediaobject> | ||
804 | </para> | 1059 | </para> | ||
805 | </entry> | 1060 | </entry> | ||
806 | <entry> | 1061 | <entry> | ||
807 | <para> | 1062 | <para> | ||
808 | Typewriter | 1063 | Annotation font | ||
809 | </para> | 1064 | </para> | ||
810 | </entry> | 1065 | </entry> | ||
811 | <entry> | 1066 | <entry> | ||
812 | <para> | 1067 | <para> | ||
813 | Typewriter features opaque letters on transparent background, so that it is useful to fill noninteractive forms. | 1068 | Click on the tool button to open the font selection dialog. | ||
814 | </para> | 1069 | </para> | ||
1070 | </entry> | ||||
1071 | </row> | ||||
1072 | <row> | ||||
1073 | <entry> | ||||
815 | <para> | 1074 | <para> | ||
816 | 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. | 1075 | <inlinemediaobject> | ||
1076 | <imageobject> | ||||
1077 | <imagedata fileref="tool-settings-configure.png" format="PNG"/> | ||||
1078 | </imageobject> | ||||
1079 | </inlinemediaobject> | ||||
817 | </para> | 1080 | </para> | ||
1081 | </entry> | ||||
1082 | <entry> | ||||
818 | <para> | 1083 | <para> | ||
819 | 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. | 1084 | Advanced settings for the current annotation tool | ||
1085 | </para> | ||||
1086 | </entry> | ||||
1087 | <entry> | ||||
1088 | <para> | ||||
1089 | Click on the tool button to open the general configuration dialog for your annotation. | ||||
820 | </para> | 1090 | </para> | ||
821 | </entry> | 1091 | </entry> | ||
822 | </row> | 1092 | </row> | ||
823 | </tbody> | 1093 | </tbody> | ||
824 | </tgroup> | 1094 | </tgroup> | ||
825 | </informaltable> | 1095 | </informaltable> | ||
826 | <para>These are the default annotations provided by &okular;. Using the <link linkend="configannotations">Annotations page</link> of the configuration dialog | 1096 | <para> | ||
827 | you can add your own annotations like custom stamps, text markup with <guilabel>Squiggle</guilabel> or <guilabel>Strike out</guilabel>, a geometrical shape | 1097 | There are three additional utility buttons on the default annotating toolbar. | ||
828 | like a <guilabel>Rectangle</guilabel> with inner color to highlight regions &etc; | 1098 | </para> | ||
1099 | <informaltable> | ||||
1100 | <tgroup cols="2"> | ||||
1101 | <thead> | ||||
1102 | <row> | ||||
1103 | <entry> | ||||
1104 | Button | ||||
1105 | </entry> | ||||
1106 | <entry> | ||||
1107 | Description | ||||
1108 | </entry> | ||||
1109 | </row> | ||||
1110 | </thead> | ||||
1111 | <tbody> | ||||
1112 | <row> | ||||
1113 | <entry> | ||||
1114 | <para> | ||||
1115 | <inlinemediaobject> | ||||
1116 | <imageobject> | ||||
1117 | <imagedata fileref="tool-favorite.png" format="PNG"/> | ||||
1118 | </imageobject> | ||||
1119 | </inlinemediaobject> | ||||
1120 | </para> | ||||
1121 | </entry> | ||||
1122 | <entry> | ||||
1123 | <para> | ||||
1124 | Add the current annotation to the <guilabel>Quick Annotations</guilabel> menu on the main toolbar. | ||||
829 | </para> | 1125 | </para> | ||
830 | <note> | 1126 | <note> | ||
831 | <para> | 1127 | <para> | ||
832 | 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. | 1128 | You can use the default shortcuts from <keycombo action="simul">&Alt;<keycap>9</keycap></keycombo> to <keycombo action="simul">&Alt;<keycap>0</keycap></keycombo> to select the quick annotation actions any time you like even with the annotating toolbar hidden. | ||
833 | </para> | 1129 | </para> | ||
834 | </note> | 1130 | </note> | ||
1131 | </entry> | ||||
1132 | </row> | ||||
1133 | <row> | ||||
1134 | <entry> | ||||
1135 | <para> | ||||
1136 | <inlinemediaobject> | ||||
1137 | <imageobject> | ||||
1138 | <imagedata fileref="tool-window-pin.png" format="PNG"/> | ||||
1139 | </imageobject> | ||||
1140 | </inlinemediaobject> | ||||
1141 | </para> | ||||
1142 | </entry> | ||||
1143 | <entry> | ||||
1144 | <para> | ||||
1145 | When checked keep the current annotation tool active after use. | ||||
1146 | </para> | ||||
1147 | </entry> | ||||
1148 | </row> | ||||
1149 | <row> | ||||
1150 | <entry> | ||||
1151 | <para> | ||||
1152 | <inlinemediaobject> | ||||
1153 | <imageobject> | ||||
1154 | <imagedata fileref="tool-dialog-close.png" format="PNG"/> | ||||
1155 | </imageobject> | ||||
1156 | </inlinemediaobject> | ||||
1157 | </para> | ||||
1158 | </entry> | ||||
1159 | <entry> | ||||
1160 | <para> | ||||
1161 | Hide the annotating toolbar. | ||||
1162 | </para> | ||||
1163 | </entry> | ||||
1164 | </row> | ||||
1165 | </tbody> | ||||
1166 | </tgroup> | ||||
1167 | </informaltable> | ||||
835 | <para> | 1168 | <para> | ||
836 | 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. | 1169 | 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. | ||
837 | </para> | 1170 | </para> | ||
838 | <para> | 1171 | <para> | ||
839 | With a single &LMB; click on an annotation tool button you can use a tool once. | 1172 | With a single &LMB; click on an annotation tool button you can use a tool once. | ||
840 | If you ⪚ want to highlight all important parts of a text, activate that tool | 1173 | If you ⪚ want to highlight all important parts of a text, activate that tool | ||
841 | permanently by double clicking on the tool button. | 1174 | permanently by double clicking on the tool button. | ||
842 | Press the <keycap>Esc</keycap> key or click the tool button again to leave the permanent mode. | 1175 | Press the <keycap>Esc</keycap> key or click the tool button again to leave the permanent mode. | ||
843 | </para> | 1176 | </para> | ||
844 | <note> | 1177 | <note> | ||
845 | <para> | 1178 | <para> | ||
846 | The annotating toolbar can be docked in any side of the viewing area: just drag it to | | |||
847 | move it to another place. | | |||
848 | </para> | | |||
849 | </note> | | |||
850 | <note> | | |||
851 | <para> | | |||
852 | Activating the annotating toolbar will make you switch to the Browse Mode. | 1179 | Activating the annotating toolbar will make you switch to the Browse Mode. | ||
853 | </para> | 1180 | </para> | ||
854 | </note> | 1181 | </note> | ||
855 | <para> | 1182 | <para> | ||
856 | You can stop the construction any time by pressing again on the button of the | 1183 | You can stop the construction any time by pressing again on the button of the | ||
857 | annotation you are constructing, or by pressing the &Esc; key. | 1184 | annotation you are constructing, or by pressing the &Esc; key. | ||
858 | </para> | 1185 | </para> | ||
859 | <para> | 1186 | <para> | ||
▲ Show 20 Lines • Show All 985 Lines • ▼ Show 20 Line(s) | 2171 | <listitem> | |||
1845 | <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> | 2172 | <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> | ||
1846 | </listitem> | 2173 | </listitem> | ||
1847 | </varlistentry> | 2174 | </varlistentry> | ||
1848 | <varlistentry> | 2175 | <varlistentry> | ||
1849 | <term> | 2176 | <term> | ||
1850 | <menuchoice> | 2177 | <menuchoice> | ||
1851 | <shortcut><keycap>F6</keycap></shortcut> | 2178 | <shortcut><keycap>F6</keycap></shortcut> | ||
1852 | <guimenu>Tools</guimenu> | 2179 | <guimenu>Tools</guimenu> | ||
1853 | <guimenuitem>Review</guimenuitem> | 2180 | <guimenuitem>Annotations</guimenuitem> | ||
1854 | </menuchoice> | 2181 | </menuchoice> | ||
1855 | </term> | 2182 | </term> | ||
1856 | <listitem> | 2183 | <listitem> | ||
1857 | <para><action>Open the review toolbar</action>. The review toolbar allows you to add | 2184 | <para><action>Open the annotating toolbar</action>. The annotating toolbar allows you to add | ||
1858 | annotations on the document you are reading. For more information, please see the | 2185 | annotations on the document you are reading. For more information, please see the | ||
1859 | section about <link linkend="annotations">Annotations</link>.</para> | 2186 | section about <link linkend="annotations">Annotations</link>.</para> | ||
1860 | </listitem> | 2187 | </listitem> | ||
1861 | </varlistentry> | 2188 | </varlistentry> | ||
1862 | <varlistentry> | 2189 | <varlistentry> | ||
1863 | <term> | 2190 | <term> | ||
1864 | <menuchoice> | 2191 | <menuchoice> | ||
1865 | <guimenu>Tools</guimenu> | 2192 | <guimenu>Tools</guimenu> | ||
▲ Show 20 Lines • Show All 724 Lines • Show Last 20 Lines |