<page xmlns="http://projectmallard.org/1.0/"
      xmlns:its="http://www.w3.org/2005/11/its"
      type="guide" style="task"
      id="annotations">

  <info>
    <link type="guide" xref="index#annotations"/>
    <desc>How to create and customize annotations.</desc>

    <revision pkgversion="3.2" version="0.1" date="2011-09-05" status="final"/>
    <revision pkgversion="3.26" version="0.2" date="2017-08-03" status="final"/>
    <credit type="author">
      <name>Tiffany Antopolski</name>
      <email>tiffany@antopolski.com</email>
    </credit>
    <credit type="author">
      <name>Andre Klapper</name>
      <email>ak-47@gmx.net</email>
    </credit>
    <license>
      <p>Creative Commons Share Alike 3.0</p>
    </license>

  </info>

<title>Adding annotations</title>
<p>
  An annotation is a note or comment added to a PDF document.  You can add annotations using the <app>document viewer</app>.
</p>
<p>
  When you open a file, you should have a side pane on the left side of the window.
  If you do not have a visible side pane, select the <gui style="button">Side pane</gui>
  button in the header bar, or press <key>F9</key> on the keyboard.
</p>

<p>
 At the top of this side pane, there is a drop-down menu with options like <gui>Thumbnails</gui>, <gui>Outline</gui> and <gui>Annotations</gui> (some of which may be <em>dimmed</em> for some documents).
</p>
<p>
 To create an annotation:
</p>
<steps>
 <item>
  <p>
    Select the <gui style="button">Annotate the document</gui> button from the header bar:
  </p>
    <media type="image" src="figures/add-text-annotation.png" its:translate="no"/>
    <list>
     <item>
      <p>
        You should now see <gui style="button">Note text</gui> and <gui style="button">Highlight text</gui> buttons below the header bar.
      </p>
     </item>
    </list>
 </item>
 <item>
  <p>
   Click on the first button to add a text annotation.
  </p>
 </item>
 <item>
  <p>
   Click on the spot in the document window you would like to add the annotation to.  Your <em>annotation</em> window will open.
  </p>
 </item>
 <item>
  <p>
    Type your text into the <em>annotation</em> window.
  </p>
   <note>
    <p>
     You can resize the note by clicking and holding the left mouse button on one of the bottom corners of the note, and moving it around.
    </p>
   </note>
 </item>
 <item>
  <p>
    Close the note by clicking on the <gui>x</gui> in the top corner of the note.
  </p>
 </item>
</steps>


</page>
