diff options
author | Karl Berry <karl@freefriends.org> | 2022-10-03 20:27:15 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2022-10-03 20:27:15 +0000 |
commit | df1626bce3096a07014893241d417fde7df28ee7 (patch) | |
tree | 16a77d81b4e078a40725915a76fb244879cb805c /Master | |
parent | f7f5fd25ef890918b2dbc14c7bd47c0865d42d59 (diff) |
clicks (3oct22)
git-svn-id: svn://tug.org/texlive/trunk@64592 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rw-r--r-- | Master/texmf-dist/doc/latex/clicks/LICENSE.txt | 21 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/clicks/README.md | 5 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/clicks/clicks.pdf | bin | 261653 -> 243984 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/clicks/clicks.tex | 92 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/clicks/clicks.dtx | 234 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/clicks/clicks.ins | 55 | ||||
-rw-r--r-- | Master/texmf-dist/tex/latex/clicks/clicks.sty | 80 |
7 files changed, 358 insertions, 129 deletions
diff --git a/Master/texmf-dist/doc/latex/clicks/LICENSE.txt b/Master/texmf-dist/doc/latex/clicks/LICENSE.txt new file mode 100644 index 00000000000..bd949ffdabc --- /dev/null +++ b/Master/texmf-dist/doc/latex/clicks/LICENSE.txt @@ -0,0 +1,21 @@ +(The MIT License) + +Copyright (c) 2021-2022 Yegor Bugayenko + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the 'Software'), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/Master/texmf-dist/doc/latex/clicks/README.md b/Master/texmf-dist/doc/latex/clicks/README.md index f77fe273236..5357152b3b3 100644 --- a/Master/texmf-dist/doc/latex/clicks/README.md +++ b/Master/texmf-dist/doc/latex/clicks/README.md @@ -1,4 +1,4 @@ -[![make](https://github.com/yegor256/clicks/actions/workflows/latexmk.yml/badge.svg)](https://github.com/yegor256/clicks/actions/workflows/latexmk.yml) +[![make](https://github.com/yegor256/clicks/actions/workflows/l3build.yml/badge.svg)](https://github.com/yegor256/clicks/actions/workflows/l3build.yml) [![CTAN](https://img.shields.io/ctan/v/clicks)](https://ctan.org/pkg/clicks) [![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/yegor256/clicks/blob/master/LICENSE.txt) @@ -20,9 +20,6 @@ And then live happily ever after. \end{document} ``` -The full example and all commands are available in the -[`clicks.tex`](https://github.com/yegor256/clicks/blob/master/clicks.tex) file. - If you want to contribute yourself, make a fork, then create a branch, then run `make` in the root directory. It should compile everything without errors. If not, submit an issue and wait. diff --git a/Master/texmf-dist/doc/latex/clicks/clicks.pdf b/Master/texmf-dist/doc/latex/clicks/clicks.pdf Binary files differindex 41a3696a455..9f26f164937 100644 --- a/Master/texmf-dist/doc/latex/clicks/clicks.pdf +++ b/Master/texmf-dist/doc/latex/clicks/clicks.pdf diff --git a/Master/texmf-dist/doc/latex/clicks/clicks.tex b/Master/texmf-dist/doc/latex/clicks/clicks.tex deleted file mode 100644 index 79676014101..00000000000 --- a/Master/texmf-dist/doc/latex/clicks/clicks.tex +++ /dev/null @@ -1,92 +0,0 @@ -% (The MIT License) -% -% Copyright (c) 2021-2022 Yegor Bugayenko -% -% Permission is hereby granted, free of charge, to any person obtaining a copy -% of this software and associated documentation files (the 'Software'), to deal -% in the Software without restriction, including without limitation the rights -% to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -% copies of the Software, and to permit persons to whom the Software is -% furnished to do so, subject to the following conditions: -% -% The above copyright notice and this permission notice shall be included in all -% copies or substantial portions of the Software. -% -% THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -% IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -% FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -% AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -% LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -% OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -% SOFTWARE. - -\documentclass[12pt]{article} -\usepackage[T1]{fontenc} -\usepackage[tt=false,type1=true]{libertine} -\usepackage{clicks} -\usepackage{ffcode} - -\title{\ff{clicks}: \LaTeX{} Package \\ for Slide Deck Animation} -\author{Yegor Bugayenko} -\date{0.3.1 2022/09/13} - -\begin{document} -\pagenumbering{gobble} -\raggedbottom -\setlength{\parindent}{0pt} -\setlength{\columnsep}{32pt} -\setlength{\parskip}{6pt} - -\maketitle - -\section[Intro]{Introduction} - -This package helps simulate animation in PDF documents. You put -some content on the page, then you ``click'' and the pages ends, -while the content gets copied to the next page. There, you add new -content. In the full-screen presentation mode this will look -like animation, similar to what you can get with MS PowerPoint. - -\begin{ffcode} -\documentclass{article} -\usepackage{clicks} -\begin{document} -\print{Here is your wedding plan:}\click -\print{1. Buy a ring}\click -\print{2. Propose}\click -\print{3. Get married}\flush -\end{document} -\end{ffcode} - -You can make it shorter, with the help of -\ff{\char`\\plick\{\}} and \ff{\char`\\plush\{\}} commands: - -\begin{ffcode} -\documentclass{article} -\usepackage{clicks} -\begin{document} -\plick[2]{Here is your wedding plan:} -\plick[3]{1. Buy a ring} -\plick[5]{2. Propose} -\plush[1]{3. Get married} -\end{document} -\end{ffcode} - -If you need to render the document without animation, just -use the \ff{static} package option. - -The optional parameters at \ff{\char`\\plick\{\}} and \ff{\char`\\plush\{\}} -are the minutes: how long you are planning to stay at this animation. -The minutes are accumulated in the \ff{minutes} counter, which -you can show, for example, at your header. This will help you track -time during the presentation. The commands -\ff{\char`\\click\{\}} and \ff{\char`\\flush\{\}} also have the -same optional arguments. - -More details about this package you can find -in the \ff{yegor256/clicks} GitHub repository. - -If you want to add a feature or fix a bug, you are welcome -to submit an issue or make a pull request. - -\end{document} diff --git a/Master/texmf-dist/source/latex/clicks/clicks.dtx b/Master/texmf-dist/source/latex/clicks/clicks.dtx new file mode 100644 index 00000000000..d103ee064f8 --- /dev/null +++ b/Master/texmf-dist/source/latex/clicks/clicks.dtx @@ -0,0 +1,234 @@ +% \iffalse meta-comment +% (The MIT License) +% +% Copyright (c) 2021-2022 Yegor Bugayenko +% +% Permission is hereby granted, free of charge, to any person obtaining a copy +% of this software and associated documentation files (the 'Software'), to deal +% in the Software without restriction, including without limitation the rights +% to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +% copies of the Software, and to permit persons to whom the Software is +% furnished to do so, subject to the following conditions: +% +% The above copyright notice and this permission notice shall be included in all +% copies or substantial portions of the Software. +% +% THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +% IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +% FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +% AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +% LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +% OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +% SOFTWARE. +% \fi + +% \CheckSum{0} +% +% \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 \~} + +% \GetFileInfo{clicks.dtx} +% \DoNotIndex{\endgroup,\begingroup,\let,\else,\fi,\newcommand,\newenvironment} + +% \iffalse +%<*driver> +\ProvidesFile{clicks.dtx} +%</driver> +%<package>\NeedsTeXFormat{LaTeX2e} +%<package>\ProvidesPackage{clicks} +%<*package> +[2022-10-03 0.4.1 Slide Deck Animation] +%</package> +%<*driver> +\documentclass{ltxdoc} +\usepackage[tt=false, type1=true]{libertine} +\usepackage{clicks} +\usepackage{href-ul} +\PageIndex +\EnableCrossrefs +\CodelineIndex +\RecordChanges +\begin{document} + \DocInput{clicks.dtx} + \PrintChanges + \PrintIndex +\end{document} +%</driver> +% \fi + +% \title{|clicks|: \LaTeX{} Package \\ for Slide Deck Animation\thanks{The sources are in GitHub at \href{https://github.com/yegor256/clicks}{yegor256/clicks}}} +% \author{Yegor Bugayenko \\ \texttt{yegor256@gmail.com}} +% \date{\filedate, \fileversion} +% +% \maketitle +% +% \section{Introduction} +% +% This package helps simulate animation in PDF documents. You put +% some content on the page, then you ``click'' and the pages ends, +% while the content gets copied to the next page. There, you add new +% content. In the full-screen presentation mode this will look +% like animation, similar to what you can get with MS PowerPoint: +%\iffalse +%<*verb> +%\fi +\begin{verbatim} +\documentclass{article} +\usepackage{clicks} +\begin{document} +\print{Here is your wedding plan:}\click +\print{1. Buy a ring}\click +\print{2. Propose}\click +\print{3. Get married}\flush +\end{document} +\end{verbatim} +%\iffalse +%</verb> +%\fi + +% You can make it shorter, with the help of +% |\plick| and |\plush| commands: +%\iffalse +%<*verb> +%\fi +\begin{verbatim} +\documentclass{article} +\usepackage{clicks} +\begin{document} +\plick[2]{Here is your wedding plan:} +\plick[3]{1. Buy a ring} +\plick[5]{2. Propose} +\plush[1]{3. Get married} +\end{document} +\end{verbatim} +%\iffalse +%</verb> +%\fi + +% The optional parameters at |\plick| and |\plush| +% are the minutes: how long you are planning to stay at this animation. +% The minutes are accumulated in the |minutes| counter, which +% you can show, for example, at your header. This will help you track +% time during the presentation. The commands +% |\click| and |\flush| also have the +% same optional arguments. + +% \section{Package Options} + +% \begin{macro}{static} +% If you need to render the document without animation, just +% use the |static| package option. +% \end{macro} + +% \StopEventually{} + +% \section{Implementation} + +% \changes{v0.1.0}{2021/09/13}{Initial version} + +% First, we include a few packages: +% \begin{macrocode} +\RequirePackage{xkeyval} +\RequirePackage{etoolbox} +% \end{macrocode} + +% Then, we parse package options: +% \begin{macrocode} +\makeatletter +\newif\ifclicks@static +\DeclareOption{static}{\clicks@statictrue} +\makeatother +\ProcessOptions\relax +% \end{macrocode} + +% Then, we define a few supplementary commands: +% \begin{macrocode} +\makeatletter\newcommand*\clicks@body{}\makeatother +\makeatletter\newcommand\clicks@flush{% + \clicks@body\vspace*{0pt}\newpage% +}\makeatother +% \end{macrocode} + +% Then, we declare a counter of minutes: +% \begin{macrocode} +\newcounter{minutes} +% \end{macrocode} + +% \begin{macro}{\print} +% Then, we define |\print| command: +% \begin{macrocode} +\makeatletter\newcommand\print[1]{% + \gappto\clicks@body{{#1\par}}% +}\makeatother +% \end{macrocode} +% \end{macro} + +% \begin{macro}{\flush} +% Then, we define |\flush| command: +% \begin{macrocode} +\makeatletter\newcommand\flush[1][1]{% + \ifx\clicks@body\empty\else% + \clicks@flush% + \renewcommand*\clicks@body{}% + \fi% + \ifclicks@static\else% + \addtocounter{minutes}{#1}% + \fi% +} +% \end{macrocode} +% \end{macro} + +% \begin{macro}{\click} +% Then, we define |\click| command: +% \begin{macrocode} +\makeatletter\newcommand\click[1][0]{% + \ifclicks@static\else% + \addtocounter{minutes}{#1}% + \fi% + \ifclicks@static\else% + \clicks@flush% + \fi% +}\makeatother +% \end{macrocode} +% \end{macro} + +% \begin{macro}{\plush} +% Then, we define |\plush| command: +% \begin{macrocode} +\newcommand\plush[2][1]{% + \print{#2}% + \flush[#1]% +} +% \end{macrocode} +% \end{macro} + +% \begin{macro}{\plick} +% Then, we define |\plick| command: +% \begin{macrocode} +\newcommand\plick[2][1]{% + \print{#2}% + \click[#1]% +} +% \end{macrocode} +% \end{macro} + +% \Finale + +%\clearpage +% +%\PrintChanges +%\clearpage +%\PrintIndex diff --git a/Master/texmf-dist/source/latex/clicks/clicks.ins b/Master/texmf-dist/source/latex/clicks/clicks.ins new file mode 100644 index 00000000000..28083d43efb --- /dev/null +++ b/Master/texmf-dist/source/latex/clicks/clicks.ins @@ -0,0 +1,55 @@ +%% (The MIT License) +%% +%% Copyright (c) 2021-2022 Yegor Bugayenko +%% +%% Permission is hereby granted, free of charge, to any person obtaining a copy +%% of this software and associated documentation files (the 'Software'), to deal +%% in the Software without restriction, including without limitation the rights +%% to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +%% copies of the Software, and to permit persons to whom the Software is +%% furnished to do so, subject to the following conditions: +%% +%% The above copyright notice and this permission notice shall be included in all +%% copies or substantial portions of the Software. +%% +%% THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +%% IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +%% FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +%% AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +%% LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +%% OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +%% SOFTWARE. + +\input docstrip.tex +\keepsilent +\usedir{macros/latex/contrib/clicks} +\preamble +(The MIT License) + +Copyright (c) 2021-2022 Yegor Bugayenko + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the 'Software'), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +\endpreamble +\generate{\file{clicks.sty}{\from{clicks.dtx}{package}}} +\obeyspaces +\Msg{*** To finish the installation you have to move the ".sty"} +\Msg{*** file into a directory searched by TeX. To produce the} +\Msg{*** documentation run the file ".dtx" through LaTeX. If any} +\Msg{*** questions, submit a new GitHub issue.} +\endbatchfile diff --git a/Master/texmf-dist/tex/latex/clicks/clicks.sty b/Master/texmf-dist/tex/latex/clicks/clicks.sty index b2aa13ff699..ee29f813a53 100644 --- a/Master/texmf-dist/tex/latex/clicks/clicks.sty +++ b/Master/texmf-dist/tex/latex/clicks/clicks.sty @@ -1,33 +1,53 @@ -% (The MIT License) -% -% Copyright (c) 2021-2022 Yegor Bugayenko -% -% Permission is hereby granted, free of charge, to any person obtaining a copy -% of this software and associated documentation files (the 'Software'), to deal -% in the Software without restriction, including without limitation the rights -% to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -% copies of the Software, and to permit persons to whom the Software is -% furnished to do so, subject to the following conditions: -% -% The above copyright notice and this permission notice shall be included in all -% copies or substantial portions of the Software. -% -% THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -% IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -% FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -% AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -% LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -% OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -% SOFTWARE. +%% +%% This is file `clicks.sty', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% clicks.dtx (with options: `package') +%% (The MIT License) +%% +%% Copyright (c) 2021-2022 Yegor Bugayenko +%% +%% Permission is hereby granted, free of charge, to any person obtaining a copy +%% of this software and associated documentation files (the 'Software'), to deal +%% in the Software without restriction, including without limitation the rights +%% to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +%% copies of the Software, and to permit persons to whom the Software is +%% furnished to do so, subject to the following conditions: +%% +%% The above copyright notice and this permission notice shall be included in all +%% copies or substantial portions of the Software. +%% +%% THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +%% IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +%% FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +%% AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +%% LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +%% OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +%% SOFTWARE. + + \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{clicks}[2022/09/13 0.3.1 Clicks] +\ProvidesPackage{clicks} +[2022-10-03 0.4.1 Slide Deck Animation] + + + + + + + + \RequirePackage{xkeyval} \RequirePackage{etoolbox} -\makeatletter\newif\ifclicks@static\makeatother -\makeatletter\DeclareOption{static}{\clicks@statictrue}\makeatother +\makeatletter +\newif\ifclicks@static +\DeclareOption{static}{\clicks@statictrue} +\makeatother \ProcessOptions\relax \makeatletter\newcommand*\clicks@body{}\makeatother @@ -37,12 +57,10 @@ \newcounter{minutes} -% Print the content as is. \makeatletter\newcommand\print[1]{% \gappto\clicks@body{{#1\par}}% }\makeatother -% Flush the page: print the entire content. \makeatletter\newcommand\flush[1][1]{% \ifx\clicks@body\empty\else% \clicks@flush% @@ -53,7 +71,6 @@ \fi% } -% Print the content and wait for more. \makeatletter\newcommand\click[1][0]{% \ifclicks@static\else% \addtocounter{minutes}{#1}% @@ -63,20 +80,17 @@ \fi% }\makeatother -% Print and flush -% [1]: How many minutes to stay here -% {1}: The content to print \newcommand\plush[2][1]{% \print{#2}% \flush[#1]% } -% Print and click -% [1]: How many minutes to stay here -% {1}: The content to print \newcommand\plick[2][1]{% \print{#2}% \click[#1]% } + \endinput +%% +%% End of file `clicks.sty'. |