lyx_mirror/lib/examples/Modules/PDF_Comments.lyx
Richard Kimberly Heck d302d6b20f Update docs
2024-01-11 11:06:40 -05:00

2271 lines
34 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

#LyX 2.4 created this file. For more info see https://www.lyx.org/
\lyxformat 620
\begin_document
\begin_header
\save_transient_properties true
\origin /systemlyxdir/examples/Modules/
\textclass scrartcl
\begin_preamble
% to be able to use all color settings of pdfcomment
\usepackage[svgnames,rgb]{xcolor}
% if pdflatex is used
\usepackage{ifpdf}
\ifpdf
% set fonts for nicer pdf view
\IfFileExists{lmodern.sty}
{\usepackage{lmodern}}{}
\fi % end if pdflatex is used
% Added by lyx2lyx
\setlength{\parskip}{\medskipamount}
\setlength{\parindent}{0pt}
\end_preamble
\options BCOR8mm,pagesize
\use_default_options false
\begin_modules
pdfcomment
\end_modules
\maintain_unincluded_children no
\language english
\language_package default
\inputencoding utf8
\fontencoding auto
\font_roman "default" "default"
\font_sans "default" "default"
\font_typewriter "default" "default"
\font_math "auto" "auto"
\font_default_family default
\use_non_tex_fonts false
\font_sc false
\font_roman_osf false
\font_sans_osf false
\font_typewriter_osf false
\font_sf_scale 100 100
\font_tt_scale 100 100
\use_microtype false
\use_dash_ligatures false
\graphics default
\default_output_format pdf2
\output_sync 0
\bibtex_command bibtex
\index_command default
\paperfontsize 12
\spacing single
\use_hyperref true
\pdf_title "Description of the module PDF Comments"
\pdf_author "Uwe Stöhr"
\pdf_subject "PDF comments"
\pdf_keywords "LyX, PDF comments, pdfcomment"
\pdf_bookmarks true
\pdf_bookmarksnumbered true
\pdf_bookmarksopen true
\pdf_bookmarksopenlevel 2
\pdf_breaklinks false
\pdf_pdfborder false
\pdf_colorlinks true
\pdf_backref false
\pdf_pdfusetitle false
\pdf_quoted_options "linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue, pdfpagelayout=OneColumn, pdfnewwindow=true, pdfstartview=XYZ, plainpages=false"
\papersize a4
\use_geometry false
\use_package amsmath 1
\use_package amssymb 1
\use_package cancel 1
\use_package esint 1
\use_package mathdots 1
\use_package mathtools 1
\use_package mhchem 1
\use_package stackrel 1
\use_package stmaryrd 1
\use_package undertilde 1
\cite_engine basic
\cite_engine_type default
\biblio_style plain
\use_bibtopic false
\use_indices false
\paperorientation portrait
\suppress_date true
\justification true
\use_refstyle 0
\use_minted 0
\use_lineno 0
\notefontcolor #0000ff
\index Index
\shortcut idx
\color #008000
\end_index
\secnumdepth 3
\tocdepth 2
\paragraph_separation indent
\paragraph_indentation default
\is_math_indent 0
\math_numbering_side default
\quotes_style english
\dynamic_quotes 0
\papercolumns 1
\papersides 1
\paperpagestyle default
\tablestyle default
\tracking_changes false
\output_changes false
\change_bars false
\postpone_fragile_content false
\html_math_output 0
\html_css_as_file 0
\html_be_strict false
\docbook_table_output 0
\docbook_mathml_prefix 1
\end_header
\begin_body
\begin_layout Standard
\begin_inset Flex PDF-Comment-Setup
status open
\begin_layout Plain Layout
color=yellow
\end_layout
\end_inset
\begin_inset Note Note
status collapsed
\begin_layout Plain Layout
This sets yellow as default color for new PDF comments,
see sec.
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "subsec:PDF-Comment-setup"
nolink "false"
\end_inset
for the description.
\end_layout
\end_inset
\end_layout
\begin_layout Title
Description of the module PDF Comments
\end_layout
\begin_layout Author
Uwe Stöhr
\end_layout
\begin_layout Standard
The \SpecialChar LaTeX
package
\series bold
pdfcomment
\series default
provides full access for PDF comments.
You can add normal comments as well as margin comments,
underlining etc..
You can also define a special layout for a comment which you can use several times in the document.
This document is only a excerpt of the documentation of
\series bold
pdfcomment
\series default
;
see its documentation for all information:
\begin_inset Newline newline
\end_inset
\begin_inset Flex URL
status open
\begin_layout Plain Layout
https://ctan.org/tex-archive/macros/latex/contrib/pdfcomment/doc/pdfcomment.pdf
\end_layout
\end_inset
\end_layout
\begin_layout Section
The different comment types
\end_layout
\begin_layout Standard
The different comment types are inserted using the menu
\family sans
Insert\SpecialChar menuseparator
Custom
\begin_inset space ~
\end_inset
Insets
\family default
.
You can select one of the following:
\end_layout
\begin_layout Subsection
PDF-Annotation
\end_layout
\begin_layout Standard
This is the standard PDF comment.
Here is an example:
\begin_inset Flex PDF-Annotation
status open
\begin_layout Plain Layout
This is a simple PDF-Annotation.
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Like for all PDF comment types you can add a lot of things to the option of the inset.
To insert the options inset,
set the cursor into the comment inset and use the menu
\family sans
Insert\SpecialChar menuseparator
PDF Comment Options
\family default
.
\end_layout
\begin_layout Standard
\begin_inset Note Greyedout
status open
\begin_layout Plain Layout
\series bold
Note:
\series default
All braces and brackets in comment options must be inserted as \SpecialChar TeX
code!
\end_layout
\end_inset
\begin_inset Newline newline
\end_inset
\end_layout
\begin_layout Standard
Here is an example PDF-Annotation where the author is set to
\begin_inset Quotes eld
\end_inset
Daisy Duck
\begin_inset Quotes erd
\end_inset
:
\begin_inset Flex PDF-Annotation
status open
\begin_layout Plain Layout
\begin_inset Argument 1
status collapsed
\begin_layout Plain Layout
author=
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
{
\end_layout
\end_inset
Daisy Duck
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
}
\end_layout
\end_inset
,color=
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
{
\end_layout
\end_inset
0.234 0.867 0.211
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
}
\end_layout
\end_inset
,voffset=8pt,opacity=0.5
\end_layout
\end_inset
This is an annotation with a complex option.
\end_layout
\end_inset
\end_layout
\begin_layout Standard
To avoid to write the same options like the author again and again,
you can define a so-called
\begin_inset Quotes eld
\end_inset
avatar
\begin_inset Quotes erd
\end_inset
for every person and/or comment layout.
See
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:Avatars"
nolink "false"
\end_inset
for further information.
\end_layout
\begin_layout Standard
For a full list of possible options,
please look at the
\series bold
pdfcomment
\series default
documentation.
\end_layout
\begin_layout Subsection
PDF-Circle
\end_layout
\begin_layout Standard
This will typeset a comment in form of a circle or ellipse.
Here is an example without any options:
\begin_inset Flex PDF-Circle
status open
\begin_layout Plain Layout
a simple circle comment
\end_layout
\end_inset
\end_layout
\begin_layout Standard
At the right side you see a large,
elliptical comment as example of a PDF-Circle with options.
\begin_inset Flex PDF-Circle
status open
\begin_layout Plain Layout
\begin_inset Argument 1
status collapsed
\begin_layout Plain Layout
id=1,color=blue,height=2.5cm,width=5.8cm,voffset=-2.8cm,hoffset=8cm,opacity=1.0,justification=right,icolor=
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
{
\end_layout
\end_inset
yellow
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
}
\end_layout
\end_inset
,linewidth=12pt,borderstyle=dashed,dashstyle=
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
{
\end_layout
\end_inset
10 5
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
}
\end_layout
\end_inset
\end_layout
\end_inset
a circle comment in form of a large ellipse
\end_layout
\end_inset
\begin_inset Newline newline
\end_inset
\begin_inset Newline newline
\end_inset
\begin_inset Newline newline
\end_inset
\end_layout
\begin_layout Subsection
PDF-Freetext
\end_layout
\begin_layout Standard
This will typeset a comment in form of a freely positioned box.
By using the option
\series bold
type=callout
\series default
the box will have an additional so called callout line,
to bind the box to a certain element of the page.
With the option
\series bold
type=typewriter
\series default
you can write a comment everywhere on the page with a virtual typewriter.
These PDF-Freetext annotations do have no frame and a transparent background for overwriting arbitrary parts of the page.
Here is an example in form of a yellow rectangle:
\begin_inset Flex PDF-Freetext
status open
\begin_layout Plain Layout
\begin_inset Argument 1
status collapsed
\begin_layout Plain Layout
height=3cm,type=freetext,subject={freetext},width=4.5cm,voffset=-3.2cm,hoffset=-3.2cm,opacity=0.9,justification=right
\end_layout
\end_inset
This is also a comment,
but it is a PDF-Freetext annotation.
\end_layout
\end_inset
\begin_inset Newline newline
\end_inset
\begin_inset Newline newline
\end_inset
\begin_inset Newline newline
\end_inset
\begin_inset Newline newline
\end_inset
\end_layout
\begin_layout Subsection
PDF-Line
\end_layout
\begin_layout Standard
This will typeset a comment in form of a line,
polyline or polygon.
Here is an example without any options:
\begin_inset Flex PDF-Line
status open
\begin_layout Plain Layout
a simple PDF-Line comment
\end_layout
\end_inset
\begin_inset Newline newline
\end_inset
\end_layout
\begin_layout Standard
As you can see a PDF-Line comment without options is useless.
\end_layout
\begin_layout Standard
The green arrow at the left side of this page is an example for a PDF-Line comment with options.
\begin_inset Flex PDF-Line
status open
\begin_layout Plain Layout
\begin_inset Argument 1
status collapsed
\begin_layout Plain Layout
type=line,opacity=1,line=
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
{
\end_layout
\end_inset
50 480 50 180
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
}
\end_layout
\end_inset
,color=green,icolor=blue,caption=top,linebegin=
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
{
\end_layout
\end_inset
/ROpenArrow
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
}
\end_layout
\end_inset
,lineend=
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
{
\end_layout
\end_inset
/OpenArrow
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
}
\end_layout
\end_inset
,linewidth=2bp,captionhoffset=-5pt,captionvoffset=15pt
\end_layout
\end_inset
a PDF-Line comment with options
\end_layout
\end_inset
\end_layout
\begin_layout Subsection
PDF-Margin
\end_layout
\begin_layout Standard
This will typeset an annotation into the margin.
Right besides this text is an example without options:
\begin_inset Flex PDF-Margin
status open
\begin_layout Plain Layout
a simple PDF-Margin comment
\end_layout
\end_inset
\end_layout
\begin_layout Standard
The red margin note is an example for a PDF-Margin with options.
\begin_inset Flex PDF-Margin
status open
\begin_layout Plain Layout
\begin_inset Argument 1
status collapsed
\begin_layout Plain Layout
icon=Note,color=red,open=true,hspace=100pt
\end_layout
\end_inset
a PDF-Margin comment with options
\end_layout
\end_inset
\end_layout
\begin_layout Subsection
PDF-Markup
\end_layout
\begin_layout Standard
This will typeset so called PDF text markup annotations over some text or math.
Here is a markup without options:
\begin_inset Flex PDF-Markup
status open
\begin_layout Plain Layout
simple PDF-Markup
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Possible types for the option
\series bold
markup
\series default
are:
\end_layout
\begin_layout Description
Highlight The markup text will be highlighted:
\begin_inset Flex PDF-Markup
status open
\begin_layout Plain Layout
\begin_inset Argument 1
status open
\begin_layout Plain Layout
\begin_inset Note Note
status open
\begin_layout Plain Layout
id=1,
\end_layout
\end_inset
markup=Highlight
\end_layout
\end_inset
Highlight PDF-Markup
\begin_inset Argument post:1
status open
\begin_layout Plain Layout
a comment
\end_layout
\end_inset
\end_layout
\end_inset
\begin_inset Note Note
status collapsed
\begin_layout Plain Layout
see the next section for the description of the option
\series bold
id=1
\end_layout
\end_inset
\end_layout
\begin_layout Description
Underline The markup text will be underlined:
\begin_inset Flex PDF-Markup
status open
\begin_layout Plain Layout
\begin_inset Argument 1
status open
\begin_layout Plain Layout
markup=Underline
\end_layout
\end_inset
Underlining PDF-Markup
\end_layout
\end_inset
\end_layout
\begin_layout Description
Squiggly The markup text will be underlined with a wave:
\begin_inset Flex PDF-Markup
status open
\begin_layout Plain Layout
\begin_inset Argument 1
status open
\begin_layout Plain Layout
markup=Squiggly
\end_layout
\end_inset
Underwave PDF-Markup
\end_layout
\end_inset
\end_layout
\begin_layout Description
StrikeOut The markup text will be struck-out:
\begin_inset Flex PDF-Markup
status open
\begin_layout Plain Layout
\begin_inset Argument 1
status open
\begin_layout Plain Layout
markup=StrikeOut
\end_layout
\end_inset
Striked-out PDF-Markup
\end_layout
\end_inset
\end_layout
\begin_layout Description
mathpopup Formula parts will be highlighted.
\series bold
\series default
\begin_inset Note Greyedout
status open
\begin_layout Plain Layout
\series bold
Note:
\series default
The PDF-Markup inset cannot be used for this option!
\end_layout
\end_inset
Instead the command
\series bold
\backslash
pdfmarkupcomment
\series default
woll be used in a formula with this scheme:
\begin_inset Newline newline
\end_inset
Command:
\begin_inset Newline newline
\end_inset
\series bold
\backslash
pdfmarkupcomment[style=mathpopup]
\backslash
{formula part}
\begin_inset Formula $\to$
\end_inset
\backslash
{
\backslash
text
\begin_inset space \textvisiblespace{}
\end_inset
\begin_inset Newline newline
\end_inset
optional comment}
\begin_inset Newline newline
\end_inset
\series default
Result:
\end_layout
\begin_layout Standard
\begin_inset Formula
\[
\pdfmarkupcomment[style=mathpopup]{\sum_{i=1}^{n}i=\frac{1}{2}n\cdot(n+1)}{\text{little Gauss}}
\]
\end_inset
\end_layout
\begin_layout Standard
The text for the comment is inserted with the inset option
\family sans
Comment
\family default
.
\end_layout
\begin_layout Standard
PDF-Markup has some limitations:
\end_layout
\begin_layout Itemize
the markup text must not be longer than one paragraph
\end_layout
\begin_layout Itemize
the markup annotation must not be longer than one page,
otherwise the recognition of the page break will fail
\end_layout
\begin_layout Itemize
when using Xe\SpecialChar TeX
you have to assure that the page dimensions are internally output,
e.
\begin_inset space \thinspace{}
\end_inset
g.
\begin_inset space \space{}
\end_inset
with the document class option
\series bold
pagesize
\series default
for the KOMA-Script classes,
or the option
\series bold
pagesize
\series default
for the \SpecialChar LaTeX
-package
\series bold
typearea
\series default
.
\end_layout
\begin_layout Subsection
PDF-Reply
\end_layout
\begin_layout Standard
\begin_inset Note Greyedout
status open
\begin_layout Plain Layout
\series bold
Attention:
\series default
Due to technical limitations PDF-Reply only works when using pdflatex.
On some \SpecialChar LaTeX
installations it won't even work in general.
\end_layout
\end_inset
\end_layout
\begin_layout Standard
With a PDF-Reply you can compose replies to PDF comments.
The option
\series bold
replyto
\series default
provides a clear reference to the comment the reply refers to.
\end_layout
\begin_layout Standard
As example see the reply to the Highlight PDF-Markup from the previous section.
\begin_inset Note Note
status open
\begin_layout Plain Layout
\begin_inset Flex PDF-Reply
status open
\begin_layout Plain Layout
\begin_inset Argument 1
status open
\begin_layout Plain Layout
id=2,replyto=1,date=D:20101211161247+01'00'
\end_layout
\end_inset
This is a reply.
\end_layout
\end_inset
\end_layout
\end_inset
It appears in that PDF-Markup comment.
To be able to reference the PDF-Markup the option
\series bold
id=1
\series default
was added to its options.
The PDF-Reply got the option
\series bold
replyto=1
\series default
.
\end_layout
\begin_layout Standard
You can also reply to replies by adding an
\series bold
id
\series default
option to the reply that should be replied to.
As example see the reply to the reply to the PDF-Markup.
\begin_inset Note Note
status open
\begin_layout Plain Layout
\begin_inset Flex PDF-Reply
status open
\begin_layout Plain Layout
\begin_inset Argument 1
status open
\begin_layout Plain Layout
replyto=2,date=D:20101212095321+01'00'
\end_layout
\end_inset
Of course,
you can reply to a reply.
\end_layout
\end_inset
\end_layout
\end_inset
\end_layout
\begin_layout Standard
PDF-Reply has limitations:
\end_layout
\begin_layout Itemize
It can not support page breaks.
\end_layout
\begin_layout Itemize
The replies will only appear in the PDF annotations on the second page.
(Replies to comments without page break work smoothly.)
\end_layout
\begin_layout Subsection
PDF-Sideline
\end_layout
\begin_layout Standard
This will typeset a comment in form of identical markers on every side of the page.
The yellow arrows besides this text are an example of a PDF-Sideline without any options:
\begin_inset Flex PDF-Sideline
status open
\begin_layout Plain Layout
a simple PDF-Sideline
\end_layout
\end_inset
\end_layout
\begin_layout Standard
As you can see a PDF-Sideline comment without options is quite useless.
PDF-Sideline is useful if you want to highlight complete parts of a page.
The inset options define the layout of the marker while the normal content of the inset is the text surrounded by the markers.
The content of the inset option
\family sans
Comment
\family default
will be printed along both markers.
Here is an example:
\end_layout
\begin_layout Standard
\begin_inset Flex PDF-Sideline
status open
\begin_layout Plain Layout
\begin_inset Argument 1
status collapsed
\begin_layout Plain Layout
opacity=0.33,color=magenta,icolor=cyan,caption=inline,linebegin=
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
{
\end_layout
\end_inset
/Butt
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
}
\end_layout
\end_inset
,lineend=
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
{
\end_layout
\end_inset
/Square
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
}
\end_layout
\end_inset
,linewidth=3bp,linesep=0.7cm
\end_layout
\end_inset
Lorem ipsum dolor sit amet,
consetetur sadipscing elitr,
sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat,
sed diam voluptua.
At vero eos et accusam et justo duo dolores et ea rebum.
Stet clita kasd gubergren,
no sea takimata sanctus est Lorem ipsum dolor sit amet.
Lorem ipsum dolor sit amet,
consetetur sadipscing elitr,
sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat,
sed diam voluptua.
\end_layout
\begin_layout Plain Layout
At vero eos et accusam et justo duo dolores et ea rebum.
Stet clita kasd gubergren,
no sea takimata sanctus est Lorem ipsum dolor sit amet.
Lorem ipsum dolor sit amet,
consetetur sadipscing elitr,
sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat,
sed diam voluptua.
At vero eos et accusam et justo duo dolores et ea rebum.
Stet clita kasd gubergren,
no sea takimata sanctus est Lorem ipsum dolor sit amet.
\begin_inset Argument 2
status open
\begin_layout Plain Layout
Comment text
\end_layout
\end_inset
\end_layout
\end_inset
\end_layout
\begin_layout Standard
PDF-Sideline has some limitations:
\end_layout
\begin_layout Itemize
the comment should not be longer than one page,
otherwise the recognition of the page could fail
\end_layout
\begin_layout Itemize
when using Xe\SpecialChar TeX
you have to assure that the page dimensions are internally output,
e.
\begin_inset space \thinspace{}
\end_inset
g.
\begin_inset space \space{}
\end_inset
with the document class option
\series bold
pagesize
\series default
for the KOMA-Script classes,
or the option
\series bold
pagesize
\series default
for the \SpecialChar LaTeX
-package
\series bold
typearea
\series default
.
\end_layout
\begin_layout Subsection
PDF-Square
\end_layout
\begin_layout Standard
This will typeset a rectangular box.
Here is an example without any options:
\begin_inset Flex PDF-Square
status open
\begin_layout Plain Layout
a simple PDF-Square comment
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Below this text you see a rectangle comment with a curvy outline as example of a PDF-Square with options.
\end_layout
\begin_layout Standard
\begin_inset Flex PDF-Square
status open
\begin_layout Plain Layout
\begin_inset Argument 1
status collapsed
\begin_layout Plain Layout
height=2cm,width=4.8cm,voffset=-2cm,hoffset=1cm,opacity=1.0,justification=right,icolor=CornflowerBlue,bse=cloudy,bsei=2.5,linewidth=8pt
\end_layout
\end_inset
A fancy PDF-Square comment
\end_layout
\end_inset
\begin_inset Newline newline
\end_inset
\begin_inset Newline newline
\end_inset
\begin_inset Newline newline
\end_inset
\begin_inset Newline newline
\end_inset
\end_layout
\begin_layout Subsection
PDF-Tooltip
\end_layout
\begin_layout Standard
With this you can annotate any object with a tooltip.
\begin_inset Foot
status open
\begin_layout Plain Layout
All objects that can be set into a \SpecialChar TeX
-box to measure its size.
\end_layout
\end_inset
\end_layout
\begin_layout Standard
The PDF-Tooltip inset has a mandatory argument for the tooltip.
The object that should be annotated is set into the PDF-Tooltip inset,
the tooltip is written into the mandatory argument.
Here is as example of a word with a tooltip:
\begin_inset Flex PDF-Tooltip
status open
\begin_layout Plain Layout
\begin_inset Argument post:1
status open
\begin_layout Plain Layout
This is a tooltip!
\end_layout
\end_inset
\color red
word
\end_layout
\end_inset
\end_layout
\begin_layout Standard
Since a tooltip can be used for almost any object,
one can also use it for chemical notations in math:
\begin_inset Flex PDF-Tooltip
status open
\begin_layout Plain Layout
\begin_inset Argument post:1
status open
\begin_layout Plain Layout
Sulfuric acid
\end_layout
\end_inset
\begin_inset Formula $\ce{H2SO4}$
\end_inset
\end_layout
\end_inset
\end_layout
\begin_layout Standard
The PDF-Tooltip inset has also an option that is used to correct the size of the tooltip for math (if necessary) or to disable an annotation.
Here is an example with a mathstyle option:
\end_layout
\begin_layout Standard
\begin_inset Flex PDF-Tooltip
status open
\begin_layout Plain Layout
\begin_inset Argument 1
status open
\begin_layout Plain Layout
mathstyle=
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
\backslash
displaystyle
\end_layout
\end_inset
\end_layout
\end_inset
\begin_inset Argument post:1
status open
\begin_layout Plain Layout
little Gauß
\end_layout
\end_inset
\begin_inset Formula $\sum_{i=1}^{n}i=\frac{1}{2}n\cdot(n+1)$
\end_inset
\end_layout
\end_inset
\end_layout
\begin_layout Section
Comment definitions
\end_layout
\begin_layout Standard
The package
\series bold
pdfcomment
\series default
provides the following environments to define or change PDF comments:
\end_layout
\begin_layout Subsection
PDF-Comment setup
\begin_inset CommandInset label
LatexCommand label
name "subsec:PDF-Comment-setup"
\end_inset
\end_layout
\begin_layout Standard
With this custom inset you can reset the global (document-wide) options at any time.
For example the default color for new PDF comments is blue.
To get Adobe Reader's yellow colored notes for all comments in your document,
add the PDF comment setup inset to the beginning of your document and insert there the option
\series bold
color=yellow
\series default
.
This was also done in this document.
\end_layout
\begin_layout Standard
By using its optional option
\series bold
local
\series default
you can keep the reset local within a group enclosed by \SpecialChar TeX
-braces.
For example you want to reset the color only for two consecutive comments,
then enclose the PDF comment setup inset and the two comment insets in \SpecialChar TeX
-braces.
Here is an example:
\end_layout
\begin_layout Standard
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
{
\end_layout
\end_inset
\begin_inset Flex PDF-Comment-Setup
status open
\begin_layout Plain Layout
\begin_inset Argument 1
status open
\begin_layout Plain Layout
local
\end_layout
\end_inset
color=Orange
\end_layout
\end_inset
\begin_inset Flex PDF-Markup
status collapsed
\begin_layout Plain Layout
PDF-Markup in orange
\end_layout
\end_inset
\begin_inset space ~
\end_inset
\begin_inset space ~
\end_inset
\begin_inset space ~
\end_inset
\begin_inset Flex PDF-Annotation
status collapsed
\begin_layout Plain Layout
PDF-Annotation in orange
\end_layout
\end_inset
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
}
\end_layout
\end_inset
\begin_inset Flex PDF-Margin
status collapsed
\begin_layout Plain Layout
default PDF-Margin comment
\end_layout
\end_inset
\end_layout
\begin_layout Subsection
PDF Comment style
\end_layout
\begin_layout Standard
This environment allows you to define a style for a PDF comment that can be used by several comments.
Assuming you write a Math tutorial and want to add popup explanations in the PDF for several expressions,
then insert a PDF Comment style environment before your first formula.
Name it for example
\series bold
MathPopup
\series default
,
set the color to white with
\series bold
color=white
\series default
and highlight the whole formula with
\series bold
markup=Highlight
\series default
.
\end_layout
\begin_layout Define PDF-Comment Style
\begin_inset Argument 1
status open
\begin_layout Plain Layout
MathPopup
\end_layout
\end_inset
color=white,markup=Highlight
\end_layout
\begin_layout Standard
In the comments use the option
\series bold
style=MathPopup
\series default
to use your style.
Here is an example:
\end_layout
\begin_layout Standard
\begin_inset Flex PDF-Markup
status open
\begin_layout Plain Layout
\begin_inset Argument 1
status open
\begin_layout Plain Layout
\family roman
\series medium
\shape up
\size normal
\emph off
\bar no
\strikeout off
\uuline off
\uwave off
\noun off
\color none
style=
\family default
\series default
\shape default
\size default
\emph default
\bar default
\strikeout default
\uuline default
\uwave default
\noun default
\color inherit
MathPopup
\end_layout
\end_inset
\begin_inset Formula $P(E)$
\end_inset
\begin_inset Argument post:1
status open
\begin_layout Plain Layout
\family roman
\series medium
\shape up
\size normal
\emph off
\bar no
\strikeout off
\uuline off
\uwave off
\noun off
\color none
Probability of event E
\end_layout
\end_inset
\end_layout
\end_inset
\end_layout
\begin_layout Subsection
\begin_inset CommandInset label
LatexCommand label
name "sec:Avatars"
\end_inset
Avatars
\end_layout
\begin_layout Standard
If you are for example reviewing a document,
you need to add your name to every of your comments.
In case you use a special layout of your annotations,
you would have to do a lot of copy-paste work.
But this can be avoided if you define for every comment author a special avatar.
\end_layout
\begin_layout Standard
Assuming your name is
\begin_inset Quotes eld
\end_inset
Oleg Testman
\begin_inset Quotes erd
\end_inset
you can define an avatar for your name using the environment
\family sans
Define
\begin_inset space ~
\end_inset
Avatar
\family default
.
Its mandatory option is the name.
In your case,
name it
\series bold
Oleg
\series default
.
Add behind the name of the avatar your name as author by writing
\series bold
author={Oleg Testman}
\series default
.
\begin_inset Newline newline
\end_inset
You might use a special icon to see at the first look which comments were made by you.
You therefore add behind the author-statement,
separated by a comma,
\begin_inset Quotes eld
\end_inset
\series bold
icon=Check
\series default
\begin_inset Quotes erd
\end_inset
to get a checkmark.
\begin_inset Foot
status open
\begin_layout Plain Layout
For all possible icons,
see the
\series bold
pdfcomment
\series default
manual.
\end_layout
\end_inset
the checkmark should have a green color so that you add
\series bold
color=lime
\series default
to the avatar definition.
Your whole definition reads now
\begin_inset Newline newline
\end_inset
\series bold
author={Oleg Testman},icon=Check,color=lime
\end_layout
\begin_layout Define Avatar
\begin_inset Argument 1
status open
\begin_layout Plain Layout
Oleg
\end_layout
\end_inset
author={Oleg Testman},icon=Check,color=lime
\end_layout
\begin_layout Standard
To use now your avatar for PDF comments you have two choices:
\end_layout
\begin_layout Enumerate
You set up that all PDF comments in the document use your avatar.
This is done by inserting the custom inset
\family sans
PDF
\begin_inset space ~
\end_inset
Comment-Setup
\family default
before the first PDF comment in your document.
Insert to this inset
\series bold
avatar=Oleg
\series default
.
\end_layout
\begin_layout Enumerate
You add
\series bold
avatar=Oleg
\series default
to the options of a particular PDF comment.
The avatar will then only be used for this comment.
\end_layout
\begin_layout Standard
Here is an example for the
\family sans
PDF
\begin_inset space ~
\end_inset
Comment-Setup
\family default
method:
\begin_inset Flex PDF-Comment-Setup
status open
\begin_layout Plain Layout
avatar=Oleg
\end_layout
\end_inset
\begin_inset Flex PDF-Annotation
status open
\begin_layout Plain Layout
Oleg said:
Wow,
that's nice!
\end_layout
\end_inset
\begin_inset Newline newline
\end_inset
and here is another comment:
\begin_inset Flex PDF-Annotation
status open
\begin_layout Plain Layout
Oleg also said:
I hate to repeat myself.
\end_layout
\end_inset
\end_layout
\begin_layout Define Avatar
\begin_inset Argument 1
status open
\begin_layout Plain Layout
Dolittle
\end_layout
\end_inset
color=NavyBlue,opacity=0.5,open=false,icon=Circle,author={Dr.
Dolittle}
\end_layout
\begin_layout Standard
Here is an example where another avatar
\begin_inset Quotes eld
\end_inset
Dolittle
\begin_inset Quotes erd
\end_inset
is only used for this comment:
\begin_inset Flex PDF-Margin
status open
\begin_layout Plain Layout
\begin_inset Argument 1
status open
\begin_layout Plain Layout
avatar=Dolittle
\end_layout
\end_inset
I am Dr.
Dolittle!
Respect my authority!
\end_layout
\end_inset
\end_layout
\begin_layout Section
List of PDF comments
\end_layout
\begin_layout Standard
You can insert a list with all PDF comments using the environment
\family sans
List of PDF comments
\family default
.
By specifying options for it you can determine what parts of the comments should appear in the list.
Here is the list for this document where only the comments of a defined author are printed:
\end_layout
\begin_layout List of PDF Comments
\begin_inset Argument 1
status open
\begin_layout Plain Layout
liststyle=
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
{
\end_layout
\end_inset
AuthorComment
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
}
\end_layout
\end_inset
,
heading =
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
{
\end_layout
\end_inset
List of PDF comments
\begin_inset ERT
status collapsed
\begin_layout Plain Layout
}
\end_layout
\end_inset
\end_layout
\end_inset
\end_layout
\begin_layout Standard
You can also define your own style using the environment
\begin_inset Newline newline
\end_inset
\family sans
Define
\begin_inset space ~
\end_inset
PDF
\begin_inset space ~
\end_inset
Comment
\begin_inset space ~
\end_inset
List
\begin_inset space ~
\end_inset
Style
\begin_inset Newline newline
\end_inset
\family default
if you know enough about the tricky \SpecialChar LaTeX
internals.
With the environment
\begin_inset Newline newline
\end_inset
\family sans
Set
\begin_inset space ~
\end_inset
PDF
\begin_inset space ~
\end_inset
Comment
\begin_inset space ~
\end_inset
List
\begin_inset space ~
\end_inset
Style
\begin_inset Newline newline
\end_inset
\family default
you can set a list style.
\end_layout
\begin_layout Define PDF-Comment List Style
\begin_inset Argument 1
status open
\begin_layout Plain Layout
MyStyle
\end_layout
\end_inset
\backslash
makeatletter
\backslash
pc@lopt@author
\backslash
-
\backslash
pc@lopt@subject
\backslash
(
\backslash
pc@lopt@deadline)
\backslash
makeatother
\end_layout
\begin_layout Set PDF-Comment List Style
AuthorCommentDeadline
\end_layout
\begin_layout Standard
\begin_inset Note Greyedout
status open
\begin_layout Plain Layout
\series bold
Note:
\series default
Only one list of comments can be printed in the PDF.
\end_layout
\end_inset
\end_layout
\begin_layout Section
General Hints
\end_layout
\begin_layout Itemize
To be able to use all kinds of colors and color definitions you must load the \SpecialChar LaTeX
package
\series bold
xcolor
\series default
in the document preamble this way:
\begin_inset Newline newline
\end_inset
\series bold
\backslash
usepackage[svgnames,rgb]{xcolor}
\end_layout
\begin_layout Itemize
If you have two consecutive PDF
\begin_inset space ~
\end_inset
comment insets,
the will appear in the PDF one over each other:
\begin_inset Flex PDF-Comment-Setup
status open
\begin_layout Plain Layout
avatar=Oleg
\end_layout
\end_inset
\begin_inset Flex PDF-Annotation
status open
\begin_layout Plain Layout
Oleg said:
Wow,
that's nice!
\end_layout
\end_inset
\begin_inset Flex PDF-Annotation
status open
\begin_layout Plain Layout
Oleg also said:
I hate to repeat myself.
\end_layout
\end_inset
\begin_inset Newline newline
\end_inset
To avoid that separate them with whitespace like protected space:
\begin_inset Flex PDF-Annotation
status open
\begin_layout Plain Layout
Oleg said:
Wow,
that's nice!
\end_layout
\end_inset
\begin_inset space ~
\end_inset
\begin_inset space ~
\end_inset
\begin_inset space ~
\end_inset
\begin_inset space ~
\end_inset
\begin_inset space ~
\end_inset
\begin_inset space ~
\end_inset
\begin_inset space ~
\end_inset
\begin_inset Flex PDF-Annotation
status open
\begin_layout Plain Layout
Oleg also said:
I hate to repeat myself.
\end_layout
\end_inset
\end_layout
\begin_layout Itemize
You cannot use non-Latin characters in your comment or in the author name.
The reason is that PDFs use a special character encoding that is not compatible with \SpecialChar LaTeX
.
\end_layout
\end_body
\end_document