texlive[55536] Master/texmf-dist: pdfpc (13jun20)
commits+karl at tug.org
commits+karl at tug.org
Sat Jun 13 22:57:55 CEST 2020
Revision: 55536
http://tug.org/svn/texlive?view=revision&revision=55536
Author: karl
Date: 2020-06-13 22:57:54 +0200 (Sat, 13 Jun 2020)
Log Message:
-----------
pdfpc (13jun20)
Modified Paths:
--------------
trunk/Master/texmf-dist/tex/latex/pdfpc/pdfpc.sty
Added Paths:
-----------
trunk/Master/texmf-dist/doc/latex/pdfpc/pdfpc-doc.pdf
trunk/Master/texmf-dist/doc/latex/pdfpc/pdfpc-doc.tex
Removed Paths:
-------------
trunk/Master/texmf-dist/doc/latex/pdfpc/pdfpc.pdf
trunk/Master/texmf-dist/source/latex/pdfpc/
Added: trunk/Master/texmf-dist/doc/latex/pdfpc/pdfpc-doc.pdf
===================================================================
(Binary files differ)
Index: trunk/Master/texmf-dist/doc/latex/pdfpc/pdfpc-doc.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/latex/pdfpc/pdfpc-doc.pdf 2020-06-13 20:03:38 UTC (rev 55535)
+++ trunk/Master/texmf-dist/doc/latex/pdfpc/pdfpc-doc.pdf 2020-06-13 20:57:54 UTC (rev 55536)
Property changes on: trunk/Master/texmf-dist/doc/latex/pdfpc/pdfpc-doc.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/pdfpc/pdfpc-doc.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/pdfpc/pdfpc-doc.tex (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/pdfpc/pdfpc-doc.tex 2020-06-13 20:57:54 UTC (rev 55536)
@@ -0,0 +1,140 @@
+% This file is part of pdfpc.
+% Copyright (C) 2020 Evgeny Stambulchik
+%
+% This program is free software; you can redistribute it and/or modify
+% it under the terms of the GNU General Public License as published by
+% the Free Software Foundation; either version 3 of the License, or
+% (at your option) any later version.
+%
+% This program is distributed in the hope that it will be useful,
+% but WITHOUT ANY WARRANTY; without even the implied warranty of
+% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+% GNU General Public License for more details.
+%
+% You should have received a copy of the GNU General Public License along
+% with this program; if not, write to the Free Software Foundation, Inc.,
+% 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+% -------------------------------------------------------------------------------------------
+%
+% Allow for defining some meta data and simple textual notes for use
+% with the pdfpc presentation application <https://pdfpc.github.io>.
+%
+% -------------------------------------------------------------------------------------------
+%
+% Inspired by Carsten Brandt's <https://github.com/cebe/pdfpc-latex-notes>.
+%
+% -------------------------------------------------------------------------------------------
+%
+% Please report bugs and other problems as well as suggestions for improvements
+% to the issue tracker at github <https://github.com/pdfpc/pdfpc/>
+%
+% -------------------------------------------------------------------------------------------
+\documentclass[11pt]{ltxdoc}
+
+\usepackage{iftex}
+
+\usepackage[english]{babel}
+
+\usepackage{hyperref}
+
+\newcommand*{\sty}[1]{\textsf{#1}}
+\def\param#1{\textit{\rmfamily\mdseries\ensuremath{\langle}#1\ensuremath{\rangle}}}
+
+
+\title{The \sty{pdfpc} package \\ {\large\url{https://github.com/pdfpc/pdfpc}}}
+\author{Evgeny Stambulchik}
+\date{2020/06/10 (v0.4.0)}
+
+\hypersetup{pdftitle={The pdfpc package}, pdfauthor={Evgeny Stambulchik}}
+
+\begin{document}
+\maketitle
+\thispagestyle{empty}
+
+\begin{abstract}
+This package provides a convenient way to specify notes and to define certain
+meta properties of the presentation when used with
+\href{https://pdfpc.github.io/}{PDF Presenter Console (\texttt{pdfpc}), a
+GPLv2+ licensed multi-monitor PDF presentation viewer application available on
+GitHub}\footnote{\url{https://pdfpc.github.io/}}.
+\end{abstract}
+
+\clearpage
+\section*{Dependencies and other requirements}
+
+\sty{pdfpc} requires the use of \LaTeXe.
+
+It depends on the following packages:
+
+\begin{multicols}{4}\sffamily\centering
+kvoptions \\ xstring \\ pdfcomment \\ hyperxmp
+\end{multicols}
+
+\section*{License}
+
+\textcopyright\ 2020 Evgeny Stambulchik
+
+This program is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 3 of the License, or
+(at your option) any later version.
+
+This work consists of the following files:
+
+\begin{itemize}
+ \item "pdfpc.sty",
+ \item "pdfpc-doc.tex"
+ \item "pdfpc-doc.pdf" \emph{(compiled)}
+\end{itemize}
+
+\clearpage
+
+\part{The documentation}
+\section*{Loading \sty{pdfpc}}
+
+Load \sty{pdfpc} by adding \cmd{\usepackage\{pdfpc\}} to your preamble.
+
+The following \param{options} may be given as comma-separated list:
+
+\begin{itemize}
+\item \texttt{duration}
+\item \texttt{starttime}
+\item \texttt{endtime}
+\item \texttt{enduserslide}
+\item \texttt{lastminutes}
+\item \texttt{hidenotes}
+\item \texttt{overridenote}
+\item \texttt{defaulttransition} (needs pdfpc v4.5 or higher)
+\end{itemize}
+
+The meaning and possible values of most of these options are documented in
+\textit{pdfpcrc(5)} man page of the pdfpc program. The rest are explained below.
+
+To add a note to a slide (must not be longer than one paragraph):
+
+{\leftskip2.5em%
+\cmd{\pdfpcnote\{Text of a note\}}
+}\par
+
+The pdfpc package can be used standalone or together with beamer. In
+the later case, it may be desirable to continue using the \cmd{\note}
+command. To this end, the \texttt{overridenote} option should be provided.
+Please note though, that this will work only in simple cases.
+
+If you prefer using full-featured beamer notes rendered alongside the
+presentation (\cmd{\setbeameroption\{show notes on second screen\}}), the pdfpc
+package will autodetect it, so using the \texttt{--notes} command-line option is
+unnecessary. To override the autodetection, use the \texttt{notesposition}
+option, accepting the same values (right/left/top/bottom/none).
+
+When sharing slides, one may want to omit the (private) notes, by using the
+\texttt{hidenotes} option. Enabling it together with \texttt{overridenote} will
+disable the beamer notes as well.
+
+\StopEventually{%
+ \clearpage
+ \PrintChanges}
+\clearpage
+
+\Finale
+\end{document}
Property changes on: trunk/Master/texmf-dist/doc/latex/pdfpc/pdfpc-doc.tex
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Deleted: trunk/Master/texmf-dist/doc/latex/pdfpc/pdfpc.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/tex/latex/pdfpc/pdfpc.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/pdfpc/pdfpc.sty 2020-06-13 20:03:38 UTC (rev 55535)
+++ trunk/Master/texmf-dist/tex/latex/pdfpc/pdfpc.sty 2020-06-13 20:57:54 UTC (rev 55536)
@@ -1,81 +1,80 @@
-%%
-%% This is file `pdfpc.sty',
-%% generated with the docstrip utility.
-%%
-%% The original source files were:
-%%
-%% pdfpc.dtx (with options: `pdfpc.sty,package')
-%% pdfpc.dtx
-%% Copyright (C) 2020 Evgeny Stambulchik
-%%
-%% This file is part of pdfpc.
-%%
-%% This program is free software; you can redistribute it and/or modify
-%% it under the terms of the GNU General Public License as published by
-%% the Free Software Foundation; either version 3 of the License, or
-%% (at your option) any later version.
-%%
-%% This program is distributed in the hope that it will be useful,
-%% but WITHOUT ANY WARRANTY; without even the implied warranty of
-%% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-%% GNU General Public License for more details.
-%%
-%% You should have received a copy of the GNU General Public License along
-%% with this program; if not, write to the Free Software Foundation, Inc.,
-%% 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
-%%
-%% This work consists of the files pdfpc.dtx, pdfpc.ins, and the derived file
-%% pdfpc.sty
-%%
-%% \CharacterTable
-%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
-%% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
-%% Digits \0\1\2\3\4\5\6\7\8\9
-%% Exclamation \! Double quote \" Hash (number) \#
-%% Dollar \$ Percent \% Ampersand \&
-%% Acute accent \' Left paren \( Right paren \)
-%% Asterisk \* Plus \+ Comma \,
-%% Minus \- Point \. Solidus \/
-%% Colon \: Semicolon \; Less than \<
-%% Equals \= Greater than \> Question mark \?
-%% Commercial at \@ Left bracket \[ Backslash \\
-%% Right bracket \] Circumflex \^ Underscore \_
-%% Grave accent \` Left brace \{ Vertical bar \|
-%% Right brace \} Tilde \~}
-\ProvidesPackage{pdfpc}[2019/12/03 v0.2.1 PDFPC]
+% This file is part of pdfpc.
+% Copyright (C) 2020 Evgeny Stambulchik
+%
+% This program is free software; you can redistribute it and/or modify
+% it under the terms of the GNU General Public License as published by
+% the Free Software Foundation; either version 3 of the License, or
+% (at your option) any later version.
+%
+% This program is distributed in the hope that it will be useful,
+% but WITHOUT ANY WARRANTY; without even the implied warranty of
+% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+% GNU General Public License for more details.
+%
+% You should have received a copy of the GNU General Public License along
+% with this program; if not, write to the Free Software Foundation, Inc.,
+% 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+% -------------------------------------------------------------------------------------------
+%
+% Allow for defining some meta data and simple textual notes for use
+% with the pdfpc presentation application <https://pdfpc.github.io>.
+%
+% -------------------------------------------------------------------------------------------
+%
+% Inspired by Carsten Brandt's <https://github.com/cebe/pdfpc-latex-notes>.
+%
+% -------------------------------------------------------------------------------------------
+%
+% Please report bugs and other problems as well as suggestions for improvements
+% to the issue tracker at github <https://github.com/pdfpc/pdfpc/>
+%
+% -------------------------------------------------------------------------------------------
+%
+\ProvidesPackage{pdfpc}[2020/06/10 v0.4.0 PDFPC]
\NeedsTeXFormat{LaTeX2e}
+%
+% Require additional packages needed by \sty{pdfpc}:
\RequirePackage{kvoptions}
\RequirePackage{xstring}
\RequirePackage{pdfcomment}
\RequirePackage{hyperxmp}
+%
\SetupKeyvalOptions{
family=PDFPC,
prefix=PDFPC@
}
+%
\DeclareStringOption{duration}
\DeclareStringOption{starttime}
\DeclareStringOption{endtime}
\DeclareStringOption{enduserslide}
\DeclareStringOption{lastminutes}
+\DeclareBoolOption{hidenotes}
\DeclareBoolOption{overridenote}
\DeclareStringOption{notesposition}
+\DeclareStringOption{defaulttransition}
\DeclareDefaultOption{\@unknownoptionerror}
+%
\ProcessKeyvalOptions*
+%
\ifx\PDFPC at duration\@empty
\else
\IfInteger{\PDFPC at duration}{}
{\PackageWarningNoLine{pdfpc}{`duration' should be an integer}}%
\fi
+%
\ifx\PDFPC at enduserslide\@empty
\else
\IfInteger{\PDFPC at enduserslide}{}
{\PackageWarningNoLine{pdfpc}{`enduserslide' should be an integer}}%
\fi
+%
\ifx\PDFPC at lastminutes\@empty
\else
\IfInteger{\PDFPC at lastminutes}{}
{\PackageWarningNoLine{pdfpc}{`lastminutes' should be an integer}}%
\fi
+%
\ifPDFPC at overridenote
\renewcommand{\note}[2][]{%
\IfStrEq{#1}{item}%
@@ -84,10 +83,13 @@
{\pdfpcnote{#2}}%
}%
\fi
+%
\def\pdfpc at notespositionauto{auto}%
\ifx\PDFPC at notesposition\@empty%
\def\PDFPC at notesposition{auto}%
\fi%
+%
+% Guesswork for beamer/pgfpages notes
\ifx\PDFPC at notesposition\pdfpc at notespositionauto%
\def\PDFPC at notesposition{none}%
\def\pdfpc at onepaperheight{\paperheight}%
@@ -115,6 +117,8 @@
\fi%
\fi%
\fi%
+%
+% Our schema
\newcommand*{\pdfpc at schema}{%
\hyxmp at add@to at xml{%
______<rdf:Description xmlns:pdfpc="https://github.com/pdfpc/pdfpc">^^J%
@@ -125,14 +129,21 @@
\hyxmp at add@simple{pdfpc:EndUserSlide}{\PDFPC at enduserslide}%
\hyxmp at add@simple{pdfpc:LastMinutes}{\PDFPC at lastminutes}%
\hyxmp at add@simple{pdfpc:NotesPosition}{\PDFPC at notesposition}%
+ \hyxmp at add@simple{pdfpc:DefaultTransition}{\PDFPC at defaulttransition}%
\hyxmp at add@to at xml{%
______</rdf:Description>^^J%
}%
}
+%
+% Piggybacking on the hyperxmp schema...
\let\oldhyxmp at pdf@schema\hyxmp at pdf@schema
\renewcommand{\hyxmp at pdf@schema}{{\oldhyxmp at pdf@schema}{\pdfpc at schema}}
-
-\newcommand{\pdfpcnote}[1]{\pdfmargincomment{#1}}
+%
+% Note command
+\ifPDFPC at hidenotes%
+ \newcommand{\pdfpcnote}[1]{}
+\else%
+ \newcommand{\pdfpcnote}[1]{\pdfmargincomment{#1}}
+\fi%
+%
\endinput
-%%
-%% End of file `pdfpc.sty'.
More information about the tex-live-commits
mailing list.