diff options
author | Karl Berry <karl@freefriends.org> | 2010-12-13 23:45:28 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2010-12-13 23:45:28 +0000 |
commit | 58348ea17b62f4a62100c2ff09825a2c4ade46fb (patch) | |
tree | 9e78e543c2f439582510ce4058626d26a34d383f /Master/texmf-dist/doc | |
parent | e572bd73edca41c8e3641ed601afa67ec7706bf4 (diff) |
pdfcomment (13dec10)
git-svn-id: svn://tug.org/texlive/trunk@20724 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
16 files changed, 226 insertions, 97 deletions
diff --git a/Master/texmf-dist/doc/latex/pdfcomment/CHANGES b/Master/texmf-dist/doc/latex/pdfcomment/CHANGES index fb3eba2193d..df41266afc6 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/CHANGES +++ b/Master/texmf-dist/doc/latex/pdfcomment/CHANGES @@ -1,5 +1,18 @@ === pdfcomment.sty === +-- pdfcomment.sty (v2.1) (<- v2.02dev 2010/12/11) -- (svn rev 61) + +2010/12/11 added support for PDF reply system [jk] + \pdfcomment[avatar=Joe,id=1]{comment} + \pdfreply[avatar=Bob,id=2,replyto=1]{reply to comment} + works for pdflatex only! + +2010/11/25 added options id,date,timezone [jk] + +2010/11/25 added support for new icon CrossHairs (Adobe Reader X) [jk] + +2010/11/25 Bugfix: problem with \pdfmarkupcomment with page break [jk] + -- pdfcomment.sty (v2.0) (<- v1.63dev 2010/11/08) -- (svn rev 56) 2010/11/08 Bugfix: unwanted whitespace before comment commands [jk] diff --git a/Master/texmf-dist/doc/latex/pdfcomment/README b/Master/texmf-dist/doc/latex/pdfcomment/README index 812481c3006..1b460e11ab5 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/README +++ b/Master/texmf-dist/doc/latex/pdfcomment/README @@ -7,7 +7,7 @@ Reader. At least for the writer of LaTeX code, the package offers a convenient and user-friendly means of using \pdfannot to provide comments in PDF files. Since version v1.1, pdfcomment.sty also supports: - LaTeX -> dvips -> ps2pdf, LaTeX -> dvipdfmx and XeLaTeX. + LaTeX -> dvips -> ps2pdf, LaTeX -> dvipdfmx and XeLaTeX. Unfortunately, support of PDF annotations by PDF viewers is sparse to nonexistent. The reference viewer for the development of this package is @@ -15,24 +15,15 @@ Adobe Reader. License: LPPL -Changes in v2.0: +Changes in v2.1: -- Bugfix: unwanted whitespace before comment commands [jk] - -> added \unskip - This removes whitespace before comment commands - and may change the reference point for hoffset - -> added global option version (1|2(default)) - version=1 will preserve the old behavior - for old documents +- added support for PDF reply system + \pdfcomment[avatar=Joe,id=1]{comment} + \pdfreply[avatar=Bob,id=2,replyto=1]{reply to comment} + works for pdflatex only! - reported by: Stefan Pinnow - -- added local option disable to all comment commands [jk] - to "switch off" single comments +- added options id,date,timezone - feature request by: Stefan Pinnow - -- changed definitions of options open and disable [jk] - to choicekey* to check valid option values (true|false) +- added support for new icon CrossHairs (Adobe Reader X) - feature request by: Jannis von Buttlar
\ No newline at end of file +- Bugfix: problem with \pdfmarkupcomment with page break
\ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/pdfcomment/example.pdf b/Master/texmf-dist/doc/latex/pdfcomment/example.pdf Binary files differindex 03c6163f4a0..9d7d1069afa 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/example.pdf +++ b/Master/texmf-dist/doc/latex/pdfcomment/example.pdf diff --git a/Master/texmf-dist/doc/latex/pdfcomment/example.tex b/Master/texmf-dist/doc/latex/pdfcomment/example.tex index f4eb3dc37df..9027b8b60c9 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/example.tex +++ b/Master/texmf-dist/doc/latex/pdfcomment/example.tex @@ -12,9 +12,16 @@ \usepackage{amssymb,amsmath,array,bm} \usepackage[subject={Top1},author={\AA{}nsgar Lund},version=1]{pdfcomment} \begin{document} +\defineavatar{Joe}{author=Joe,color=yellow} +\defineavatar{Bob}{author=Bob,color=green} \definecolor{myblue}{rgb}{0.045,0.278,0.643} \colorlet{myorange}{red!30!yellow} -A\pdfcomment[subject={Top2},author={Daisy Duck},color={0.234 0.867 0.211},voffset=8pt,opacity=0.5]{This is a comment.} little Test! \pdfcomment[color=myblue,subject={Comment2},icon=Note,open=true,hspace=100pt]{This is another comment.} test the hspace!% +\pdfcommentsetup{date=D:20101211153723+01'00'} +A\pdfcomment[subject={Top2},author={Daisy Duck},color={0.234 0.867 0.211},voffset=8pt,opacity=0.5]{This is a comment.} little Test! \pdfcomment[id=1,color=myblue,subject={Comment2},icon=Note,open=true,hspace=100pt]{This is another comment.} +\pdfreply[id=2,avatar=Joe,replyto=1,date=D:20101211161247+01'00']{This is a reply to a comment} +\pdfreply[id=3,avatar=Bob,replyto=2,date=D:20101212095321+01'00']{Of course, you can reply to a reply} +\pdfreply[id=4,avatar=Bob,replyto=1,date=D:20101212095512+01'00']{Just another reply} +test the hspace!% \defineavatar{CaptainJack}{color=myorange,author={Captain Jack}}% \definestyle{MyStar}{icon=Star,opacity=0.7,voffset=12pt}% \pdfcomment[avatar=CaptainJack,style=MyStar,subject={enough},deadline={2009/11/11 - Josef}]{It's enough now!} diff --git a/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvipdfmx.pdf b/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvipdfmx.pdf Binary files differindex 4ac1b0bee40..d93a4d03cd7 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvipdfmx.pdf +++ b/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvipdfmx.pdf diff --git a/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvipdfmx.tex b/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvipdfmx.tex index f67ded2ff58..f31ab2116b6 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvipdfmx.tex +++ b/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvipdfmx.tex @@ -14,9 +14,17 @@ \usepackage{amssymb,amsmath,array,bm} \usepackage[subject={Top1},author={\AA{}nsgar Lund},dvipdfmx,version=1]{pdfcomment} \begin{document} +\defineavatar{Joe}{author=Joe,color=yellow} +\defineavatar{Bob}{author=Bob,color=green} \definecolor{myblue}{rgb}{0.045,0.278,0.643} \colorlet{myorange}{red!30!yellow} -A\pdfcomment[subject={Top2},author={Daisy Duck},color={0.234 0.867 0.211},voffset=8pt,opacity=0.5]{This is a comment.} little Test! \pdfcomment[color=myblue,icon=Note,open=true,hspace=100pt]{This is another comment.} test the hspace!% +\pdfcommentsetup{date=D:20101211153723+01'00'} +A\pdfcomment[subject={Top2},author={Daisy Duck},color={0.234 0.867 0.211},voffset=8pt,opacity=0.5]{This is a comment.} little Test! \pdfcomment[id=1,color=myblue,icon=Note,open=true,hspace=100pt]{This is another comment.} +% works with pdflatex only! +%\pdfreply[id=2,avatar=Joe,replyto=1,date=D:20101211161247+01'00']{This is a reply to a comment} +%\pdfreply[id=3,avatar=Bob,replyto=2,date=D:20101212095321+01'00']{Of course, you can reply %to a reply} +%\pdfreply[id=4,avatar=Bob,replyto=1,date=D:20101212095512+01'00']{Just another reply} + test the hspace!% \defineavatar{CaptainJack}{color=myorange,author={Captain Jack}}% \definestyle{MyStar}{icon=Star,opacity=0.7,voffset=12pt}% \pdfcomment[avatar=CaptainJack,style=MyStar]{It's enough now!} diff --git a/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvips_ps2pdf.pdf b/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvips_ps2pdf.pdf Binary files differindex 37a31e0fdb8..f84b8352147 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvips_ps2pdf.pdf +++ b/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvips_ps2pdf.pdf diff --git a/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvips_ps2pdf.tex b/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvips_ps2pdf.tex index 4862d6e54a3..e764ed48162 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvips_ps2pdf.tex +++ b/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvips_ps2pdf.tex @@ -11,9 +11,17 @@ \usepackage{amssymb,amsmath,array,bm} \usepackage[subject={Top1},author={\AA{}nsgar Lund},version=1]{pdfcomment} \begin{document} +\defineavatar{Joe}{author=Joe,color=yellow} +\defineavatar{Bob}{author=Bob,color=green} \definecolor{myblue}{rgb}{0.045,0.278,0.643} \colorlet{myorange}{red!30!yellow} -A\pdfcomment[subject={Top2},author={Daisy Duck},color={0.234 0.867 0.211},voffset=8pt,opacity=0.5]{This is a comment.} little Test! \pdfcomment[color=myblue,icon=Note,open=true,hspace=100pt]{This is another comment.} test the hspace!% +\pdfcommentsetup{date=D:20101211153723+01'00'} +A\pdfcomment[subject={Top2},author={Daisy Duck},color={0.234 0.867 0.211},voffset=8pt,opacity=0.5]{This is a comment.} little Test! \pdfcomment[id=1,color=myblue,icon=Note,open=true,hspace=100pt]{This is another comment.}% +% works with pdflatex only! +%\pdfreply[id=2,avatar=Joe,replyto=1,date=D:20101211161247+01'00']{This is a reply to a comment} +%\pdfreply[id=3,avatar=Bob,replyto=2,date=D:20101212095321+01'00']{Of course, you can reply %to a reply} +%\pdfreply[id=4,avatar=Bob,replyto=1,date=D:20101212095512+01'00']{Just another reply} +test the hspace!% \defineavatar{CaptainJack}{color=myorange,author={Captain Jack}}% \definestyle{MyStar}{icon=Star,opacity=0.7,voffset=12pt}% \pdfcomment[avatar=CaptainJack,style=MyStar]{It's enough now!}% diff --git a/Master/texmf-dist/doc/latex/pdfcomment/example_math_markup.pdf b/Master/texmf-dist/doc/latex/pdfcomment/example_math_markup.pdf Binary files differindex ee331c6ae79..c31783e794b 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/example_math_markup.pdf +++ b/Master/texmf-dist/doc/latex/pdfcomment/example_math_markup.pdf diff --git a/Master/texmf-dist/doc/latex/pdfcomment/example_math_markup.tex b/Master/texmf-dist/doc/latex/pdfcomment/example_math_markup.tex index 2c0315b1f51..2e07080e3e8 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/example_math_markup.tex +++ b/Master/texmf-dist/doc/latex/pdfcomment/example_math_markup.tex @@ -8,6 +8,9 @@ \usepackage{listings} \usepackage[author={Josef Kleber},subject={Math test},color=Khaki]{pdfcomment} \begin{document} +\defineavatar{Joe}{author=Joe,color=yellow} +\defineavatar{Bob}{author=Bob,color=green} +\pdfcommentsetup{date=D:20101211153723+01'00'} \setlength{\parindent}{0pt} \addtokomafont{section}{\normalfont\normalcolor\bfseries} \setkomafont{title}{\normalfont\normalcolor\bfseries} @@ -15,12 +18,15 @@ \title{Using \texttt{\string\pdfmarkupcomment}\ in math mode} \lstset{language=[LaTeX]TeX,numbers=left,numberstyle=\tiny,basicstyle=\ttfamily\small,frame=single,backgroundcolor=\color{LightGoldenrodYellow},keywordstyle=\color{Blue},emph={mathstyle,style}, emphstyle=\color{Tomato},emph={[2]mathpopup},emphstyle={[2]\color{SeaGreen}},morekeywords={pdfmarkupcomment,[,]}} \definestyle{mathpopup}{author={},subject={},color=NavajoWhite,markup=Highlight} -\hypersetup{pdfauthor={Josef Kleber},pdftitle={Using \textbackslash{}pdfmarkupcomment in math mode},pdfsubject={An example file for demonstrating the usage of \textbackslash{}pdfmarkupcomment in math mode},colorlinks=true,pdfborder={0 0 0},linkcolor=blue,citecolor=blue}% +\hypersetup{pdfauthor={Josef Kleber},pdftitle={Using \textbackslash{}pdfmarkupcomment in math mode},pdfsubject={An example file for demonstrating the usage of \textbackslash{}pdfmarkupcomment in math mode},pdfborder={0 0 0},linkcolor=blue,citecolor=blue}% \maketitle \section{Simple formulas} PDF annotations work in inline formula ($\pdfmarkupcomment[style=mathpopup]{\sum_{i=1}^{n}i=\frac{1}{2}n\cdot(n+1)}{comment}$), as well as in display mode: -\[\pdfmarkupcomment[style=mathpopup,mathstyle=\displaystyle]{f(x)=\prod_{i=1}^{n}\left(i-\frac{1}{2i}\right)}{comment}\] +\[\pdfmarkupcomment[id=1,style=mathpopup,mathstyle=\displaystyle,open=true]{f(x)=\prod_{i=1}^{n}\left(i-\frac{1}{2i}\right)}{comment}\] +\pdfreply[id=2,avatar=Joe,replyto=1,date=D:20101211161247+01'00']{This is a reply to a comment} +\pdfreply[id=3,avatar=Bob,replyto=2,date=D:20101212095321+01'00']{Of course, you can reply to a reply} +\pdfreply[id=4,avatar=Bob,replyto=1,date=D:20101212095512+01'00']{Just another reply} \bigskip Of course, you can only comment parts of a formula: diff --git a/Master/texmf-dist/doc/latex/pdfcomment/example_xelatex.pdf b/Master/texmf-dist/doc/latex/pdfcomment/example_xelatex.pdf Binary files differindex f647bcccc39..2840f2dae7a 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/example_xelatex.pdf +++ b/Master/texmf-dist/doc/latex/pdfcomment/example_xelatex.pdf diff --git a/Master/texmf-dist/doc/latex/pdfcomment/example_xelatex.tex b/Master/texmf-dist/doc/latex/pdfcomment/example_xelatex.tex index 2fbb729d9f2..11f3d391f2f 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/example_xelatex.tex +++ b/Master/texmf-dist/doc/latex/pdfcomment/example_xelatex.tex @@ -13,18 +13,26 @@ \usepackage{lipsum} \usepackage[svgnames,rgb]{xcolor} \usepackage{tikz} -\usepackage{amssymb,amsmath,array,bm} +\usepackage{amsmath,array,bm} \usepackage[absolute]{textpos} \usepackage[subject={Top1},author={Ã…nsgar Lund},version=1]{pdfcomment} \setmainfont[Mapping=tex-text]{Bergamo} \begin{document} \fontspec[SmallCapsFont={BergamoSmc},]{Bergamo} +\defineavatar{Joe}{author=Joe,color=yellow} +\defineavatar{Bob}{author=Bob,color=green} \definecolor{myblue}{rgb}{0.045,0.278,0.643} \colorlet{myorange}{red!30!yellow} -A\pdfcomment[subject={Top2},author={Daisy Duck},color={0.234 0.867 0.211},voffset=8pt,opacity=0.5]{This is a comment.} little Test! \pdfcomment[color=myblue,icon=Note,open=true,hspace=100pt]{This is another comment.} test the hspace!% +\pdfcommentsetup{date=D:20101211153723+01'00',timezone=+01'00'} +A\pdfcomment[subject={Top2},author={Daisy Duck},color={0.234 0.867 0.211},voffset=8pt,opacity=0.5]{This is a comment.} little Test! \pdfcomment[color=myblue,icon=Note,open=true,hspace=100pt]{This is another comment.} +% works with pdflatex only! +%\pdfreply[id=2,avatar=Joe,replyto=1,date=D:20101211161247+01'00']{This is a reply to a comment} +%\pdfreply[id=3,avatar=Bob,replyto=2,date=D:20101212095321+01'00']{Of course, you can reply %to a reply} +%\pdfreply[id=4,avatar=Bob,replyto=1,date=D:20101212095512+01'00']{Just another reply} +test the hspace!% \defineavatar{CaptainJack}{color=myorange,author={Captain Jack}}% \definestyle{MyStar}{icon=Star,opacity=0.7,voffset=12pt}% -\pdfcomment[avatar=CaptainJack,style=MyStar]{It's enough now!} +\pdfcomment[avatar=CaptainJack,style=MyStar,date={}]{It's enough now!} \pdffreetextcomment[avatar=CaptainJack,subject={Top2},height=3cm,type=freetext,width=4.5cm,voffset=-4.8cm,hoffset=-2.7cm,opacity=0.5,justification=right]{This is also a comment, but it's a FreeText annotation! Your, Captain Jack} \pdflinecomment[avatar=CaptainJack,subject={Top2},type=line,opacity=1,line={100 680 250 680},color=green,icolor=blue,caption=top,linebegin={/ROpenArrow},lineend={/OpenArrow},linewidth=2bp,captionhoffset=-5pt,captionvoffset=15pt]{This is a Line comment!} \pdffreetextcomment[avatar=CaptainJack,subject={Top2},height=1.8cm,width=5.8cm,voffset=-7.2cm,hoffset=-1.2cm,opacity=1.0,justification=right,type=typewriter,font=Harrington,fontsize=18pt,fontcolor=CornflowerBlue]{This is a typewriter FreeText annotation!} diff --git a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.pdf b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.pdf Binary files differindex fdf2d9f92fc..e0ba66b017c 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.pdf +++ b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.pdf diff --git a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.tex b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.tex index fd7c2f68853..93d5055ca78 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.tex +++ b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.tex @@ -132,11 +132,12 @@ \hypersetup{pdfauthor={Josef Kleber},pdftitle={A user-friendly interface to PDF annotations},pdfsubject={Documentation for LaTeX style \filename}}% % \begin{document} +\pdfcommentsetup{date=D:20101212153723+01'00'} \bibliographystyle{alphadin} \title{\filename}% \Subtitle{A user-friendly interface to PDF annotations}% \author{Josef Kleber} -\Fileversion{v2.0} +\Fileversion{v2.1} \Refline{\href{mailto:kleberj@users.berlios.de}{\texttt{kleberj@users.berlios.de}}\\\href{http://pdfcomment.berlios.de}{\texttt{http://pdfcomment.berlios.de}}} \maketitle \Headline{Abstract} @@ -154,7 +155,7 @@ If you can't see this annotation \pdfcomment[author={Josef Kleber},subject={Test \vfill \begin{center} \subsubsection*{Required packages for using \substyle{\filename}} -\fbox{\parbox[t]{.8\linewidth}{\small \package{hyperref} (v6.76a [2007/04/09]), \package{zref} (v1.8 [2007/04/22]), \package{xkeyval}, \package{ifpdf}, \package{ifthen}, \package{calc}, \package{marginnote} and the packages loaded by them.}} +\fbox{\parbox[t]{.8\linewidth}{\small \package{hyperref} (v6.76a [2007/04/09]), \package{zref} (v1.8 [2007/04/22]), \package{xkeyval}, \package{ifpdf}, \package{ifthen}, \package{calc}, \package{marginnote}, \package{datetime} and the packages loaded by them.}} \end{center} \vfill \clearpage @@ -204,6 +205,9 @@ Version v2.0 of \texttt{pdfcomment.sty} introduced a bugfix that removes unwante \subsection{Local options} The following options are useable as options for the commands presented in sections \ref{sec:kommentarumgebungen} and \ref{sec:kommentarbefehle}, as well as style options. As style options they have global effect, whereas they have only local effect when used in commands. Furthermore global options are not overwritten. +\subsubsection[\texttt{id}]{\styleoption{id}}\label{sec:id} +You can use the option \styleoption{id} to define a unique ID for referencing in a PDF reply (see \ref{sec:pdfreply}). + \subsubsection[\texttt{subject}]{\styleoption{subject}}\label{sec:subject} You can use the option \styleoption{subject} for defining the subject of the PDF popup annotations. @@ -213,6 +217,48 @@ You can use the option \styleoption{author} for defining the author of the PDF p \subsubsection[\texttt{opacity}]{\styleoption{opacity}}\label{sec:opacity} You can use the option \styleoption{opacity} for defining the opacity of PDF annotations with values between 0 (transparent) and 1 (not transparent, default). If you want to print PDF popup annotations with transparency you will have to use the option \styleoption{open} = \texttt{true}. +\subsubsection[\texttt{icon}]{\styleoption{icon}}\label{sec:icon} +You can use the option \styleoption{icon} for defining the graphic used for the PDF text annotations. The following icons are defined as mandatory by the PDF reference: + +\pdfcommentsetup{author={Josef Kleber},subject={Icon Übersicht},width=17mm} +{\renewcommand{\arraystretch}{2.5} +\begin{center} +\begin{tabular}{rlrlrl} +\texttt{Comment} & \pdfcomment[icon=Comment,color=Ivory,hspace=1.5cm]{Optionen: icon=Comment,color=Ivory} & +\texttt{Key} & \pdfcomment[icon=Key,color=Khaki,hspace=1.5cm]{Optionen: icon=Key,color=Khaki} & +\texttt{Note} & \pdfcomment[icon=Note,color=LavenderBlush,hspace=1.5cm]{Optionen: icon=Note,color=LavenderBlush}\\ +\texttt{Help} & \pdfcomment[icon=Help,color=CornflowerBlue,hspace=1.5cm]{Optionen: icon=Help,color=CornflowerBlue} & +\texttt{NewParagraph} & \pdfcomment[icon=NewParagraph,color=SkyBlue,hspace=1.5cm]{Optionen: icon=NewParagraph,color=SkyBlue}\\ +\texttt{Paragraph} & \pdfcomment[icon=Paragraph,color=SpringGreen,hspace=1.5cm]{Optionen: icon=Paragraph,color=SpringGreen} & +\texttt{Insert} & \pdfcomment[icon=Insert,color=PaleTurquoise,hspace=1.5cm]{Optionen: Insert,color=PaleTurquoise} & + & \\ +\end{tabular} +\end{center} +} + +\begin{samepage} +Furthermore the following icons are also supported by \texttt{Adobe Reader} and some other PDF viewers: + +{\renewcommand{\arraystretch}{2.5} +\begin{center} +\begin{tabular}{rlrlrl} +\texttt{Check} & \pdfcomment[icon=Check,color=Orchid,hspace=1cm]{Optionen: icon=Check,color=Orchid} & +\texttt{Circle} & \pdfcomment[icon=Circle,color=LightCyan,hspace=1cm]{Optionen: icon=Circle,color=LightCyan} & +\texttt{Cross} & \pdfcomment[icon=Cross,color=Bisque,hspace=1cm]{Optionen: icon=Cross,color=Bisque}\\ +\texttt{Star} & \pdfcomment[icon=Star,color=Aquamarine,hspace=1cm]{Optionen: icon=Star,color=Aquamarine} & +\texttt{RightArrow} & \pdfcomment[icon=RightArrow,color=Gainsboro,hspace=1cm]{Optionen: icon=RightArrow,color=Gainsboro} & +\texttt{RightPointer} & \pdfcomment[icon=RightPointer,color=Salmon,hspace=1cm]{Optionen: icon=RightPointer,color=Salmon}\\ +\texttt{UpArrow} & \pdfcomment[icon=UpArrow,color=Teal,hspace=1cm]{Optionen: icon=UpArrow,color=Teal} & +\texttt{UpLeftArrow} & \pdfcomment[icon=UpLeftArrow,color=Magenta,hspace=1cm]{Optionen: icon=UpLeftArrow,color=Magenta} & +\texttt{CrossHairs (AR X)} & \pdfcomment[icon=CrossHairs,color=green,hspace=1cm]{Optionen: icon=CrossHairs,color=green} +\end{tabular} +\end{center} +} +\end{samepage} + +\subsubsection[\texttt{deadline}]{\styleoption{deadline}}\label{sec:deadline} +You can use the option \styleoption{deadline} for defining a time limit until a problem has to be solved. The deadline will be added at the end of the comment, as well as in the list of comments, if an appropriate list style is chosen. + \subsubsection[\texttt{color}]{\styleoption{color}}\label{sec:color} You can use the option \styleoption{color} for defining the color of PDF annotations in the form \{0.34 0.56 0.12\} (RGB). If you are using the additional package \package{xcolor} you can use predefined color names, as well as the available optional color names. Furthermore you can use the command \cmd\definecolor{} to define your own named colors. Please take a look at the attached example \file{example.tex}.\marginnote{\attachfile[author={Josef Kleber},subject={example.tex},description={source code: example.tex} ,mimetype={text/plain}, icon={Tag}]{example.tex}} It shows the different possibilities of defining colors. @@ -232,36 +278,6 @@ By definition the PDF specification allows four different color spaces with diff \subsubsection[\texttt{icolor}]{\styleoption{icolor}}\label{sec:icolor} You can use the option \styleoption{icolor} for defining the so called 'inner color', which is used by some PDF annotations, like arrowheads or the inner area of PDF circle annotation. For the rest, the provisions of the option \styleoption{color} shall apply. -\subsubsection[\texttt{icon}]{\styleoption{icon}}\label{sec:icon} -You can use the option \styleoption{icon} for defining the graphic used for the PDF text annotations. The following icons are defined as mandatory by the PDF reference: - -\bigskip\pdfcommentsetup{author={Josef Kleber},subject={Icon overview}} -\texttt{Comment} \hspace{1em} \pdfcomment[icon=Comment,color=Ivory]{Options: icon=Comment,color=Ivory} \hfill \texttt{Key} \hspace{1em} \pdfcomment[icon=Key,color=Khaki]{Options: icon=Key,color=Khaki} \hfill \texttt{Note} \hspace{1em} \pdfcomment[icon=Note,color=LavenderBlush]{Options: icon=Note,color=LavenderBlush} \hfill \texttt{Help} \hspace{1em} \pdfcomment[icon=Help,color=CornflowerBlue]{Options: icon=Help,color=CornflowerBlue}\hspace{20pt} - -\bigskip - -\hspace*{1cm}\texttt{NewParagraph} \hspace{1em} \pdfcomment[icon=NewParagraph,color=SkyBlue]{Options: icon=NewParagraph,color=SkyBlue} \hfill \texttt{Paragraph} \hspace{1em} \pdfcomment[icon=Paragraph,color=SpringGreen]{Options: icon=Paragraph,color=SpringGreen} \hfill \texttt{Insert} \hspace{1em} \pdfcomment[icon=Insert,color=PaleTurquoise]{Options: Insert,color=PaleTurquoise}\hspace{0pt}\hspace*{1cm}\hspace{20pt} - -\bigskip -Furthermore the following icons are also supported by \texttt{Adobe Reader} and some other PDF viewers: - -\bigskip - -\texttt{Check} \hspace{1em} \pdfcomment[icon=Check,color=Orchid]{Options: icon=Check,color=Orchid} \hfill \texttt{Circle} \hspace{1em} \pdfcomment[icon=Circle,color=LightCyan]{Options: icon=Circle,color=LightCyan} \hfill \texttt{Cross} \hspace{1em} \pdfcomment[icon=Cross,color=Bisque]{Options: icon=Cross,color=Bisque}\hspace{20pt} - -\bigskip - -\hspace*{1cm}\texttt{Star} \hspace{1em} \pdfcomment[icon=Star,color=Aquamarine]{Options: icon=Star,color=Aquamarine} \hfill \texttt{RightArrow} \hspace{1em} \pdfcomment[icon=RightArrow,color=Gainsboro]{Options: icon=RightArrow,color=Gainsboro} \hfill \texttt{RightPointer} \hspace{1em} \pdfcomment[icon=RightPointer,color=Salmon]{Options: icon=RightPointer,color=Salmon}\hspace*{1cm}\hspace{20pt} - -\bigskip - -\hspace*{2.5cm}\texttt{UpArrow} \hspace{1em} \pdfcomment[icon=UpArrow,color=Teal]{Options: icon=UpArrow,color=Teal} \hfill \texttt{UpLeftArrow} \hspace{1em} \pdfcomment[icon=UpLeftArrow,color=Magenta]{Options: icon=UpLeftArrow,color=Magenta}\hspace*{2.5cm}\hspace{20pt} - -\bigskip - -\subsubsection[\texttt{deadline}]{\styleoption{deadline}}\label{sec:deadline} -You can use the option \styleoption{deadline} for defining a time limit until a problem has to be solved. The deadline will be added at the end of the comment, as well as in the list of comments, if an appropriate list style is chosen. - \subsubsection[\texttt{open}]{\styleoption{open}}\label{sec:open} You can use the option \styleoption{open} for defining the opening status of the PDF popup annotations. Possible values are \texttt{true} or \texttt{false} (default). @@ -365,6 +381,19 @@ You can use the option \styleoption{markup} for defining the type of the PDF tex \subsubsection[\texttt{disable}]{\styleoption{disable}}\label{sec:disable} You can use the option \styleoption{disable} for switching off single PDF annotation. For switching off all PDF annotations use the global option \styleoption{final}. +\subsubsection[\texttt{date}]{\styleoption{date}}\label{sec:date} +You can use the option \styleoption{date} to assign a date to PDF annotations. If no explicit date is assigned the date and time of the creation of the PDF document is used. The input has to be in PDF date format, e.g.: + +\begin{center} +\begin{tabular}{l} +D:YYYYMMDDhhmmss+TZ\\ +D:20101224153657+01'00' +\end{tabular} +\end{center} + +\subsubsection[\texttt{timezone}]{\styleoption{timezone}}\label{sec:timezone} +You only have to use the option \styleoption{timezone}, if you are using automatic date setting and \XeLaTeX\ or \texttt{pdflatex} < v1.30.0. Otherwise the \texttt{pdflatex} command \string\pdfcreationdate\ will be used. \styleoption{timezone}=+01'00' sets the timezone to middle european time (default: +00'00' (GMT)). + \subsubsection[\texttt{avatar}]{\styleoption{avatar}}\label{sec:avatar} With the option \styleoption{avatar} you can load the option lists, that were predefined with the command \cmd\defineavatar{} to avoid annoying typing. @@ -396,7 +425,6 @@ Limitations: \end{itemize} \end{pdfsidelinecomment} -\clearpage \section{Commands}\label{sec:befehle} \subsection{Comment commands}\label{sec:kommentarbefehle} @@ -462,7 +490,7 @@ Also see \LinkExMath{} for a more detailed explanation of the possibilities! Possible \margcs{\cmd\pdffreetextcomment\\\oarg{options}\marg{comment}} options: \styleoption{avatar}, \styleoption{style}, \styleoption{subject}, \styleoption{author}, \styleoption{color}, \styleoption{font}, \styleoption{fontsize}, \styleoption{fontcolor}, \styleoption{opacity}, \styleoption{line}, \styleoption{linewidth}, \styleoption{lineend}, \styleoption{borderstyle}, \styleoption{dashstyle}, \styleoption{bse}, \styleoption{bsei}, \styleoption{type}, \styleoption{height}, \styleoption{width}, \styleoption{voffset}, \styleoption{hoffset} \bigskip -\cmd\pdffreetextcomment{} (type=freetext) will typeset a comment in form of a freely positioned box on the wished spot of the page.\pdffreetextcomment[subject={\textbackslash pdffreetextcomment Test},height=1.2cm,width=4cm,voffset=-3.7cm,hoffset=-1.2cm,opacity=0.5,color=yellow]{This is a FreeText annotation} By using the option \styleoption{type} = \texttt{callout} the box will have an additional so called callout line, to bind the box to a certain element of the page. With the option \styleoption{type} = \texttt{typewriter} you can write a comment everywhere on the page with a virtual 'typewriter'. These PDF freetext annotation do have no frame and a transparent background for 'overwriting' arbitrary parts of the page. Please note the example file \LinkEx! +\cmd\pdffreetextcomment{} (type=freetext) will typeset a comment in form of a freely positioned box on the wished spot of the page.\pdffreetextcomment[subject={\textbackslash pdffreetextcomment Test},height=1.2cm,width=4cm,voffset=-4.7cm,hoffset=-1.2cm,opacity=0.5,color=yellow]{This is a FreeText annotation} By using the option \styleoption{type} = \texttt{callout} the box will have an additional so called callout line, to bind the box to a certain element of the page. With the option \styleoption{type} = \texttt{typewriter} you can write a comment everywhere on the page with a virtual 'typewriter'. These PDF freetext annotation do have no frame and a transparent background for 'overwriting' arbitrary parts of the page. Please note the example file \LinkEx! \subsubsection{\texorpdfstring{\cs{pdfsquarecomment}}{\textbackslash pdfsquarecomment}} \label{sec:pdfsquarecomment} @@ -486,6 +514,22 @@ Possible \margcs{\cmd\pdfsidelinecomment\\\oarg{options}\marg{comment}}options: \bigskip \cmd\pdflinecomment{} will typeset a comment in form of a line, polyline or polygon at the wished spot of the page (see: \LinkEx). +\subsection{Reply command} + +\subsubsection{\texorpdfstring{\cs{pdfreply}}{\textbackslash pdfreply}} +\label{sec:pdfreply} +Possible \margcs{\cmd\pdfreply\\\oarg{options}\marg{comment}}options: \styleoption{avatar}, \styleoption{style}, \styleoption{subject}, \styleoption{author}, \styleoption{id}, \styleoption{replyto}, \styleoption{color} + +\bigskip +\defineavatar{Joe}{author=Joe,color=yellow} +\defineavatar{Bob}{author=Bob,color=green} +With the command \cmd\pdfreply{} you can compose replys to comments. The option \texttt{replyto} provides a clear reference to the comment the reply refers to.\footnote{The replys must be typeset on the same page than the refering comments}. Due to technical reasons the command \string\pdfreply\ works only while using \texttt{pdflatex}. +\pdfmargincomment[subject={Top2},author={Josef Kleber},icon=Note,id=1,color=blue]{This is a comment.} +\pdfreply[id=2,avatar=Joe,replyto=1,date=D:20101212161247+01'00']{This is a reply to a comment} +\pdfreply[id=3,avatar=Bob,replyto=2,date=D:20101213095321+01'00']{Of course, you can reply to a reply} +\pdfreply[id=4,avatar=Bob,replyto=1,date=D:20101213095512+01'00']{Just another reply} +Furthermore the command can not support page breaks (\string\pdfmarkupcomment, \string\pdfsidelinecomment). The replys will only appear in the PDF annotations on the second page. Replys to comments without page break work smoothly! + \subsection{Misc. commands} \subsubsection{\texorpdfstring{\cs{pdfcommentsetup}}{\textbackslash pdfcommentsetup}} @@ -538,7 +582,7 @@ With the command \cmd\definestyle \margcs{\cmd\definestyle\marg{name}\marg{optio \section{Printing comments and popups} \label{sec:print} -Basically, \texttt{Adobe Reader} is able to print PDF annotations. Therefore, you have to choose 'Document and Markups' in the field 'Comments and Forms' of the print dialog. Additionally, you have to configure the menu 'Edit $\rightarrow$ Preferences $\rightarrow$ Commenting'. Unfortunately, this option does not exist in many versions of \texttt{Adobe Reader}. If it does not exist, the only possibility is to edit the configuration files itself. +Basically, \texttt{Adobe Reader} is able to print PDF annotations. Therefore, you have to choose 'Document and Markups' in the field 'Comments and Forms' of the print dialog. Additionally, you have to configure the menu 'Edit $\rightarrow$ Preferences... $\rightarrow$ Commenting $\rightarrow$ Print notes and pop-ups'. This entry exists since the release of \texttt{Adobe Reader X}. For older versions, the only possibility is to edit the configuration files itself. \begin{description} \item[Windows:] the registry needs to be changed (on your own risk!) diff --git a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.pdf b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.pdf Binary files differindex 6e5ed9daa06..2c3ed634b10 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.pdf +++ b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.pdf diff --git a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.tex b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.tex index ad48eeffae8..0bf0110ef3e 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.tex +++ b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.tex @@ -146,11 +146,12 @@ \hypersetup{pdfauthor={Josef Kleber},pdftitle={Ein benutzerfreundliches Interface zu PDF-Kommentaren},pdfsubject={Dokumentation für den LaTeX style \filename}} % \begin{document} +\pdfcommentsetup{date=D:20101212153723+01'00'} \bibliographystyle{alphadin} \title{\filename}% \Subtitle{Ein benutzerfreundliches Interface zu PDF-Kommentaren}% \author{Josef Kleber} -\Fileversion{v2.0} +\Fileversion{v2.1} \Refline{\href{mailto:kleberj@users.berlios.de}{\texttt{kleberj@users.berlios.de}}\\\href{http://pdfcomment.berlios.de}{\texttt{http://pdfcomment.berlios.de}}} \maketitle \Headline{Zusammenfassung}% @@ -168,7 +169,7 @@ Falls Sie diesen Kommentar \pdfcomment[author={Josef Kleber},subject={Test Komme \vfill \begin{center} \subsubsection*{Benötigte Pakete für die Nutzung von \substyle{\filename}} -\fbox{\parbox[t]{.8\linewidth}{\small \package{hyperref} (v6.76a [2007/04/09]), \package{zref} (v1.8 [2007/04/22]), \package{xkeyval}, \package{ifpdf}, \package{ifthen}, \package{calc}, \package{marginnote} und die von diesen Paketen aufgerufenen Dateien.}} +\fbox{\parbox[t]{.8\linewidth}{\small \package{hyperref} (v6.76a [2007/04/09]), \package{zref} (v1.8 [2007/04/22]), \package{xkeyval}, \package{ifpdf}, \package{ifthen}, \package{calc}, \package{marginnote}, \package{datetime} und die von diesen Paketen aufgerufenen Dateien.}} \end{center} \vfill \clearpage @@ -218,6 +219,9 @@ Mit der Version v2.0 von \texttt{pdfcomment.sty} wurde ein Bugfix hinzugefügt, d \subsection{Lokale Optionen} Die anschließend vorgestellten Optionen sind für die in den Abschnitten \ref{sec:kommentarumgebungen} und \ref{sec:kommentarbefehle} vorgestellten Befehle anwendbar, allerdings können sie auch als Styleoptionen benutzt werden. Als Styleoptionen besitzen sie globale Wirkung, während sie in Befehlen nur eine lokale Wirkung besitzen und die globalen Optionen nicht überschreiben. +\subsubsection[\texttt{id}]{\styleoption{id}}\label{sec:id} +Die Option \styleoption{id} dient der Festlegung einer eindeutigen ID für die Referenzierung in einer PDF-Antwort (siehe \ref{sec:pdfreply}). + \subsubsection[\texttt{subject}]{\styleoption{subject}}\label{sec:subject} Die Option \styleoption{subject} dient der Festlegung der Überschriften der PDF popup annotations. @@ -227,6 +231,48 @@ Die Option \styleoption{author} dient der Festlegung des Verfassers der PDF popu \subsubsection[\texttt{opacity}]{\styleoption{opacity}}\label{sec:opacity} Die Option \styleoption{opacity} dient der Festlegung der Transparenz der PDF annotations. Die Werte liegen dabei zwischen 0 (transparent) und 1 (nicht transparent, default). Möchten Sie die PDF popup annotations mit Transparenz drucken, funktioniert das nur zuverlässig, falls sie mit der Option \styleoption{open} = \texttt{true} erstellt werden. +\subsubsection[\texttt{icon}]{\styleoption{icon}}\label{sec:icon} +Die Option \styleoption{icon} dient der Festlegung der Grafik, die für die PDF text annotations benutzt werden sollen. Die folgenden Icons werden in der PDF-Referenz als verbindlich festgelegt: + +\pdfcommentsetup{author={Josef Kleber},subject={Icon Übersicht},width=17mm} +{\renewcommand{\arraystretch}{2.5} +\begin{center} +\begin{tabular}{rlrlrl} +\texttt{Comment} & \pdfcomment[icon=Comment,color=Ivory,hspace=1.5cm]{Optionen: icon=Comment,color=Ivory} & +\texttt{Key} & \pdfcomment[icon=Key,color=Khaki,hspace=1.5cm]{Optionen: icon=Key,color=Khaki} & +\texttt{Note} & \pdfcomment[icon=Note,color=LavenderBlush,hspace=1.5cm]{Optionen: icon=Note,color=LavenderBlush}\\ +\texttt{Help} & \pdfcomment[icon=Help,color=CornflowerBlue,hspace=1.5cm]{Optionen: icon=Help,color=CornflowerBlue} & +\texttt{NewParagraph} & \pdfcomment[icon=NewParagraph,color=SkyBlue,hspace=1.5cm]{Optionen: icon=NewParagraph,color=SkyBlue}\\ +\texttt{Paragraph} & \pdfcomment[icon=Paragraph,color=SpringGreen,hspace=1.5cm]{Optionen: icon=Paragraph,color=SpringGreen} & +\texttt{Insert} & \pdfcomment[icon=Insert,color=PaleTurquoise,hspace=1.5cm]{Optionen: Insert,color=PaleTurquoise} & + & \\ +\end{tabular} +\end{center} +} + +\begin{samepage} +Außerdem werden vom \texttt{Adobe Reader} und einigen anderen Viewern auch diese Icons unterstützt: + +{\renewcommand{\arraystretch}{2.5} +\begin{center} +\begin{tabular}{rlrlrl} +\texttt{Check} & \pdfcomment[icon=Check,color=Orchid,hspace=1cm]{Optionen: icon=Check,color=Orchid} & +\texttt{Circle} & \pdfcomment[icon=Circle,color=LightCyan,hspace=1cm]{Optionen: icon=Circle,color=LightCyan} & +\texttt{Cross} & \pdfcomment[icon=Cross,color=Bisque,hspace=1cm]{Optionen: icon=Cross,color=Bisque}\\ +\texttt{Star} & \pdfcomment[icon=Star,color=Aquamarine,hspace=1cm]{Optionen: icon=Star,color=Aquamarine} & +\texttt{RightArrow} & \pdfcomment[icon=RightArrow,color=Gainsboro,hspace=1cm]{Optionen: icon=RightArrow,color=Gainsboro} & +\texttt{RightPointer} & \pdfcomment[icon=RightPointer,color=Salmon,hspace=1cm]{Optionen: icon=RightPointer,color=Salmon}\\ +\texttt{UpArrow} & \pdfcomment[icon=UpArrow,color=Teal,hspace=1cm]{Optionen: icon=UpArrow,color=Teal} & +\texttt{UpLeftArrow} & \pdfcomment[icon=UpLeftArrow,color=Magenta,hspace=1cm]{Optionen: icon=UpLeftArrow,color=Magenta} & +\texttt{CrossHairs (AR X)} & \pdfcomment[icon=CrossHairs,color=green,hspace=1cm]{Optionen: icon=CrossHairs,color=green} +\end{tabular} +\end{center} +} +\end{samepage} + +\subsubsection[\texttt{deadline}]{\styleoption{deadline}}\label{sec:deadline} +Die Option \styleoption{deadline} dient der Festlegung einer Frist zur Behebung eines Problems. Die Frist wird an das Ende des Kommentars angefügt, sowie gegebenenfalls - bei entsprechendem Listenstil - auch in die Liste der Kommentare aufgenommen. + \subsubsection[\texttt{color}]{\styleoption{color}}\label{sec:color} Die Option \styleoption{color} dient der Festlegung der Farbe der PDF annotations z.\,B. in der Form \{0.34 0.56 0.12\} (RGB). Bei Verwendung des Zusatzpakets \package{xcolor} kann man auch vordefinierte Basisfarbnamen, sowie die zusätzlich verfügbaren optionalen Farbnamen verwenden. Außerdem kann man mit dem Befehl \cmd\definecolor{} eigene benannte Farben definieren. Bitte beachten Sie das beigefügte Beispiel \file{example.tex}.\marginnote{\attachfile[author={Josef Kleber},subject={example.tex},description={Sourcecode: example.tex} ,mimetype={text/plain}, icon={Tag}]{example.tex}} Es bietet einen Überblick über die unterschiedlichen Möglichkeiten zur Festlegung der Farbe. @@ -246,36 +292,6 @@ Grundsätzlich erlaubt die PDF Spezifikation vier unterschiedliche Farbräume, die \subsubsection[\texttt{icolor}]{\styleoption{icolor}}\label{sec:icolor} Die Option \styleoption{icolor} dient der Festlegung der bei einigen PDF annotations genutzten sogenannten 'inner color', etwa in Pfeilspitzen oder die Innenfläche der PDF circle annotation. Im Übrigen gelten dieselben Bestimmungen wie bei der Option \styleoption{color}. -\subsubsection[\texttt{icon}]{\styleoption{icon}}\label{sec:icon} -Die Option \styleoption{icon} dient der Festlegung der Grafik, die für die PDF text annotations benutzt werden sollen. Die folgenden Icons werden in der PDF-Referenz als verbindlich festgelegt: - -\bigskip\pdfcommentsetup{author={Josef Kleber},subject={Icon Übersicht},width=17mm} -\texttt{Comment} \hspace{1em} \pdfcomment[icon=Comment,color=Ivory]{Optionen: icon=Comment,color=Ivory} \hfill \texttt{Key} \hspace{1em} \pdfcomment[icon=Key,color=Khaki]{Optionen: icon=Key,color=Khaki} \hfill \texttt{Note} \hspace{1em} \pdfcomment[icon=Note,color=LavenderBlush]{Optionen: icon=Note,color=LavenderBlush} \hfill \texttt{Help} \hspace{1em} \pdfcomment[icon=Help,color=CornflowerBlue]{Optionen: icon=Help,color=CornflowerBlue}\hspace{20pt} - -\bigskip - -\hspace*{1cm}\texttt{NewParagraph} \hspace{1em} \pdfcomment[icon=NewParagraph,color=SkyBlue]{Optionen: icon=NewParagraph,color=SkyBlue} \hfill \texttt{Paragraph} \hspace{1em} \pdfcomment[icon=Paragraph,color=SpringGreen]{Optionen: icon=Paragraph,color=SpringGreen} \hfill \texttt{Insert} \hspace{1em} \pdfcomment[icon=Insert,color=PaleTurquoise]{Optionen: Insert,color=PaleTurquoise}\hspace{20pt}\hspace*{1cm} - -\bigskip -Außerdem werden vom \texttt{Adobe Reader} und einigen anderen Viewern auch diese Icons unterstützt: - -\bigskip - -\texttt{Check} \hspace{1em} \pdfcomment[icon=Check,color=Orchid]{Optionen: icon=Check,color=Orchid} \hfill \texttt{Circle} \hspace{1em} \pdfcomment[icon=Circle,color=LightCyan]{Optionen: icon=Circle,color=LightCyan} \hfill \texttt{Cross} \hspace{1em} \pdfcomment[icon=Cross,color=Bisque]{Optionen: icon=Cross,color=Bisque}\hspace{20pt} - -\bigskip - -\hspace*{1cm}\texttt{Star} \hspace{1em} \pdfcomment[icon=Star,color=Aquamarine]{Optionen: icon=Star,color=Aquamarine} \hfill \texttt{RightArrow} \hspace{1em} \pdfcomment[icon=RightArrow,color=Gainsboro]{Optionen: icon=RightArrow,color=Gainsboro} \hfill \texttt{RightPointer} \hspace{1em} \pdfcomment[icon=RightPointer,color=Salmon]{Optionen: icon=RightPointer,color=Salmon}\hspace*{1cm}\hspace{20pt} - -\bigskip - -\hspace*{2.5cm}\texttt{UpArrow} \hspace{1em} \pdfcomment[icon=UpArrow,color=Teal]{Optionen: icon=UpArrow,color=Teal} \hfill \texttt{UpLeftArrow} \hspace{1em} \pdfcomment[icon=UpLeftArrow,color=Magenta]{Optionen: icon=UpLeftArrow,color=Magenta}\hspace*{2.5cm}\hspace{20pt} - -\bigskip - -\subsubsection[\texttt{deadline}]{\styleoption{deadline}}\label{sec:deadline} -Die Option \styleoption{deadline} dient der Festlegung einer Frist zur Behebung eines Problems. Die Frist wird an das Ende des Kommentars angefügt, sowie gegebenenfalls - bei entsprechendem Listenstil - auch in die Liste der Kommentare aufgenommen. - \subsubsection[\texttt{open}]{\styleoption{open}}\label{sec:open} Die Option \styleoption{open} dient der Festlegung des Öffnungsstatus der PDF popup annotations. Mögliche Werte sind dabei \texttt{true} oder \texttt{false} (Default). @@ -375,7 +391,20 @@ Die Option \styleoption{height} dient der Festlegung der Höhe der PDF annotation Die Option \styleoption{markup} dient der Festlegung des Typs der text markup annotations. Mögliche Werte sind dabei: Highlight, Underline, Squiggly und StrikeOut. \subsubsection[\texttt{disable}]{\styleoption{disable}}\label{sec:disable} -Mit der Option \styleoption{disable} kann man einzelne PDF annotationa abschalten. Möchten Sie alle PDF annotations abschalten, benuzten Sie die globale Option \styleoption{final}. +Mit der Option \styleoption{disable} kann man einzelne PDF annotations abschalten. Möchten Sie alle PDF annotations abschalten, benuzten Sie die globale Option \styleoption{final}. + +\subsubsection[\texttt{date}]{\styleoption{date}}\label{sec:date} +Mit der Option \styleoption{date} kann man den PDF annotations ein Datum zuordnen. Falls kein explizites Datum gesetzt wird, wird das Datum und die Uhrzeit der PDF-Dokument-Erstellung verwendet. Die Eingabe muß im PDF-Datumformat erfolgen, z.B.: + +\begin{center} +\begin{tabular}{l} +D:YYYYMMDDhhmmss+TZ\\ +D:20101224153657+01'00' +\end{tabular} +\end{center} + +\subsubsection[\texttt{timezone}]{\styleoption{timezone}}\label{sec:timezone} +Sie müssen die Option \styleoption{timezone} nur benutzen, falls Sie die automatische Datumssetzung und \XeLaTeX\ oder \texttt{pdflatex} < v1.30.0 verwenden. Ansonsten wird der \texttt{pdflatex}-Befehl \string\pdfcreationdate\ verwendet. \styleoption{timezone}=+01'00' setzt die Zeitzone auf mitteleuropäische Zeit (Default: +00'00' (GMT)). \subsubsection[\texttt{avatar}]{\styleoption{avatar}}\label{sec:avatar} Mit der Option \styleoption{avatar} kann man die mit dem Befehl \cmd\defineavatar{} vordefinierten Optionslisten laden, um lästige Tipparbeit zu vermeiden. @@ -397,7 +426,6 @@ Mögliche \marginnote{\raggedleft\scriptsize\envb{pdfsidelinecomment}\\\oarg{Opti \bigskip Mit der Umgebung \env{pdfsidelinecomment} kann man ganze Seitenbereiche in Form zweier Linien in den Randspalten mit einem Kommentar kennzeichnen. -\clearpage \begin{pdfsidelinecomment}[color=red,icolor=yellow,linebegin=/Circle,lineend=/Circle,linewidth=3bp,linesep=1cm]{ ! Beachten ! } Einschränkungen: @@ -473,7 +501,7 @@ Beachten Sie bitte auch \LinkExMath{} für eine genauere Beschreibung der neuen M Mögliche \margcs{\cmd\pdffreetextcomment\\\oarg{Optionen}\marg{Kommentar}} Optionen: \styleoption{avatar}, \styleoption{style}, \styleoption{subject}, \styleoption{author}, \styleoption{color}, \styleoption{font}, \styleoption{fontsize}, \styleoption{fontcolor}, \styleoption{opacity}, \styleoption{line}, \styleoption{linewidth}, \styleoption{lineend}, \styleoption{borderstyle}, \styleoption{dashstyle}, \styleoption{bse}, \styleoption{bsei}, \styleoption{type}, \styleoption{height}, \styleoption{width}, \styleoption{voffset}, \styleoption{hoffset} \bigskip -\cmd\pdffreetextcomment{} (type=freetext) setzt einen Kommentar in Form einer frei positionierbaren Box an die gewünschte Stelle der Seite\pdffreetextcomment[subject={\textbackslash pdffreetextcomment Test},height=1.2cm,width=4cm,voffset=-5.3cm,hoffset=-2cm,opacity=0.5,color=yellow]{Das ist eine FreeText annotation}. Bei Verwendung der Option \styleoption{type} = \texttt{callout} verfügt die Box zusätzlich über eine sogenannte Callout Linie, um die Box an ein bestimmtes Element der Seite zu binden. Mit der Option \styleoption{type} = \texttt{typewriter} kann man einen Kommentar an einer beliebigen Stelle mit einer virtuellen 'Schreibmaschine' schreiben. Diese PDF freetext annotation haben keinen Rand und einen transparenten Hintergrund. Dadurch kann man beliebige Stellen 'überschreiben'. Bitte beachten Sie dazu die Beispieldatei \LinkEx! +\cmd\pdffreetextcomment{} (type=freetext) setzt einen Kommentar in Form einer frei positionierbaren Box an die gewünschte Stelle der Seite\pdffreetextcomment[subject={\textbackslash pdffreetextcomment Test},height=1.2cm,width=4cm,voffset=-4.1cm,hoffset=-2cm,opacity=0.5,color=yellow]{Das ist eine FreeText annotation}. Bei Verwendung der Option \styleoption{type} = \texttt{callout} verfügt die Box zusätzlich über eine sogenannte Callout Linie, um die Box an ein bestimmtes Element der Seite zu binden. Mit der Option \styleoption{type} = \texttt{typewriter} kann man einen Kommentar an einer beliebigen Stelle mit einer virtuellen 'Schreibmaschine' schreiben. Diese PDF freetext annotation haben keinen Rand und einen transparenten Hintergrund. Dadurch kann man beliebige Stellen 'überschreiben'. Bitte beachten Sie dazu die Beispieldatei \LinkEx! \subsubsection{\texorpdfstring{\cs{pdfsquarecomment}}{\textbackslash pdfsquarecomment}} \label{sec:pdfsquarecomment} @@ -496,6 +524,22 @@ Mögliche \margcs{\cmd\pdfsidelinecomment\\\oarg{Optionen}\marg{Kommentar}}Option \bigskip \cmd\pdflinecomment{} setzt einen Kommentar in Form einer Linie. Polylinie oder Polygon an die gewünschte Stelle der Seite (siehe: \LinkEx). +\subsection{Antwortbefehl} + +\subsubsection{\texorpdfstring{\cs{pdfreply}}{\textbackslash pdfreply}} +\label{sec:pdfreply} +Mögliche \margcs{\cmd\pdfreply\\\oarg{Optionen}\marg{Kommentar}}Optionen: \styleoption{avatar}, \styleoption{style}, \styleoption{subject}, \styleoption{author}, \styleoption{id}, \styleoption{replyto}, \styleoption{color} + +\bigskip +\defineavatar{Anton}{author=Anton,color=yellow} +\defineavatar{Berti}{author=Berti,color=green} +Mit dem Befehl \cmd\pdfreply{} kann man Antworten zu Kommentaren verfassen. Dabei dient die Option \texttt{replyto} der eindeutigen Identifizierung des Kommentars auf den sich die Antwort bezieht\footnote{Die Antworten müssen auf derselben Seite wie die Kommentare gesetzt werden}. Wegen technischer Gründe funktioniert der Befehl \string\pdfreply\ ausschließlich bei der Verwendung von \texttt{pdflatex}. +\pdfmargincomment[subject={Top2},author={Josef Kleber},icon=Note,id=1,color=blue]{Das ist ein Kommentar.} +\pdfreply[id=2,avatar=Anton,replyto=1,date=D:20101212161247+01'00']{Das ist eine Antwort auf einen Kommentar} +\pdfreply[id=3,avatar=Berti,replyto=2,date=D:20101213095321+01'00']{Natürlich kann man auch auf Antworten antworten} +\pdfreply[id=5,avatar=Berti,replyto=1,date=D:20101213095512+01'00']{Nur eine andere Antwort} +Weiterhin unterstützt der Befehl keinen Seitenumbruch (\string\pdfmarkupcomment, \string\pdfsidelinecomment). Hier erscheinen die Antworten nur bei den PDF annotations auf der zweiten Seite. Antworten auf Kommentare ohne Seitenumbruch funktionieren problemlos! + \subsection{Allgemeine Befehle} \subsubsection{\texorpdfstring{\cs{pdfcommentsetup}}{\textbackslash pdfcommentsetup}} @@ -547,7 +591,7 @@ Analog dient \cmd\definestyle \margcs{\cmd\definestyle\marg{Name}\marg{Optionen} \section{Drucken der Kommentare und Popups} \label{sec:print} -\texttt{Adobe Reader} kann prinzipiell PDF annotations drucken. Dazu muß man im Druckdialog im Feld 'Kommentare und Formulare' die Einstellung 'Dokument und Markierungen' wählen. Zusätzlich muß das Drucken im Menü 'Bearbeiten $\rightarrow$ Voreinstellungen $\rightarrow$ Kommentare' konfiguriert werden. Leider ist diese Einstellungsmöglichkeit nur in sehr wenigen Versionen von \texttt{Adobe Reader} vorhanden. Falls sie nicht vorhanden ist bleibt nur die Möglichkeit die Konfigurationsdateien selbst zu ändern. +\texttt{Adobe Reader} kann prinzipiell PDF annotations drucken. Dazu muß man im Druckdialog im Feld 'Kommentare und Formulare' die Einstellung 'Dokument und Markierungen' wählen. Zusätzlich muß das Drucken im Menü 'Bearbeiten $\rightarrow$ Voreinstellungen $\rightarrow$ Kommentieren $\rightarrow$ Notizen und Popups drucken' konfiguriert werden. Diese Einstellungsmöglichkeit gibt es seit der Veröffentlichung von \texttt{Adobe Reader X}. Bei alteren Versionen bleibt nur die Möglichkeit die Konfigurationsdateien selbst zu ändern. \begin{description} \item[Windows:] Ändern der Registry Einträge notwendig (auf eigene Gefahr!) |