lyx_mirror/lib/examples/PDF-comment.lyx

1503 lines
23 KiB
Plaintext
Raw Normal View History

#LyX 2.1 created this file. For more info see http://www.lyx.org/
\lyxformat 474
\begin_document
\begin_header
\textclass scrartcl
\begin_preamble
\usepackage[svgnames,rgb]{xcolor}
\end_preamble
\options index=totoc,BCOR7.5mm,captions=tableheading
\use_default_options false
\begin_modules
pdfcomment
\end_modules
\maintain_unincluded_children false
\language english
\language_package default
\inputencoding auto
\fontencoding global
\font_roman default
\font_sans default
\font_typewriter default
\font_math auto
\font_default_family default
\use_non_tex_fonts false
\font_sc false
\font_osf false
\font_sf_scale 100
\font_tt_scale 100
\graphics default
\default_output_format default
\output_sync 0
\bibtex_command bibtex
\index_command default
\paperfontsize 12
\spacing single
\use_hyperref true
\pdf_title "Description of the module pdfcomment"
\pdf_author "Uwe Stöhr"
\pdf_subject "pdfcomment"
\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 a4paper
\use_geometry false
\use_package amsmath 1
\use_package amssymb 1
\use_package cancel 0
\use_package esint 1
\use_package mathdots 1
\use_package mathtools 0
\use_package mhchem 1
\use_package stackrel 0
\use_package stmaryrd 0
\use_package undertilde 0
\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
\notefontcolor #0000ff
\index Index
\shortcut idx
\color #008000
\end_index
\secnumdepth 3
\tocdepth 2
\paragraph_separation skip
\defskip medskip
\quotes_language english
\papercolumns 1
\papersides 1
\paperpagestyle default
\tracking_changes false
\output_changes false
\html_math_output 0
\html_css_as_file 0
\html_be_strict false
\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
Use yelow as default color for new PDF-comments, see sec.
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:PDF-Comment-setup"
\end_inset
for a description.
\end_layout
\end_inset
\end_layout
\begin_layout Title
Description of the module pdfcomment
\end_layout
\begin_layout Author
Uwe Stöhr
\end_layout
\begin_layout Standard
The 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.
And you can also define a special layout for the comment that 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
http://mirrors.ctan.org/macros/latex/contrib/pdfcomment/doc/pdfcomment.pdf
\end_layout
\end_inset
\end_layout
\begin_layout Section
The different comments 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 choose between the following:
\end_layout
\begin_layout Subsection
PDF-Annotation
\end_layout
\begin_layout Standard
This is the
\begin_inset Quotes eld
\end_inset
normal
\begin_inset Quotes erd
\end_inset
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 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-xxx
\begin_inset space ~
\end_inset
options
\family default
, where
\family sans
xxx
\family default
stands for the type of the comment.
\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 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"
\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
color=blue,height=2.5cm,width=5.8cm,voffset=-2.8cm,hoffset=8cm,opacity=1.0,justifica
tion=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 blue 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.2
cm,opacity=0.9,justification=right
\end_layout
\end_inset
This is also a comment, but it's 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 beside 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 command with options.
\begin_inset Flex PDF-Margin
status open
\begin_layout Plain Layout
\begin_inset Argument 1
status open
\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
\begin_inset Flex PDF-Markup
status open
\begin_layout Plain Layout
PDF-Markup
\end_layout
\end_inset
\end_layout
\begin_layout Subsection
PDF-Reply
\end_layout
\begin_layout Standard
\begin_inset Flex PDF-Reply
status open
\begin_layout Plain Layout
PDF-Reply
\end_layout
\end_inset
\end_layout
\begin_layout Subsection
PDF-Sideline
\end_layout
\begin_layout Standard
\begin_inset Flex PDF-Sideline
status open
\begin_layout Plain Layout
PDF-Sideline
\end_layout
\end_inset
\end_layout
\begin_layout Subsection
PDF-Square
\end_layout
\begin_layout Standard
\begin_inset Flex PDF-Square
status open
\begin_layout Plain Layout
PDF-Square
\end_layout
\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 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 of the inset.
Here is an 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
words
\end_layout
\end_inset
\end_layout
\begin_layout Standard
As the object for the tooltip can be almost anything, we 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 optional argument that is used to correct
the size of tooltips 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
\end_layout
\end_inset
displaystyle
\end_layout
\end_inset
\begin_inset Argument post:1
status open
\begin_layout Plain Layout
little Gauß
\end_layout
\end_inset
\begin_inset Formula $x^{2}+2xy+y^{2}\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 "sub: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 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
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 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 einvironment
before your fiirst formula.
Name it
\series bold
MathPopup
\series default
, set the color to white with
\series bold
color=white
\series default
and make the comment popup with
\series bold
markup=Highlight
\series default
(will pop up when the mouse is hovered over the formula).
\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 person 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 using the environment Define
\begin_inset space ~
\end_inset
Avatar.
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,
\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 ALL PDF-comments in the document using your avatar.
This is done by inserting the custom inset
\family sans
PDF-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-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 List of
PDF-comments.
By specifying options for it you can determine what parts of the comments
shpuld appear in the list.
Here is the list for this document:
\end_layout
\begin_layout List of PDF-Comments
\begin_inset Argument 1
status open
\begin_layout Plain Layout
liststyle={AuthorComment}, heading ={List of PDF-comments}
\end_layout
\end_inset
\end_layout
\begin_layout Section
General Hints
\end_layout
\begin_layout Define Avatar
\begin_inset Argument 1
status open
\begin_layout Plain Layout
Cyrillic
\end_layout
\end_inset
color=Green,open=true,icon=Key,author={a}
\end_layout
\begin_layout Itemize
To be able to use all kinds of colors and color definitions you must load
the 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-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
It you have non-Latin characters in your comment or in the author name ...
\end_layout
\begin_layout Standard
Here is an example of a comment containing non-Latin characters:
\begin_inset Flex PDF-Margin
status open
\begin_layout Plain Layout
\begin_inset Argument 1
status open
\begin_layout Plain Layout
avatar=Cyrillic
\end_layout
\end_inset
Here is a text with Cyrillic letters: Александр Исаевич Солженицын got the
nobel price in 1970.
\end_layout
\end_inset
\end_layout
\end_body
\end_document