From 3b2f26271608630ca56a88b528a1004f51535ea3 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 10 Nov 2010 00:34:00 +0000 Subject: pdfcomment (9nov10) git-svn-id: svn://tug.org/texlive/trunk@20389 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/pdfcomment/CHANGES | 22 +++++ Master/texmf-dist/doc/latex/pdfcomment/README | 23 ++++- Master/texmf-dist/doc/latex/pdfcomment/example.pdf | Bin 146710 -> 146723 bytes Master/texmf-dist/doc/latex/pdfcomment/example.tex | 2 +- .../latex/pdfcomment/example_latex_dvipdfmx.tex | 2 +- .../pdfcomment/example_latex_dvips_ps2pdf.tex | 2 +- .../doc/latex/pdfcomment/example_xelatex.tex | 2 +- .../texmf-dist/doc/latex/pdfcomment/pdfcomment.pdf | Bin 224002 -> 225677 bytes .../texmf-dist/doc/latex/pdfcomment/pdfcomment.tex | 100 +++++++++++++++++++-- .../doc/latex/pdfcomment/pdfcomment_de.pdf | Bin 230278 -> 231007 bytes .../doc/latex/pdfcomment/pdfcomment_de.tex | 98 ++++++++++++++++++-- 11 files changed, 231 insertions(+), 20 deletions(-) (limited to 'Master/texmf-dist/doc/latex/pdfcomment') diff --git a/Master/texmf-dist/doc/latex/pdfcomment/CHANGES b/Master/texmf-dist/doc/latex/pdfcomment/CHANGES index a81a650ea45..fb3eba2193d 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/CHANGES +++ b/Master/texmf-dist/doc/latex/pdfcomment/CHANGES @@ -1,5 +1,27 @@ === pdfcomment.sty === +-- pdfcomment.sty (v2.0) (<- v1.63dev 2010/11/08) -- (svn rev 56) + +2010/11/08 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 + + reported by: Stefan Pinnow + +2010/11/05 added local option disable to all comment commands [jk] + to "switch off" single comments + + feature request by: Stefan Pinnow + +2010/11/05 changed definitions of options open and disable [jk] + to choicekey* to check valid option values (true|false) + + feature request by: Jannis von Buttlar + -- pdfcomment.sty (v1.6) (<- v1.53dev 2010/08/07) -- (svn rev 51) 2010/08/04 added support for using \pdfmarkupcomment in math mode [jk] diff --git a/Master/texmf-dist/doc/latex/pdfcomment/README b/Master/texmf-dist/doc/latex/pdfcomment/README index 9f087f5a436..812481c3006 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/README +++ b/Master/texmf-dist/doc/latex/pdfcomment/README @@ -15,9 +15,24 @@ Adobe Reader. License: LPPL -Changes in v1.6: +Changes in v2.0: -- added support for using \pdfmarkupcomment in math mode - (see: example_math_markup.pdf) +- 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 - feature request by: Ross Moore (he also contributed ideas and code) \ No newline at end of file + reported by: Stefan Pinnow + +- added local option disable to all comment commands [jk] + to "switch off" single comments + + feature request by: Stefan Pinnow + +- changed definitions of options open and disable [jk] + to choicekey* to check valid option values (true|false) + + feature request by: Jannis von Buttlar \ 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 index 62bc5627bd3..03c6163f4a0 100644 Binary files a/Master/texmf-dist/doc/latex/pdfcomment/example.pdf and b/Master/texmf-dist/doc/latex/pdfcomment/example.pdf differ diff --git a/Master/texmf-dist/doc/latex/pdfcomment/example.tex b/Master/texmf-dist/doc/latex/pdfcomment/example.tex index c0fdbb09b06..f4eb3dc37df 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/example.tex +++ b/Master/texmf-dist/doc/latex/pdfcomment/example.tex @@ -10,7 +10,7 @@ \usepackage[absolute]{textpos} \usepackage{tikz} \usepackage{amssymb,amsmath,array,bm} -\usepackage[subject={Top1},author={\AA{}nsgar Lund}]{pdfcomment} +\usepackage[subject={Top1},author={\AA{}nsgar Lund},version=1]{pdfcomment} \begin{document} \definecolor{myblue}{rgb}{0.045,0.278,0.643} \colorlet{myorange}{red!30!yellow} 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 65e4ee085df..f67ded2ff58 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvipdfmx.tex +++ b/Master/texmf-dist/doc/latex/pdfcomment/example_latex_dvipdfmx.tex @@ -12,7 +12,7 @@ \def\pgfsysdriver{pgfsys-dvipdfm.def} \usepackage{tikz} \usepackage{amssymb,amsmath,array,bm} -\usepackage[subject={Top1},author={\AA{}nsgar Lund},dvipdfmx]{pdfcomment} +\usepackage[subject={Top1},author={\AA{}nsgar Lund},dvipdfmx,version=1]{pdfcomment} \begin{document} \definecolor{myblue}{rgb}{0.045,0.278,0.643} \colorlet{myorange}{red!30!yellow} 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 699f45f7786..4862d6e54a3 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 @@ -9,7 +9,7 @@ \usepackage[absolute]{textpos} \usepackage{tikz} \usepackage{amssymb,amsmath,array,bm} -\usepackage[subject={Top1},author={\AA{}nsgar Lund}]{pdfcomment} +\usepackage[subject={Top1},author={\AA{}nsgar Lund},version=1]{pdfcomment} \begin{document} \definecolor{myblue}{rgb}{0.045,0.278,0.643} \colorlet{myorange}{red!30!yellow} diff --git a/Master/texmf-dist/doc/latex/pdfcomment/example_xelatex.tex b/Master/texmf-dist/doc/latex/pdfcomment/example_xelatex.tex index 07bd5ae9f6d..2fbb729d9f2 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/example_xelatex.tex +++ b/Master/texmf-dist/doc/latex/pdfcomment/example_xelatex.tex @@ -15,7 +15,7 @@ \usepackage{tikz} \usepackage{amssymb,amsmath,array,bm} \usepackage[absolute]{textpos} -\usepackage[subject={Top1},author={Ã…nsgar Lund}]{pdfcomment} +\usepackage[subject={Top1},author={Ã…nsgar Lund},version=1]{pdfcomment} \setmainfont[Mapping=tex-text]{Bergamo} \begin{document} \fontspec[SmallCapsFont={BergamoSmc},]{Bergamo} diff --git a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.pdf b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.pdf index b41164f1180..fdf2d9f92fc 100644 Binary files a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.pdf and b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.pdf differ diff --git a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.tex b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.tex index 53835e405ba..fd7c2f68853 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.tex +++ b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment.tex @@ -11,9 +11,94 @@ \usepackage{marginnote}% \usepackage[svgnames,rgb]{xcolor}% \usepackage{amsmath,array}% -\usepackage{jkdoc}% +\usepackage{tikz}% +\usepackage{ragged2e}% +\usepackage{url}% +\usepackage[automark,nouppercase]{scrpage2} \usepackage{pdfcomment}% % +\makeatletter +\setlength{\headheight}{1.1\baselineskip}% +% +\hypersetup{colorlinks=true,urlcolor=NavyBlue,linkcolor=NavyBlue,citecolor=CornflowerBlue,naturalnames=true,hypertexnames=false}% +\renewcommand{\maketitle}% +{% + \thispagestyle{empty}% + \pagecolor{Ivory}% + \begin{titlepage}% + \begin{tikzpicture}[remember picture,overlay]% + \node[yshift=-2cm] at (current page.north west)% + {% + \begin{tikzpicture}[remember picture, overlay]% + \draw[fill=CornflowerBlue,color=CornflowerBlue] (0,0) rectangle% + (\paperwidth,2cm);% + \draw[anchor=west,yshift=-4cm,xshift=3cm,color=NavyBlue] (0,0) node% + {\parbox{15cm}{\RaggedRight\Huge\sffamily\textbf{\@title}}};% + \draw[anchor=west,yshift=-6cm,xshift=3cm,color=NavyBlue] (0,0) node% + {\parbox{15cm}{\huge\sffamily\textbf{\@fileversion}}};% + \draw[anchor=west,yshift=-9cm,xshift=3cm,color=NavyBlue] (0,0) node% + {\parbox{15cm}{\RaggedRight\huge\sffamily\textbf{\@subtitle}}};% + \draw[anchor=west,yshift=-14cm,xshift=3cm,color=NavyBlue] (0,0) node% + {\parbox{15cm}{\huge\sffamily\textbf{\@date}}};% + \draw[anchor=west,yshift=-20cm,xshift=3cm,color=NavyBlue] (0,0) node% + {\parbox{15cm}{\Large\sffamily{\@authorline\\\textbf{\@author}}}};% + \end{tikzpicture}% + };% + \node[yshift=0cm] at (current page.south west)% + {% + \begin{tikzpicture}[remember picture, overlay]% + \draw[fill=NavyBlue,color=NavyBlue,yshift=6cm,xshift=2cm] (0,0) rectangle (0.2cm,19cm);% + \draw[fill=CornflowerBlue,color=CornflowerBlue] (0,0) rectangle (\paperwidth,2cm);% + \draw[anchor=west,yshift=1cm,xshift=3cm,color=NavyBlue] (0,0) node% + {\parbox{15cm}{\large\sffamily{\@refline}}};% + \end{tikzpicture}% + };% + \end{tikzpicture}% + \end{titlepage}% + \pagecolor{white}% +}% +% +\newcommand*{\@tikzhead}[1]% +{% + \begin{tikzpicture}[remember picture,overlay]% + \node[yshift=-2cm] at (current page.north west)% + {% + \begin{tikzpicture}[remember picture, overlay]% + \draw[fill=CornflowerBlue] (0,0) rectangle (\paperwidth,2cm);% + \draw[anchor=west,yshift=1cm,xshift=1.5cm,color=NavyBlue] (0,0) node% + {\parbox{15cm}{\LARGE\sffamily\textbf{\@title}}};% + \node[anchor=east,xshift=.9\paperwidth,rectangle,% + rounded corners=15pt,inner sep=11pt,fill=NavyBlue]% + {\color{white}\textsc{#1}};% + \end{tikzpicture}% + };% + \end{tikzpicture}% +}% +\clearscrheadings% +\ihead{\@tikzhead{\headmark}}% +\cfoot{\upshape\thepage}% +\pagestyle{scrheadings}% +% +%\newcommand*{\headline}[1]{\@mkboth{\MakeUppercase{#1}}{\MakeUppercase{#1}}}% +\newcommand*{\Headline}[1]{\@mkboth{#1}{#1}}% +% +\renewcommand{\headfont}{\normalfont\mdseries\scshape} +% +\gdef\@subtitle{}% +\providecommand*{\Subtitle}[1]{\gdef\@subtitle{#1}}% +\gdef\@fileversion{}% +\providecommand*{\Fileversion}[1]{\gdef\@fileversion{#1}}% +\gdef\@author{}% +\providecommand*{\Author}[1]{\gdef\@author{#1}}% +\gdef\@authorline{Package author:}% +\providecommand*{\Authorline}[1]{\gdef\@authorline{#1}}% +\gdef\@refline{}% +\providecommand*{\Refline}[1]{\gdef\@refline{#1}}% +\gdef\and{\unskip{}, }% +\newcommand\doubledash{-\kern0.5pt-} +\def\enoteformat{\rightskip\z@ \leftskip\z@ \parindent=1em\leavevmode\llap{\makeenmark}} +\makeatother +% \def\LinkExMath{\href{http://mirror.ctan.org/macros/latex/contrib/pdfcomment/doc/example_math_markup.pdf}{\texttt{example\_math\_markup.pdf}}} \def\LinkEx{\href{http://mirror.ctan.org/macros/latex/contrib/pdfcomment/doc/example.pdf}{\texttt{example.pdf}}} \def\filename{pdfcomment.sty}% @@ -51,8 +136,8 @@ \title{\filename}% \Subtitle{A user-friendly interface to PDF annotations}% \author{Josef Kleber} -\Fileversion{v1.6} -\Refline{\href{mailto:pdfcomment.sty@pdfcomment.josef-kleber.de}{\texttt{pdfcomment.sty@pdfcomment.josef-kleber.de}}\\\href{http://pdfcomment.josef-kleber.de/en_index.htm}{\texttt{http://pdfcomment.josef-kleber.de/en\_index.htm}}}% +\Fileversion{v2.0} +\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} \begin{abstract} @@ -104,16 +189,18 @@ I want to thank the following persons for contributions to the development of th I also want to thank the following persons for bug reports, feature requests, ...: -Gabriel Cardona, Jin-Hwan Cho, Thomas König, Marc-André Michel, Guillaume Millet, Fritz Moore, Michael Niedermair +Jannis von Buttlar, Gabriel Cardona, Jin-Hwan Cho, Thomas König, Marc-André Michel, Guillaume Millet, Fritz Moore, Michael Niedermair, Stefan Pinnow \clearpage \section{Options} \subsection{Global options} \subsubsection[\texttt{final}]{\styleoption{final}}\label{sec:final} -The option \styleoption{final} will set the package to final mode. The PDF annotations will not be typeset and will not influence line breaking. +The option \styleoption{final} will set the package to final mode. The PDF annotations will not be typeset and will not influence line breaking. Use the local option \styleoption{disable} if you want to disable single PDF annotations. (see: \ref{sec:disable}) \subsubsection[\texttt{draft}]{\styleoption{draft}}\label{sec:draft} The option \styleoption{draft} (default) will set the package to draft mode. Therefore, the PDF annotations will be typeset. \subsubsection[\texttt{dvipdfmx}]{\styleoption{dvipdfmx}}\label{sec:dvipdfmx} If you want to use the driver \texttt{dvipdfmx} for creating your documents, you have to use the option \styleoption{dvipdfmx}. The other drivers are recognized automatically. +\subsubsection[\texttt{version}]{\styleoption{version}}\label{sec:version} +Version v2.0 of \texttt{pdfcomment.sty} introduced a bugfix that removes unwanted whitespace before the comment commands. This may also change the reference point for options like \styleoption{hoffset}. If you want to preserve the old behavior for older documents simply use \texttt{version=1}. Otherwise \texttt{version=2} is used by default! \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. @@ -275,6 +362,9 @@ You can use the option \styleoption{height} for definig the height of PDF annota \subsubsection[\texttt{markup}]{\styleoption{markup}}\label{sec:markup} You can use the option \styleoption{markup} for defining the type of the PDF text markup annotation. Possible values are: Highlight, Underline, Squiggly und StrikeOut. +\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{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. diff --git a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.pdf b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.pdf index 90b4018d7ca..6e5ed9daa06 100644 Binary files a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.pdf and b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.pdf differ diff --git a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.tex b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.tex index fb39903cafe..ad48eeffae8 100644 --- a/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.tex +++ b/Master/texmf-dist/doc/latex/pdfcomment/pdfcomment_de.tex @@ -11,7 +11,10 @@ \usepackage{marginnote}% \usepackage[svgnames,rgb]{xcolor}% \usepackage{amsmath,array}% -\usepackage{jkdocde}% +\usepackage{tikz}% +\usepackage{ragged2e}% +\usepackage{url}% +\usepackage[automark,nouppercase]{scrpage2} \usepackage{pdfcomment}% % \def\LinkExMath{\href{http://mirror.ctan.org/macros/latex/contrib/pdfcomment/doc/example_math_markup.pdf}{\texttt{example\_math\_markup.pdf}}} @@ -20,6 +23,82 @@ \def\XeLaTeX{Xe\LaTeX}% % \makeatletter% +\hypersetup{colorlinks=true,urlcolor=NavyBlue,linkcolor=NavyBlue,citecolor=CornflowerBlue,naturalnames=true,hypertexnames=false}% +\setlength{\headheight}{1.1\baselineskip}% +% +\renewcommand{\maketitle}% +{% + \thispagestyle{empty}% + \pagecolor{Ivory}% + \begin{titlepage}% + \begin{tikzpicture}[remember picture,overlay]% + \node[yshift=-2cm] at (current page.north west)% + {% + \begin{tikzpicture}[remember picture, overlay]% + \draw[fill=CornflowerBlue,color=CornflowerBlue] (0,0) rectangle% + (\paperwidth,2cm);% + \draw[anchor=west,yshift=-4cm,xshift=3cm,color=NavyBlue] (0,0) node% + {\parbox{15cm}{\RaggedRight\Huge\sffamily\textbf{\@title}}};% + \draw[anchor=west,yshift=-6cm,xshift=3cm,color=NavyBlue] (0,0) node% + {\parbox{15cm}{\huge\sffamily\textbf{\@fileversion}}};% + \draw[anchor=west,yshift=-9cm,xshift=3cm,color=NavyBlue] (0,0) node% + {\parbox{15cm}{\RaggedRight\huge\sffamily\textbf{\@subtitle}}};% + \draw[anchor=west,yshift=-14cm,xshift=3cm,color=NavyBlue] (0,0) node% + {\parbox{15cm}{\huge\sffamily\textbf{\@date}}};% + \draw[anchor=west,yshift=-20cm,xshift=3cm,color=NavyBlue] (0,0) node% + {\parbox{15cm}{\Large\sffamily{\@authorline\\\textbf{\@author}}}};% + \end{tikzpicture}% + };% + \node[yshift=0cm] at (current page.south west)% + {% + \begin{tikzpicture}[remember picture, overlay]% + \draw[fill=NavyBlue,color=NavyBlue,yshift=6cm,xshift=2cm] (0,0) rectangle (0.2cm,19cm);% + \draw[fill=CornflowerBlue,color=CornflowerBlue] (0,0) rectangle (\paperwidth,2cm);% + \draw[anchor=west,yshift=1cm,xshift=3cm,color=NavyBlue] (0,0) node% + {\parbox{15cm}{\large\sffamily{\@refline}}};% + \end{tikzpicture}% + };% + \end{tikzpicture}% + \end{titlepage}% + \pagecolor{white}% +}% +% +\newcommand*{\@tikzhead}[1]% +{% + \begin{tikzpicture}[remember picture,overlay]% + \node[yshift=-2cm] at (current page.north west)% + {% + \begin{tikzpicture}[remember picture, overlay]% + \draw[fill=CornflowerBlue] (0,0) rectangle (\paperwidth,2cm);% + \draw[anchor=west,yshift=1cm,xshift=1.5cm,color=NavyBlue] (0,0) node% + {\parbox{15cm}{\LARGE\sffamily\textbf{\@title}}};% + \node[anchor=east,xshift=.9\paperwidth,rectangle,% + rounded corners=15pt,inner sep=11pt,fill=NavyBlue]% + {\color{white}\textsc{#1}};% + \end{tikzpicture}% + };% + \end{tikzpicture}% +}% +\clearscrheadings% +\ihead{\@tikzhead{\headmark}}% +\cfoot{\thepage}% +\pagestyle{scrheadings}% +% +\renewcommand{\headfont}{\normalfont\mdseries\scshape} +% +%\newcommand*{\Headline}[1]{\@mkboth{\MakeUppercase{#1}}{\MakeUppercase{#1}}}% +\newcommand*{\Headline}[1]{\@mkboth{#1}{#1}}% +% +\gdef\@subtitle{}% +\providecommand*{\Subtitle}[1]{\gdef\@subtitle{#1}}% +\gdef\@fileversion{}% +\providecommand*{\Fileversion}[1]{\gdef\@fileversion{#1}}% +\gdef\@authorline{Package Autor:}% +\providecommand*{\Authorline}[1]{\gdef\@authorline{#1}}% +\gdef\@refline{}% +\providecommand*{\Refline}[1]{\gdef\@refline{#1}}% +\gdef\and{\unskip{}, }% +% \renewcommand\tableofcontents% {% %\section*{\contentsname}% @@ -71,8 +150,8 @@ \title{\filename}% \Subtitle{Ein benutzerfreundliches Interface zu PDF-Kommentaren}% \author{Josef Kleber} -\Fileversion{v1.6} -\Refline{\href{mailto:pdfcomment.sty@pdfcomment.josef-kleber.de}{\texttt{pdfcomment.sty@pdfcomment.josef-kleber.de}}\\\href{http://pdfcomment.josef-kleber.de}{\texttt{http://pdfcomment.josef-kleber.de}}}% +\Fileversion{v2.0} +\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}% \begin{abstract} @@ -124,16 +203,18 @@ F Außerdem möchte ich folgenden Personen danken für bug reports, feature requests, ...: -Gabriel Cardona, Jin-Hwan Cho, Thomas König, Marc-André Michel, Guillaume Millet, Fritz Moore, Michael Niedermair +Jannis von Buttlar, Gabriel Cardona, Jin-Hwan Cho, Thomas König, Marc-André Michel, Guillaume Millet, Fritz Moore, Michael Niedermair, Stefan Pinnow \clearpage \section{Optionen} \subsection{Globale Styleoptionen} \subsubsection[\texttt{final}]{\styleoption{final}}\label{sec:final} -Mit der Option \texttt{final} versetzt man das Paket in den Final-Modus. Die PDF annotations werden nicht gesetzt und beeinflussen daher auch nicht den Zeilen\-umbruch. +Mit der Option \texttt{final} versetzt man das Paket in den Final-Modus. Die PDF annotations werden nicht gesetzt und beeinflussen daher auch nicht den Zeilen\-umbruch. Benutzen Sie die lokale Option \styleoption{disable}, falls Sie nur einzelne PDF annotations abschalten möcten. (siehe: \ref{sec:disable}) \subsubsection[\texttt{draft}]{\styleoption{draft}}\label{sec:draft} Mit der Option \texttt{draft} (default) versetzt man das Paket in den Draft-Modus. Die PDF annotations werden daher gesetzt. \subsubsection[\texttt{dvipdfmx}]{\styleoption{dvipdfmx}}\label{sec:dvipdfmx} Falls Sie für die Erstellung Ihrer Dokumente den Treiber \texttt{dvipdfmx} einsetzen möchten, müssen Sie die Option \texttt{dvipdfmx} benutzen. Die anderen bereits erwähnten Treiber werden automatisch erkannt. +\subsubsection[\texttt{version}]{\styleoption{version}}\label{sec:version} +Mit der Version v2.0 von \texttt{pdfcomment.sty} wurde ein Bugfix hinzugefügt, der ungewollten Whitespace vor den Kommentarbefehlen entfernt. Das ändert u.\,U. auch den Referenzpunkt für Optionen wie \styleoption{hoffset}. Möchten Sie das ursprüngliche Verhalten erhalten - etwa für alte Dokumente - verwenden Sie die Option \texttt{version=1}. Ansonsten wird die Option \texttt{version=2} als Default verwendet! \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. @@ -293,6 +374,9 @@ Die Option \styleoption{height} dient der Festlegung der H \subsubsection[\texttt{markup}]{\styleoption{markup}}\label{sec:markup} 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}. + \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. @@ -313,7 +397,7 @@ M \bigskip Mit der Umgebung \env{pdfsidelinecomment} kann man ganze Seitenbereiche in Form zweier Linien in den Randspalten mit einem Kommentar kennzeichnen. -\hspace*{0pt}\newline +\clearpage \begin{pdfsidelinecomment}[color=red,icolor=yellow,linebegin=/Circle,lineend=/Circle,linewidth=3bp,linesep=1cm]{ ! Beachten ! } Einschränkungen: @@ -389,7 +473,7 @@ Beachten Sie bitte auch \LinkExMath{} f 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=-4.3cm,hoffset=-4cm,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=-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! \subsubsection{\texorpdfstring{\cs{pdfsquarecomment}}{\textbackslash pdfsquarecomment}} \label{sec:pdfsquarecomment} -- cgit v1.2.3