diff options
author | Karl Berry <karl@freefriends.org> | 2022-11-22 22:27:41 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2022-11-22 22:27:41 +0000 |
commit | ae8f4fb50da58825a500031103ec009d82c4fa56 (patch) | |
tree | 30d63ab9d5163e55a9d97675022d418074475251 /Master | |
parent | 383ade8f42bfc4c156b9739d28ae96d370178753 (diff) |
pagecolor (21nov22)
git-svn-id: svn://tug.org/texlive/trunk@65086 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rw-r--r-- | Master/texmf-dist/doc/latex/pagecolor/README | 34 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.pdf | bin | 85717 -> 81832 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.tex | 92 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf | bin | 320120 -> 339411 bytes | |||
-rw-r--r-- | Master/texmf-dist/source/latex/pagecolor/pagecolor.drv | 41 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/pagecolor/pagecolor.dtx | 800 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/pagecolor/pagecolor.ins | 42 | ||||
-rw-r--r-- | Master/texmf-dist/tex/latex/pagecolor/pagecolor.sty | 366 |
8 files changed, 614 insertions, 761 deletions
diff --git a/Master/texmf-dist/doc/latex/pagecolor/README b/Master/texmf-dist/doc/latex/pagecolor/README index a1dc382c79e..0bae5caeb6f 100644 --- a/Master/texmf-dist/doc/latex/pagecolor/README +++ b/Master/texmf-dist/doc/latex/pagecolor/README @@ -1,4 +1,4 @@ -README for pagecolor package, 2017/05/29, v1.0i +README for pagecolor package, 2022-11-20, v1.1a TABLE OF CONTENTS @@ -18,25 +18,25 @@ TABLE OF CONTENTS ============== This LaTeX package provides the command \thepagecolor, which gives -the current page (background) colour, i. e. the argument used with +the current page (background) color, i. e. the argument used with the most recent call of \pagecolor{...}. -The command \thepagecolornone gives the same colour as -\thepagecolor, except when the page background colour is "none". +The command \thepagecolornone gives the same color as +\thepagecolor, except when the page background color is "none". In that case \thepagecolor is white and \thepagecolornone is none. -When \nopagecolor is unknown (e.g. Xe(La)TeX) or broken (crop package) +When \nopagecolor is unknown or broken (crop package), this package provides a replacement. -Similar to \newgeometry and \restoregeometry of the geometry -package \newpagecolor{...} and \restorepagecolor are provided. +Similar to \newgeometry and \restoregeometry of the geometry package +\newpagecolor{...} and \restorepagecolor are provided. This material is published under the LPPL 1.3c: This work may be distributed and/or modified under the conditions of the LaTeX Project -Public License, either version 1.3c of this license or (at your option) any -later version. This version of this license is in -http://www.latex-project.org/lppl/lppl-1-3c.txt +Public License, either version 1.3c of this license or (at your option) +any later version. This version of this license is in +https://www.latex-project.org/lppl/lppl-1-3c.txt and the latest version of this license is in -http://www.latex-project.org/lppl.txt +https://www.latex-project.org/lppl.txt and version 1.3c or later is part of all distributions of LaTeX version -2005/12/01 or later. +2008-05-04 or later. 2 DOWNLOAD @@ -52,7 +52,7 @@ driver (pagecolor.drv), pagecolor.dtx, installation file (pagecolor.ins), the style file (pagecolor.sty), and this README, already sorted in a TDS tree: -http://mirrors.ctan.org/install/macros/latex/contrib/pagecolor.tds.zip +https://mirrors.ctan.org/install/macros/latex/contrib/pagecolor.tds.zip 3 INSTALLATION @@ -105,8 +105,8 @@ g) Copy the documentation files to ===================== pagecolor loads other packages: -kvoptions, xcolor (if the color package has not been loaded -before pagecolor), ifpdf, and ifluatex, +kvoptions and +xcolor, if the color package has not been loaded before pagecolor which again load other packages (see the result of the \listfiles command in the log-file of the example). @@ -142,8 +142,8 @@ A bug report should contain: contain any unnecessary packages and code. * Used drivers/programs. * Version information about used packages and programs. -* If you are using LaTeX, then add "\listfiles". Then - a list of version information is printed at the end +* If you are using LaTeX, then add "\listfiles" to the document. + Then a list of version information is printed at the end of the LaTeX run. * Please no other files than the minimal test file. The other files .log, .dvi, .ps, .pdf are seldom diff --git a/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.pdf b/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.pdf Binary files differindex dba8dd4f911..ae63e8048c5 100644 --- a/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.pdf +++ b/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.pdf diff --git a/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.tex b/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.tex index da72469ed78..937d23eb980 100644 --- a/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.tex +++ b/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.tex @@ -9,13 +9,13 @@ %% This is a generated file. %% %% Project: pagecolor -%% Version: 2017/05/29 v1.0i +%% Version: 2022-11-20 v1.1a %% -%% Copyright (C) 2011 - 2017 by -%% H.-Martin M"unch <Martin dot Muench at Uni-Bonn dot de> +%% Copyright (C) 2011 - 2022 by +%% H.-Martin Muench <Martin dot Muench at Uni-Bonn dot de> %% %% The usual disclaimer applies: -%% If it doesn't work right that's your problem. +%% If it does not work right that is your problem. %% (Nevertheless, send an e-mail to the maintainer %% when you find an error in this package.) %% @@ -23,11 +23,11 @@ %% conditions of the LaTeX Project Public License, either %% version 1.3c of this license or (at your option) any later %% version. This version of this license is in -%% http://www.latex-project.org/lppl/lppl-1-3c.txt +%% https://www.latex-project.org/lppl/lppl-1-3c.txt %% and the latest version of this license is in -%% http://www.latex-project.org/lppl.txt +%% https://www.latex-project.org/lppl.txt %% and version 1.3c or later is part of all distributions of -%% LaTeX version 2005/12/01 or later. +%% LaTeX version 2005-12-01 or later. %% %% This work has the LPPL maintenance status "maintained". %% @@ -40,12 +40,12 @@ %% pagecolor-example.tex, pagecolor-example.pdf. %% %% In memoriam -%% Claudia Simone Barth + 1996/01/30 -%% Tommy Muench + 2014/01/02 -%% Hans-Klaus Muench + 2014/08/24 +%% Claudia Simone Barth + 1996-01-30 +%% Tommy Muench + 2014-01-02 +%% Hans-Klaus Muench + 2014-08-24 %% -\documentclass[british]{article}[2014/09/29]% v1.4h -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\NeedsTeXFormat{LaTeX2e}[2021-11-15] +\documentclass[british]{article}[2021/10/04]% v1.4n \usepackage[% extension=pdf,% plainpages=false,% @@ -55,67 +55,57 @@ pdftitle={pagecolor package example},% pdfauthor={H.-Martin Muench},% pdfsubject={Example for the pagecolor package},% - pdfkeywords={LaTeX, pagecolor, thepagecolor, page colour,% - H.-Martin Muench},% + pdfkeywords={LaTeX, pagecolor, thepagecolor, page color, page colour},% pdfview=Fit,pdfstartview=Fit,% pdfpagelayout=SinglePage% -]{hyperref}[2012/11/06]% v6.83m -\usepackage[x11names]{xcolor}[2007/01/21]% v2.11 - % The xcolor package would not be needed for just using - % the base colours. The color package would be sufficient for that. -\definecolor{darkgreen}{rgb}{0.0, 0.3, 0.0}% +]{hyperref}[2022-02-21]% v7.00n + +\usepackage[x11names]{xcolor}[2021/10/31]% v2.13 + % The xcolor package would not be needed for just using the base colors. + % The color package would be sufficient for that. + \usepackage[pagecolor={LightGoldenrod1},% - nopagecolor={none}]{pagecolor}[2017/05/29]% v1.0i + nopagecolor={none}]{pagecolor}[2022-11-20]% v1.1a \usepackage{afterpage}[2014/10/28]% v1.08 % The afterpage package is generally not needed, - % but the |\newpagecolor{somecolour}\afterpage{\restorepagecolor}| + % but the |\newpagecolor{somecolor}\afterpage{\restorepagecolor}| % construct shall be demonstrated. -\usepackage{lipsum}[2014/07/27]% v1.3 +\usepackage{lipsum}[2021-09-20]% v2.7 % The lipsum package is generally not needed, % but some blind text is needed for the example. -\usepackage{hologo}[2012/04/26]% v1.10 - % The hologo package is only needed to write - % \hologo{pdfTeX}, \hologo{LuaTeX}, and \hologo{XeTeX}. - -\gdef\unit#1{\mathord{\thinspace\mathrm{#1}}}% -\listfiles% +\listfiles \begin{document} \pagenumbering{arabic} \section*{Example for pagecolor} This example demonstrates the use of package\newline -\textsf{pagecolor}, v1.0i as of 2017/05/29 (HMM).\newline +\textsf{pagecolor}, v1.1a as of 2022-11-20 (HMM).\newline The used options were\newline -\verb|pagecolor={LightGoldenrod1}| (\verb|pagecolor={none}| -would be the default), and -\verb|pagecolor={none}| (which is the default).\newline +\verb|pagecolor={LightGoldenrod1}|\newline +(\verb|pagecolor={none}| would be the default), and\newline +\verb|nopagecolor={none}| (which is the default). -\noindent For more details please see the documentation!\newline +\noindent For more details please see the documentation! -\noindent {\color{darkgreen} Save per page about $200\unit{ml}$ water, -$2\unit{g}$ CO$_{2}$ and $2\unit{g}$ wood:\newline -Therefore please print only if this is really necessary.}\newline - -\noindent The current page (background) colour is\newline +\noindent The current page (background) color is\newline \verb|\thepagecolor|\ =\ \thepagecolor \newline (and \verb|\thepagecolornone|\ =\ \thepagecolornone , which would only be different from \verb|\thepagecolor|, -when the page colour would be \verb|none|). +when the page color would be \verb|none|). \pagebreak \pagecolor{rgb:-green!40!yellow,3;green!40!yellow,2;red,1} -{\color{white} The current page (background) colour is\newline -\verb|\thepagecolor|\ =\ \thepagecolor . \newline} +{\color{white} The current page (background) color is\newline +\verb|\thepagecolor|\ =\ \thepagecolor .} -{\color{\thepagecolor} And that makes this text practically invisible. -\newline} +{\color{\thepagecolor} And that makes this text practically invisible.} {\color{white} Which made the preceding line of text practically -invisible.} +invisible, but it can be copied and pasted.} \pagebreak \newpagecolor{red} @@ -126,23 +116,23 @@ This page uses \verb|\newpagecolor{red}|. \restorepagecolor {\color{white}And this page uses \verb|\restorepagecolor| to restore -the page colour to the value it had before the red page.} +the page color to the value it had before the red page.} \pagebreak \pagecolor{none} This page uses \verb|\pagecolor{none}|. If the \verb|\nopagecolor| -command is known (\hologo{pdfTeX} and \hologo{LuaTeX}; not yet for -dvips, dvipdfm(x) or \hologo{XeTeX}), the page colour is now +command is known, the page color is now \verb|none| (because option \verb|nopagecolor={none}|), otherwise -\verb|white| (or the colour given with option \verb|nopagecolor={...}|): +\verb|white| (or the color given with option \verb|nopagecolor={...}|): +\newline \verb|\thepagecolor|\ =\ \thepagecolor\ and \verb|\thepagecolornone|\ =\ \thepagecolornone . \pagebreak \restorepagecolor -{\color{white}\verb|\restorepagecolor| restored the page colour again.} +{\color{white}\verb|\restorepagecolor| restored the page color again.} \pagebreak \pagecolor{green} @@ -155,14 +145,14 @@ This page is green due to \verb|\pagecolor{green}|. {\color{white}\verb|\newpagecolor{blue}\afterpage{\restorepagecolor}|% \newline was used here, i.\,e.~this page is blue, and the next one will -automatically have the same page colour before it was changed to blue +automatically have the same page color before it was changed to blue here (i.\,e. green).} \smallskip {\color{red}\textbf{\lipsum[1-11]}} \bigskip -The page colour was changed back at the end of the page - +The page color was changed back at the end of the page -- in mid-sentence! \end{document} diff --git a/Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf b/Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf Binary files differindex d2f611b6ee7..08642c75e5a 100644 --- a/Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf +++ b/Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf diff --git a/Master/texmf-dist/source/latex/pagecolor/pagecolor.drv b/Master/texmf-dist/source/latex/pagecolor/pagecolor.drv index 31e35c7db5c..fb5c29f1927 100644 --- a/Master/texmf-dist/source/latex/pagecolor/pagecolor.drv +++ b/Master/texmf-dist/source/latex/pagecolor/pagecolor.drv @@ -9,13 +9,13 @@ %% This is a generated file. %% %% Project: pagecolor -%% Version: 2017/05/29 v1.0i +%% Version: 2022-11-20 v1.1a %% -%% Copyright (C) 2011 - 2017 by -%% H.-Martin M"unch <Martin dot Muench at Uni-Bonn dot de> +%% Copyright (C) 2011 - 2022 by +%% H.-Martin Muench <Martin dot Muench at Uni-Bonn dot de> %% %% The usual disclaimer applies: -%% If it doesn't work right that's your problem. +%% If it does not work right that is your problem. %% (Nevertheless, send an e-mail to the maintainer %% when you find an error in this package.) %% @@ -23,11 +23,11 @@ %% conditions of the LaTeX Project Public License, either %% version 1.3c of this license or (at your option) any later %% version. This version of this license is in -%% http://www.latex-project.org/lppl/lppl-1-3c.txt +%% https://www.latex-project.org/lppl/lppl-1-3c.txt %% and the latest version of this license is in -%% http://www.latex-project.org/lppl.txt +%% https://www.latex-project.org/lppl.txt %% and version 1.3c or later is part of all distributions of -%% LaTeX version 2005/12/01 or later. +%% LaTeX version 2005-12-01 or later. %% %% This work has the LPPL maintenance status "maintained". %% @@ -40,25 +40,19 @@ %% pagecolor-example.tex, pagecolor-example.pdf. %% %% In memoriam -%% Claudia Simone Barth + 1996/01/30 -%% Tommy Muench + 2014/01/02 -%% Hans-Klaus Muench + 2014/08/24 +%% Claudia Simone Barth + 1996-01-30 +%% Tommy Muench + 2014-01-02 +%% Hans-Klaus Muench + 2014-08-24 %% -\NeedsTeXFormat{LaTeX2e}[2014/05/01] +\NeedsTeXFormat{LaTeX2e}[2021-11-15] \ProvidesFile{pagecolor.drv}% - [2017/05/29 v1.0i Provides thepagecolor (HMM)] -\documentclass{ltxdoc}[2014/09/29]% v2.0u -\usepackage{xcolor}[2007/01/21]% v2.11 -\definecolor{darkgreen}{rgb}{0.0, 0.3, 0.0}% -\usepackage{holtxdoc}[2012/03/21]% v0.24 -%% pagecolor may work with earlier versions of LaTeX2e and those -%% class and package, but this was not tested. -%% Please consider updating your LaTeX, class, and package -%% to the most recent version (if they are not already the most -%% recent version). + [2022-11-20 v1.1a Provides thepagecolor (HMM)] +\documentclass{ltxdoc}[2020/12/05]% v2.1b +\usepackage{xcolor}[2021/10/31]% v2.13 +\usepackage{holtxdoc}[2019/12/09]% v0.30 \hypersetup{% pdfsubject={Providing the thepagecolor command (HMM)},% - pdfkeywords={LaTeX, pagecolor, thepagecolor, H.-Martin Muench},% + pdfkeywords={LaTeX, pagecolor, thepagecolor},% pdfencoding=auto,% pdflang={en},% breaklinks=true,% @@ -74,8 +68,7 @@ pdfnewwindow=true% } \CodelineIndex -\hyphenation{printing docu-ment} -\gdef\unit#1{\mathord{\thinspace\mathrm{#1}}}% +\hyphenation{docu-ment} \begin{document} \DocInput{pagecolor.dtx}% \end{document} diff --git a/Master/texmf-dist/source/latex/pagecolor/pagecolor.dtx b/Master/texmf-dist/source/latex/pagecolor/pagecolor.dtx index 7df746c4504..c23d9c4b865 100644 --- a/Master/texmf-dist/source/latex/pagecolor/pagecolor.dtx +++ b/Master/texmf-dist/source/latex/pagecolor/pagecolor.dtx @@ -1,10 +1,10 @@ % \iffalse meta-comment % % File: pagecolor.dtx -% Version: 2017/05/29 v1.0i +% Version: 2022-11-20 v1.1a % -% Copyright (C) 2011 - 2017 by -% H.-Martin M"unch <Martin dot Muench at Uni-Bonn dot de> +% Copyright (C) 2011 - 2022 by +% H.-Martin Muench <Martin dot Muench at Uni-Bonn dot de> % % This work may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either @@ -14,7 +14,7 @@ % and the latest version of this license is in % http://www.latex-project.org/lppl.txt % and version 1.3c or later is part of all distributions of -% LaTeX version 2005/12/01 or later. +% LaTeX version 2005-12-01 or later. % % This work has the LPPL maintenance status "maintained". % @@ -31,7 +31,7 @@ % % Also a TDS.ZIP file is provided that contains all the files % already sorted in a TDS tree: -% http://mirror.ctan.org/install/macros/latex/contrib/pagecolor.tds.zip +% https://mirror.ctan.org/install/macros/latex/contrib/pagecolor.tds.zip % %<*ignore> \begingroup @@ -48,7 +48,7 @@ \input docstrip.tex \Msg{******************************************************************} \Msg{* Installation *} -\Msg{* Package: pagecolor 2017/05/29 v1.0i Provides thepagecolor (HMM)*} +\Msg{* Package: pagecolor 2022-11-20 v1.1a Provides thepagecolor (HMM)*} \Msg{******************************************************************} \keepsilent @@ -60,13 +60,13 @@ This is a generated file. Project: pagecolor -Version: 2017/05/29 v1.0i +Version: 2022-11-20 v1.1a -Copyright (C) 2011 - 2017 by - H.-Martin M"unch <Martin dot Muench at Uni-Bonn dot de> +Copyright (C) 2011 - 2022 by + H.-Martin Muench <Martin dot Muench at Uni-Bonn dot de> The usual disclaimer applies: -If it doesn't work right that's your problem. +If it does not work right that is your problem. (Nevertheless, send an e-mail to the maintainer when you find an error in this package.) @@ -74,11 +74,11 @@ This work may be distributed and/or modified under the conditions of the LaTeX Project Public License, either version 1.3c of this license or (at your option) any later version. This version of this license is in - http://www.latex-project.org/lppl/lppl-1-3c.txt + https://www.latex-project.org/lppl/lppl-1-3c.txt and the latest version of this license is in - http://www.latex-project.org/lppl.txt + https://www.latex-project.org/lppl.txt and version 1.3c or later is part of all distributions of -LaTeX version 2005/12/01 or later. +LaTeX version 2005-12-01 or later. This work has the LPPL maintenance status "maintained". @@ -91,9 +91,9 @@ the README, and the derived files pagecolor-example.tex, pagecolor-example.pdf. In memoriam - Claudia Simone Barth + 1996/01/30 - Tommy Muench + 2014/01/02 - Hans-Klaus Muench + 2014/08/24 + Claudia Simone Barth + 1996-01-30 + Tommy Muench + 2014-01-02 + Hans-Klaus Muench + 2014-08-24 \endpreamble \let\MetaPrefix\DoubleperCent @@ -148,21 +148,15 @@ In memoriam % % \begin{macrocode} %<*driver> -\NeedsTeXFormat{LaTeX2e}[2014/05/01] +\NeedsTeXFormat{LaTeX2e}[2021-11-15] \ProvidesFile{pagecolor.drv}% - [2017/05/29 v1.0i Provides thepagecolor (HMM)] -\documentclass{ltxdoc}[2014/09/29]% v2.0u -\usepackage{xcolor}[2007/01/21]% v2.11 -\definecolor{darkgreen}{rgb}{0.0, 0.3, 0.0}% -\usepackage{holtxdoc}[2012/03/21]% v0.24 -%% pagecolor may work with earlier versions of LaTeX2e and those -%% class and package, but this was not tested. -%% Please consider updating your LaTeX, class, and package -%% to the most recent version (if they are not already the most -%% recent version). + [2022-11-20 v1.1a Provides thepagecolor (HMM)] +\documentclass{ltxdoc}[2020/12/05]% v2.1b +\usepackage{xcolor}[2021/10/31]% v2.13 +\usepackage{holtxdoc}[2019/12/09]% v0.30 \hypersetup{% pdfsubject={Providing the thepagecolor command (HMM)},% - pdfkeywords={LaTeX, pagecolor, thepagecolor, H.-Martin Muench},% + pdfkeywords={LaTeX, pagecolor, thepagecolor},% pdfencoding=auto,% pdflang={en},% breaklinks=true,% @@ -178,8 +172,7 @@ In memoriam pdfnewwindow=true% } \CodelineIndex -\hyphenation{printing docu-ment} -\gdef\unit#1{\mathord{\thinspace\mathrm{#1}}}% +\hyphenation{docu-ment} \begin{document} \DocInput{pagecolor.dtx}% \end{document} @@ -188,24 +181,6 @@ In memoriam % % \fi % -% \CheckSum{335} -% -% \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{pagecolor.drv} % % \begingroup @@ -223,85 +198,69 @@ In memoriam % }%^^A % \expandafter\endgroup\x % -% \DoNotIndex{\",\-,\,,\\,\noindent} -% \DoNotIndex{\documentclass,\usepackage,\ProvidesPackage,\begin,\end} -% \DoNotIndex{\MessageBreak} -% \DoNotIndex{\NeedsTeXFormat,\DoNotIndex,\verb} -% \DoNotIndex{\def,\edef,\gdef,\xdef,\global} -% \DoNotIndex{\ifx,\listfiles,\mathord,\mathrm} -% \DoNotIndex{\kvoptions,\SetupKeyvalOptions,\ProcessKeyvalOptions} -% \DoNotIndex{\smallskip,\bigskip,\space,\thinspace,\ldots} -% \DoNotIndex{\indent,\noindent,\newline,\linebreak,\pagebreak,\newpage} -% \DoNotIndex{\textbf,\textit,\textsf,\texttt,\textsc} -% \DoNotIndex{\textquotedblleft,\textquotedblright} -% \DoNotIndex{\plainTeX,\TeX,\LaTeX,\pdfLaTeX} -% \DoNotIndex{\section,\color,\pagenumbering} -% \DoNotIndex{\pagecolourtmpa,\pagecolourtmpb,\pagecolourtmpc} +% \DoNotIndex{\,,\@bsphack,\@esphack,\\} +% \DoNotIndex{\documentclass,\usepackage,\begin,\end,\pagenumbering,\bigskip,\smallskip} +% \DoNotIndex{\space,\newline,\noindent,\pagebreak,\section,\textbf,\textsf,\color,\gdef} +% \DoNotIndex{\GenerateLogMacros,\holtxdoc,\Oberdiek,\hyperref,\kvoptions,\options,\OCG} +% \DoNotIndex{\lipsum,\ifdefined,\IfPackageAtLeastTF,\IfPackageLoadedTF,\ifx,\listfiles} +% \DoNotIndex{\M\"{u}nch,\Alternatives,\transparent,\newcommand,\verb} +% \DoNotIndex{\pagecolor@info@noline,\pagecolor@warning,\pagecolor@warning@noline} % % \title{The \xpackage{pagecolor} package} -% \date{2017/05/29 v1.0i} -% \author{H.-Martin M\"{u}nch\\\xemail{Martin.Muench at Uni-Bonn.de}} +% \date{2022-11-20 v1.1a} +% \author{H.-Martin Münch\\\xemail{Martin.Muench at Uni-Bonn.de}} % % \maketitle % % \begin{abstract} -% This \LaTeX{} package provides the command |\thepagecolor|, -% which gives the current page (background) colour, +% \noindent This \LaTeX{} package provides the command |\thepagecolor|, +% which gives the current page (background) color, % \hbox{i.\,e. the} argument used with the most recent call of |\pagecolor{...}|. -% The command |\thepagecolornone| gives the same colour as |\thepagecolor|, -% except when the page background colour is +% The command |\thepagecolornone| gives the same color as |\thepagecolor|, +% except when the page background color is % \textquotedblleft|none|\textquotedblright. In that case |\thepagecolor| is % |white| and |\thepagecolornone| is |none|.\\ -% When |\nopagecolor| is unknown (e.\,g. \XeLaTeX ) or broken -% (\xpackage{crop} package) this package provides a replacement. +% When |\nopagecolor| is unknown or in case of the \xpackage{crop} package +% broken, this package provides a replacement.\\ % Similar to |\newgeometry| and |\restoregeometry| of the \xpackage{geometry} -% package\\ -% |\newpagecolor{<|\textit{some colour} |>}| and |\restorepagecolor| +% package |\newpagecolor{<|\textit{some color}|>}| and |\restorepagecolor| % are provided. % \end{abstract} % % \bigskip % % \noindent Disclaimer for web links: The author is not responsible for any contents -% referred to in this work unless he has full knowledge of illegal contents. -% If any damage occurs by the use of information presented there, only the -% author of the respective pages might be liable, not the one who has referred -% to these pages. -% -% \bigskip -% -% \noindent {\color{darkgreen} Save per page about $200\unit{ml}$ water, -% $2\unit{g}$ CO$_{2}$ and $2\unit{g}$ wood:\\ -% Therefore please print only if this is really necessary.} -% -% \newpage +% referred to in this work unless having full knowledge of illegal contents. +% If any damage occurs by the use of information presented there, +% only the author of the respective pages might be liable, +% not the one who has referred to these pages. % % \tableofcontents % % \bigskip % -% \section{Introduction\label{s:Introduction}} +% \section{Introduction} % \indent This \LaTeX{} package provides the command |\thepagecolor|, -% which gives the current page (background) colour, -% \hbox{i.\,e. the} argument used with the most recent call of |\pagecolor{...}|. -% The package should be loaded before any package sets a page (background) -% colour, but after \xpackage{xcolor} or \xpackage{color} package. -% Its option |pagecolor={...}| is used to set the initial |\pagecolor{...}|.\\ -% The command |\thepagecolornone| gives the same colour as |\thepagecolor|, -% except when the page background colour is +% which gives the current page (background) color, +% \hbox{i.\,e. the} argument used with the most recent call of |\pagecolor{...}|. +% (\verb|\pagecolor| needs to be defined before by the \xpackage{xcolor} or +% \xpackage{color} package.) The \xpackage{pagecolor} package should be loaded +% before any package sets a page (background) color, but obviously after +% the \xpackage{xcolor} or \xpackage{color} package. +% Its option |pagecolor={...}| is used to set the initial |\pagecolor{...}|. +% \newline +% The command |\thepagecolornone| gives the same color as |\thepagecolor|, +% except when the page background color is % \textquotedblleft|none|\textquotedblright (e.\,g. result of using the -% |\nopagecolor| command). In that case |\thepagecolor| is |white| and\linebreak +% |\nopagecolor| command). In that case |\thepagecolor| is |white| and % |\thepagecolornone| is |none|. -% When |\nopagecolor| is unknown (e.g. \XeLaTeX ) or broken -% (\xpackage{crop} package) this package provides a replacement -% depending on option |nopagecolor|. +% When |\nopagecolor| is unknown or in case of the \xpackage{crop} package +% broken, this package provides a replacement depending on option |nopagecolor|. % Similar to |\newgeometry| and |\restoregeometry| of the \xpackage{geometry} -% package -% |\newpagecolor{<|\textit{some colour}|>}| and |\restorepagecolor| +% package\linebreak +% |\newpagecolor{<|\textit{some color}|>}| and |\restorepagecolor| % are provided. % -% \newpage -% % \section{Usage} % % \indent Just load the package placing @@ -311,52 +270,53 @@ In memoriam % \noindent in the preamble of your \LaTeXe{} source file. % This should be done before another package uses |\pagecolor|. % Afterwards |\pagecolor{...}| can be used to change the page (background) -% colour as usual. Then |\thepagecolor| gives the current page (background) -% colour (in the same format as given with |\pagecolor{...}|).\\ +% color as usual. Then |\thepagecolor| gives the current page (background) +% color (in the same format as given with |\pagecolor{...}|).\\ % Similar to |\newgeometry| and |\restoregeometry| of the \xpackage{geometry} % package\\ -% |\newpagecolor{<|\textit{some colour} |>}| and |\restorepagecolor| +% |\newpagecolor{<|\textit{some color}|>}| and |\restorepagecolor| % are provided:\\ -% |\newpagecolor{<|\textit{some colour} |>}| will execute -% |\pagecolor{<|\textit{some colour} |>}| and remember the page colour used before. -% |\restorecolor| (without argument) restores the page colour to the one used before -% use of the |\newpagecolor{...}| command. When you want to change the colour for -% just one page and do not want to (or cannot) manually determine where the page ends,\\ -% |\newpagecolor{<|\textit{some colour}|>}\afterpage{\restorepagecolor}|\\ +% |\newpagecolor{<|\textit{some color}|>}| will execute +% |\pagecolor{<|\textit{some color}|>}| and remember the page color used before. +% |\restorecolor| (without argument) restores the page color to the one used before +% use of the |\newpagecolor{...}| command. When you want to change the color for +% just one page and do not want to (or cannot) manually determine where that page ends,\\ +% |\newpagecolor{<|\textit{some color}|>}\afterpage{\restorepagecolor}|\\ % does the trick (and requires a |\usepackage{afterpage}| in the document's % preamble), or for short\\ % |\newcommand{\onepagecolor}[1]{%|\\ % | \newpagecolor{#1}\afterpage{\restorepagecolor}}|\\ % in the preamble and\\ -% |\onepagecolor{<|\textit{some colour}|>}| in the document. +% |\onepagecolor{<|\textit{some color}|>}| in the document. +% +% \pagebreak % % \subsection{Options} % \DescribeMacro{options} % \indent The \xpackage{pagecolor} package takes the following options: % -% \subsubsection{pagecolor\label{sss:pagecolor}} +% \subsubsection{pagecolor} % \DescribeMacro{pagecolor} -% \indent The option |pagecolor={...}| takes as value a colour. This +% \indent The option |pagecolor={...}| takes as value a color. This % could be as simple as |black| or |white|, but when \hbox{e.\,g. the} % \xpackage{xcolor} package is used (loaded before \xpackage{pagecolor}!), -% also colours like |red!50!green!20!blue| are possible. +% also colors like |red!50!green!20!blue| are possible. % The default is |pagecolor={none}|. A |\pagecolor{...}| command with -% the given colour is used to initialise the pagecolour. +% the given color is used to initialise the pagecolor. % % -% \subsubsection{nopagecolor\label{sss:nopagecolor}} +% \subsubsection{nopagecolor} % \DescribeMacro{nopagecolor} -% \indent The option |nopagecolor={...}| takes as value a colour. This +% \indent The option |nopagecolor={...}| takes as value a color. This % could be as simple as |white| or |black|, but when \hbox{e.\,g. the} % \xpackage{xcolor} package is used (loaded before \xpackage{pagecolor}!), -% also colours like |red!50!green!20!blue| are possible. +% also colors like |red!50!green!20!blue| are possible. % The default is |nopagecolor={none}|. When |\nopagecolor| is unknown -% (e.\,g. \XeLaTeX ) or broken (\xpackage{crop} package) |\nopagecolor| -% is replaced by a |\pagecolor| command using the colour defined with the -% |nopagecolor| option. If |\nopagecolor| is not available and -% |nopagecolor| is |none|, it is used |white| instead of |none|. -% -% \newpage +% or broken \hbox{(e.\,g.} \xpackage{crop} package) +% |\nopagecolor| is replaced by a |\pagecolor| command +% using the color defined with the |nopagecolor| option. +% If |\nopagecolor| is not available and |nopagecolor| is |none|, +% it is used |white| instead of |none|. % % \section{Alternatives\label{s:Alternatives}} % @@ -369,10 +329,10 @@ In memoriam % (fully or partially) transparent, % \url{https://www.ctan.org/pkg/transparent}. % -% \item[-] \xpackage{hrefhide} package: It allows to -% \textquotedblleft hide\textquotedblright{} some (hyperlinked) text when +% \item[-] OCG (Optional Content Groups): It allows for example +% to \textquotedblleft hide\textquotedblright{} something when % printing the document while keeping the layout, -% \url{https://www.ctan.org/pkg/hrefhide}. +% \url{https://www.ctan.org/search?phrase=ocg}. % \end{description} % % \bigskip @@ -388,8 +348,8 @@ In memoriam % % \begin{macrocode} %<*example> -\documentclass[british]{article}[2014/09/29]% v1.4h -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\NeedsTeXFormat{LaTeX2e}[2021-11-15] +\documentclass[british]{article}[2021/10/04]% v1.4n \usepackage[% extension=pdf,% plainpages=false,% @@ -399,70 +359,57 @@ In memoriam pdftitle={pagecolor package example},% pdfauthor={H.-Martin Muench},% pdfsubject={Example for the pagecolor package},% - pdfkeywords={LaTeX, pagecolor, thepagecolor, page colour,% - H.-Martin Muench},% + pdfkeywords={LaTeX, pagecolor, thepagecolor, page color, page colour},% pdfview=Fit,pdfstartview=Fit,% pdfpagelayout=SinglePage% -]{hyperref}[2012/11/06]% v6.83m -\usepackage[x11names]{xcolor}[2007/01/21]% v2.11 - % The xcolor package would not be needed for just using - % the base colours. The color package would be sufficient for that. -\definecolor{darkgreen}{rgb}{0.0, 0.3, 0.0}% +]{hyperref}[2022-02-21]% v7.00n + +\usepackage[x11names]{xcolor}[2021/10/31]% v2.13 + % The xcolor package would not be needed for just using the base colors. + % The color package would be sufficient for that. + \usepackage[pagecolor={LightGoldenrod1},% - nopagecolor={none}]{pagecolor}[2017/05/29]% v1.0i + nopagecolor={none}]{pagecolor}[2022-11-20]% v1.1a \usepackage{afterpage}[2014/10/28]% v1.08 % The afterpage package is generally not needed, - % but the |\newpagecolor{somecolour}\afterpage{\restorepagecolor}| + % but the |\newpagecolor{somecolor}\afterpage{\restorepagecolor}| % construct shall be demonstrated. -\usepackage{lipsum}[2014/07/27]% v1.3 +\usepackage{lipsum}[2021-09-20]% v2.7 % The lipsum package is generally not needed, % but some blind text is needed for the example. -\usepackage{hologo}[2012/04/26]% v1.10 - % The hologo package is only needed to write - % \hologo{pdfTeX}, \hologo{LuaTeX}, and \hologo{XeTeX}. - -\gdef\unit#1{\mathord{\thinspace\mathrm{#1}}}% -\listfiles% +\listfiles \begin{document} \pagenumbering{arabic} \section*{Example for pagecolor} This example demonstrates the use of package\newline -\textsf{pagecolor}, v1.0i as of 2017/05/29 (HMM).\newline +\textsf{pagecolor}, v1.1a as of 2022-11-20 (HMM).\newline The used options were\newline -\verb|pagecolor={LightGoldenrod1}| (\verb|pagecolor={none}| -would be the default), and -\verb|pagecolor={none}| (which is the default).\newline - -\noindent For more details please see the documentation!\newline +\verb|pagecolor={LightGoldenrod1}|\newline +(\verb|pagecolor={none}| would be the default), and\newline +\verb|nopagecolor={none}| (which is the default). -\noindent {\color{darkgreen} Save per page about $200\unit{ml}$ water, -$2\unit{g}$ CO$_{2}$ and $2\unit{g}$ wood:\newline -Therefore please print only if this is really necessary.}\newline +\noindent For more details please see the documentation! -% \end{macrocode} -% \pagebreak -% \begin{macrocode} -\noindent The current page (background) colour is\newline +\noindent The current page (background) color is\newline \verb|\thepagecolor|\ =\ \thepagecolor \newline (and \verb|\thepagecolornone|\ =\ \thepagecolornone , which would only be different from \verb|\thepagecolor|, -when the page colour would be \verb|none|). +when the page color would be \verb|none|). \pagebreak \pagecolor{rgb:-green!40!yellow,3;green!40!yellow,2;red,1} -{\color{white} The current page (background) colour is\newline -\verb|\thepagecolor|\ =\ \thepagecolor . \newline} +{\color{white} The current page (background) color is\newline +\verb|\thepagecolor|\ =\ \thepagecolor .} -{\color{\thepagecolor} And that makes this text practically invisible. -\newline} +{\color{\thepagecolor} And that makes this text practically invisible.} {\color{white} Which made the preceding line of text practically -invisible.} +invisible, but it can be copied and pasted.} \pagebreak \newpagecolor{red} @@ -473,23 +420,23 @@ This page uses \verb|\newpagecolor{red}|. \restorepagecolor {\color{white}And this page uses \verb|\restorepagecolor| to restore -the page colour to the value it had before the red page.} +the page color to the value it had before the red page.} \pagebreak \pagecolor{none} This page uses \verb|\pagecolor{none}|. If the \verb|\nopagecolor| -command is known (\hologo{pdfTeX} and \hologo{LuaTeX}; not yet for -dvips, dvipdfm(x) or \hologo{XeTeX}), the page colour is now +command is known, the page color is now \verb|none| (because option \verb|nopagecolor={none}|), otherwise -\verb|white| (or the colour given with option \verb|nopagecolor={...}|): +\verb|white| (or the color given with option \verb|nopagecolor={...}|): +\newline \verb|\thepagecolor|\ =\ \thepagecolor\ and \verb|\thepagecolornone|\ =\ \thepagecolornone . \pagebreak \restorepagecolor -{\color{white}\verb|\restorepagecolor| restored the page colour again.} +{\color{white}\verb|\restorepagecolor| restored the page color again.} \pagebreak \pagecolor{green} @@ -502,14 +449,14 @@ This page is green due to \verb|\pagecolor{green}|. {\color{white}\verb|\newpagecolor{blue}\afterpage{\restorepagecolor}|% \newline was used here, i.\,e.~this page is blue, and the next one will -automatically have the same page colour before it was changed to blue +automatically have the same page color before it was changed to blue here (i.\,e. green).} \smallskip {\color{red}\textbf{\lipsum[1-11]}} \bigskip -The page colour was changed back at the end of the page - +The page color was changed back at the end of the page -- in mid-sentence! \end{document} @@ -530,8 +477,8 @@ in mid-sentence! % \end{macrocode} % % \begin{macrocode} -\NeedsTeXFormat{LaTeX2e}[2014/05/01] -\ProvidesPackage{pagecolor}[2017/05/29 v1.0i +\NeedsTeXFormat{LaTeX2e}[2021-11-15] +\ProvidesPackage{pagecolor}[2022-11-20 1.1a Provides thepagecolor (HMM)] % \end{macrocode} % @@ -539,68 +486,49 @@ in mid-sentence! % % \begin{macrocode} %% Provides the \thepagecolor, \thepagecolornone, \newpagecolor{...}, -%% and \restorepagecolor commands and the a replacement for the -%% \nopagecolor command, if it is not available. +%% and \restorepagecolor commands and a replacement for the +%% \nopagecolor command, if this is not available. % \end{macrocode} % -% We need the \xpackage{kvoptions} package by \textsc{Heiko Oberdiek}: -% -% \begin{macrocode} -\RequirePackage{kvoptions}[2011/06/30]% v3.11 -% \end{macrocode} -% -% and either the \xpackage{color} or the \xpackage{xcolor} package: +% We want to wrap the messages nicely: % % \begin{macrocode} -%% \RequirePackage{ either color or xcolor }: -\@ifpackageloaded{xcolor}{% xcolor loaded - \@ifpackagelater{xcolor}{2007/01/21}{% - % 2007/01/21, v2.11, or even more recent: OK - }{% else: older package version - \PackageWarning{pagecolor}{% - It is requested version `2007/01/21' of package\MessageBreak% - xcolor, but only an older version is available\MessageBreak% - }% - }% - }{% xcolor not loaded - \@ifpackageloaded{color}{% - \RequirePackage{color}[2014/10/28]% v1.1a - }{% \else - \PackageWarning{pagecolor}{% - The pagecolor package must be loaded after either\MessageBreak% - package color or after package xcolor (at your\MessageBreak% - option). Neither package was loaded before package\MessageBreak% - pagecolor. Loading of package xcolor will now be\MessageBreak% - tried automatically.\MessageBreak% - When the pagecolor package is used with option\MessageBreak% - pagecolor using a colour requiring e. g. x11names\MessageBreak% - option for xcolor package, this will not work!\MessageBreak% - } - }% \fi - \RequirePackage{xcolor}[2007/01/21]% v2.11 - }% \fi +\RequirePackage{hardwrap}[2011/02/12]% v0.2 +\GenerateLogMacros{package}{pagecolor} + % \end{macrocode} % -% as well as the \xpackage{ifpdf} and the \xpackage{ifluatex} package, -% because only \pdfTeX{} and \LuaTeX{} provide the |\nopagecolor| command: +% We need the \xpackage{kvoptions} package: % % \begin{macrocode} -\RequirePackage{ifpdf}[2011/01/30]% v2.3 -\RequirePackage{ifluatex}[2010/03/01]% v1.3 +\RequirePackage{kvoptions}[2020-10-07]% v3.14 % \end{macrocode} % -% A last information for the user: +% and either the \xpackage{color} or the \xpackage{xcolor} package: % % \begin{macrocode} -%% pagecolor may work with earlier versions of LaTeX and the -%% packages, but this was not tested. Please consider updating -%% your LaTeX and packages to the most recent version -%% (if they are not already the most recent version). +%% \RequirePackage{ either color or xcolor }: +\IfPackageLoadedTF{xcolor}{% xcolor loaded + \RequirePackage{xcolor}[2021/10/31]% v2.13 + }{% xcolor not loaded + \IfPackageLoadedTF{color}{% + \RequirePackage{color}[2021/12/07]% v1.3c + }{\pagecolor@warning@noline{% + The pagecolor package must be loaded after either % + package color or after package xcolor (at your % + option). Neither package was loaded before package % + pagecolor. Loading of package xcolor will now be % + tried automatically. \\% + When the pagecolor package is used with option % + pagecolor using a color requiring e.g. x11names % + option for xcolor package, this will not work!% + } + } + \RequirePackage{xcolor}[2021/10/31]% v2.13 + } % \end{macrocode} % -% \indent See subsection~\ref{ss:Downloads} about how to get them.\\ -% % We process the options: % % \begin{macrocode} @@ -611,56 +539,44 @@ in mid-sentence! % \end{macrocode} % \begin{macro}{\nopagecolor}\label{nopagecolor} -% \begin{macrocode} -%% \nopagecolor is only available for pdf(La)TeX and Lua(La)TeX -%% but not for dvips, dvipdfm(x), Xe(La)TeX,... -% \end{macrocode} % -% therefore |pagecolor| and/or |nopagecolor| can only be |none|, -% if either \pdfTeX{} or \LuaTeX{} is used; otherwise |white| is fine -% or another colour (other colours) requested by the user with the two options. +% \verb|\nopagecolor| is nowadays readily available. Let us test nevertheless: % % \begin{macrocode} -\def\pagecolourtmpa{0} -\ifluatex\def\pagecolourtmpa{1}\fi -\ifpdf\def\pagecolourtmpa{1}\fi -\def\pagecolourtmpb{1} -\ifx\pagecolourtmpa\pagecolourtmpb\relax% -\else% - \PackageInfo{pagecolor}{\string\nopagecolor\space is undefined}% - \def\pagecolourtmpb{none}% - \edef\pagecolourtmpa{\pagecolor@nopagecolor}% - \ifx\pagecolourtmpa\pagecolourtmpb% - \PackageWarning{pagecolor}{% - Option nopagecolor=none requested but \string\nopagecolor\space% - unknown:\MessageBreak% - By option nopagecolor the "colour" to be used with% - \string\nopagecolor\MessageBreak% - is set. The current value is "none" (maybe by default),% - \MessageBreak% - but command \string\nopagecolor\space is undefined.\MessageBreak% - Therefore the colour cannot be "none".\MessageBreak% - Please change the option accordingly!\MessageBreak% - As first aid nopagecolor is now set to white\MessageBreak% - }% - \setkeys{pagecolor}{nopagecolor=white}% - \fi% - \edef\pagecolourtmpa{\pagecolor@pagecolor}% - \ifx\pagecolourtmpa\pagecolourtmpb% - \PackageWarning{pagecolor}{% - Option pagecolor=none (maybe by default) used,\MessageBreak% - but \string\nopagecolor\space is unknown.\MessageBreak% - Please use anotheroption value;\MessageBreak% - \pagecolor@nopagecolor\space\MessageBreak% - will be used now\MessageBreak% - }% - \setkeys{pagecolor}{pagecolor={\pagecolor@nopagecolor}}% - \fi% - \@ifundefined{nopagecolor}{% - \newcommand{\nopagecolor}{\pagecolor{\pagecolor@nopagecolor}}% - }{\renewcommand{\nopagecolor}{\pagecolor{\pagecolor@nopagecolor}}% - }% -\fi% +\ifdefined\nopagecolor\relax +\else + \pagecolor@info@noline{\string\nopagecolor\ is undefined!} + \def\pagecolortmpb{none} + \edef\pagecolortmpa{\pagecolor@nopagecolor} + \ifx\pagecolortmpa\pagecolortmpb +% \end{macrocode} +% \pagebreak +% \begin{macrocode} + \pagecolor@warning@noline{% + Option nopagecolor=none requested but \string\nopagecolor\ % + unknown: \\% + By option nopagecolor the "color" to be used with % + \string\nopagecolor\ % + is set. The current value is "none" (maybe by default), % + but command \string\nopagecolor\ is undefined. % + Therefore the color cannot be "none". % + Please change the option accordingly! - % + As first aid nopagecolor is now set to white.% + } + \setkeys{pagecolor}{nopagecolor=white} + \fi + \edef\pagecolortmpa{\pagecolor@pagecolor} + \ifx\pagecolortmpa\pagecolortmpb\relax + \pagecolor@warning@noline{% + Option pagecolor=none (maybe by default) used, % + but \string\nopagecolor\ is unknown. % + Please use another option value; % + \pagecolor@nopagecolor\ will be used now.% + } + \setkeys{pagecolor}{pagecolor={\pagecolor@nopagecolor}} + \fi + \newcommand{\nopagecolor}{\pagecolor{\pagecolor@nopagecolor}} +\fi % \end{macrocode} @@ -668,43 +584,43 @@ in mid-sentence! % % \begin{macro}{\pagecolor} % -% \pagebreak % We save the original |\pagecolor| command, % % \begin{macrocode} -\let\origpagecolour\pagecolor +\let\origpagecolor\pagecolor % \end{macrocode} % % before we redefine it to include a definition of |\thepagecolor| -% and \linebreak +% and\linebreak % |\thepagecolornone|: % % \begin{macrocode} \renewcommand{\pagecolor}[1]{\@bsphack% - \edef\pagecolourtmpa{#1}% - \def\pagecolourtmpb{none}% - \ifx\pagecolourtmpa\pagecolourtmpb\relax% - \@ifundefined{nopagecolor}{% - \PackageWarning{pagecolor}{% - pagecolor=none requested but \string\nopagecolor\space% - unknown:\MessageBreak% - \string\pagecolor{none} was used, but the command\MessageBreak% - \string\nopagecolor\space is undefined.\MessageBreak% - Please use another colour.\MessageBreak% - pagecolor=\pagecolor@nopagecolor \MessageBreak% - will be used now\MessageBreak% + \edef\pagecolortmpa{#1}% + \def\pagecolortmpb{none}% + \ifx\pagecolortmpa\pagecolortmpb\relax% + \ifdefined\nopagecolor\relax% + \nopagecolor% + \else% + \pagecolor@warning{% + pagecolor=none requested but \string\nopagecolor\ % + unknown: \\% + \string\pagecolor{none} was used, but the command % + \string\nopagecolor\ is undefined. % + Please use another color. \\% + pagecolor=\pagecolor@nopagecolor\ \\% + will be used now.% }% \xdef\thepagecolor{\pagecolor@nopagecolor}% \xdef\thepagecolornone{\pagecolor@nopagecolor}% - % although it should be "none" - \origpagecolour{\pagecolor@nopagecolor}% - }{\nopagecolor% - }% + % although it should be "none" + \origpagecolor{\pagecolor@nopagecolor}% + \fi% \else% \xdef\thepagecolor{#1}% \xdef\thepagecolornone{#1}% - \origpagecolour{\thepagecolornone}% + \origpagecolor{\thepagecolornone}% \fi% \@esphack% } @@ -712,80 +628,67 @@ in mid-sentence! % \end{macrocode} % \end{macro} % -% |\nopagecolor| is only defined for \pdfTeX{} and \LuaTeX , but not for dvips, -% dvipdfm(x) or \XeTeX . (We defined a replacement, see page~\pageref{nopagecolor}.) -% But additionally |\nopagecolor| does not work if the \xpackage{crop} package is used. -% A workaround needs to be defined: +% |\nopagecolor| regularly is defined. If it was not, we already defined a replacement, +% see page~\pageref{nopagecolor}. But additionally |\nopagecolor| does not work +% if the \xpackage{crop} package is used. A workaround needs to be defined: % % \begin{macrocode} -\let\orignopagecolour\nopagecolor\relax% +\let\orignopagecolor\nopagecolor\relax -\gdef\pagecolor@cl{0}% -\@ifpackageloaded{crop}{% crop loaded - \gdef\pagecolor@cl{1}% - \@ifpackagelater{crop}{2003/05/21}{% - % later than 2003/05/20 v1.9 might be OK - \PackageWarning{pagecolor}{% - \string\nopagecolor\space did not work with package% - \MessageBreak% - crop 2003/05/20 v1.9. A newer version is used, \MessageBreak% - which the pagecolor package does not know how to handle.% - \MessageBreak% +\gdef\pagecolor@cl{0} +\IfPackageLoadedTF{crop}{% crop loaded + \gdef\pagecolor@cl{1} + \IfPackageAtLeastTF{crop}{2017/11/20}{ + % later than 2017/11/19 v1.10 might be OK + \pagecolor@warning@noline{% + \string\nopagecolor\ did not work with package \\% + crop 2017/11/19 v1.10. A newer version is used, % + which the pagecolor package does not know how to handle. % Please contact the maintainer of the pagecolor package!% - \MessageBreak% }% -% \end{macrocode} -% \pagebreak -% \begin{macrocode} % Let us just hope everything got fixed: \renewcommand{\nopagecolor}{% \xdef\thepagecolor{white}% \xdef\thepagecolornone{none}% - \orignopagecolour% + \orignopagecolor% % That will not have any effect except when things got fixed! }% }{% else: older package version - \PackageWarning{pagecolor}{% - \string\nopagecolor\space does not work with\MessageBreak% - the used crop package. Using\MessageBreak% - \pagecolor@nopagecolor\MessageBreak% - as nopagecolor now\MessageBreak% - }% - \def\pagecolourtmpb{none}% - \edef\pagecolourtmpa{\pagecolor@nopagecolor}% - \ifx\pagecolourtmpa\pagecolourtmpb% - \PackageWarning{pagecolor}{% - Option nopagecolor=none requested \MessageBreak% - but this does not work with the crop package.\MessageBreak% - By option nopagecolor the "colour" to be used with % - \string\nopagecolor\MessageBreak% - is set. The current value is "none" (maybe by default),% - \MessageBreak% - but the crop package broke \string\nopagecolor .% - \MessageBreak% - Therefore the colour cannot be "none".\MessageBreak% - Please change the option accordingly!\MessageBreak% - As first aid nopagecolor is now set to white\MessageBreak% - }% - \setkeys{pagecolor}{nopagecolor=white}% - \fi% - \renewcommand{\nopagecolor}{\pagecolor{\pagecolor@nopagecolor}}% - }% + \pagecolor@warning@noline{% + \string\nopagecolor\ does not work with % + the used crop package. Using \\% + \pagecolor@nopagecolor\ \\% + as nopagecolor now.% + } + \def\pagecolortmpb{none} + \edef\pagecolortmpa{\pagecolor@nopagecolor} + \ifx\pagecolortmpa\pagecolortmpb\relax + \pagecolor@warning@noline{% + Option nopagecolor=none requested % + but this does not work with the crop package. % + By option nopagecolor the "color" to be used with % + \string\nopagecolor\ % + is set. The current value is "none" (maybe by default), % + but the crop package broke \string\nopagecolor . % + Therefore the color cannot be "none". % + Please change the option accordingly! % + As first aid nopagecolor is now set to white.% + } + \setkeys{pagecolor}{nopagecolor=white} + \fi + \renewcommand{\nopagecolor}{\pagecolor{\pagecolor@nopagecolor}} + } }{% crop not loaded - \def\pagecolourtmpa{0}% - \ifluatex\def\pagecolourtmpa{1}\fi% - \ifpdf\def\pagecolourtmpa{1}\fi% - \def\pagecolourtmpb{1}% - \ifx\pagecolourtmpa\pagecolourtmpb\relax% - \gdef\pagecolourtmpa{none}% - \else% - \gdef\pagecolourtmpa{\pagecolor@nopagecolor}% - \fi% + \ifdefined\nopagecolor\relax + \gdef\pagecolortmpa{none} + \else + \gdef\pagecolortmpa{\pagecolor@nopagecolor} + \fi \renewcommand{\nopagecolor}{% \xdef\thepagecolor{white}% - \xdef\thepagecolornone{\pagecolourtmpa}% - \orignopagecolour% - }% + \xdef\thepagecolornone{\pagecolortmpa}% + \orignopagecolor% + } } @@ -798,110 +701,108 @@ in mid-sentence! % \end{macrocode} % -% \pagebreak -% Now the page (background) colour as well as |\thepagecolor| are\\ -% |\pagecolor@pagecolor|. |\thepagecolornone| is |none|, if that colour is known, +% Now the page (background) color as well as |\thepagecolor| are\\ +% |\pagecolor@pagecolor|. |\thepagecolornone| is |none|, if that color is known, % otherwise it is |\pagecolor@nopagecolor|, and if that was |none| (but that unknown), % it is |white|. If |\pagecolor@pagecolor| was |none|, -% the page (background) colour is |none|, when known, otherwise +% the page (background) color is |none|, when known, otherwise % |\pagecolor@nopagecolor|, and if that was |none| (but that unknown), % it is |white|, and |\thepagecolor| is |\pagecolor@nopagecolor|, % and if that was also |none| but |none| unknown, then it is |white|. -% When the page (background) colour is changed, |\thepagecolor| and +% When the page (background) color is changed, |\thepagecolor| and % |\thepagecolornone| are changed accordingly. % % \begin{macro}{\newpagecolor} -% There have been requests (via e-mail and at \\ -% \url{https://tex.stackexchange.com/q/25137/6865}) to change the colour of just one +% There have been requests (via e-mail and at +% \url{https://tex.stackexchange.com/q/25137/6865}) to change the color of just one % (or two) page(s) only, similar to |\newgeometry| and |\restoregeometry| of the -% \xpackage{geometry} package (\url{https://www.ctan.org/pkg/geometry}).\\ +% \xpackage{geometry} package (\url{https://www.ctan.org/pkg/geometry}). % Therefore |\newpagecolor| and |\restorepagecolor| are introduced (as suggested by % \textsc{haoyun\_tex}): % % \begin{macrocode} \newcommand{\newpagecolor}[1]{% -\xdef\pagecolourtmpc{\thepagecolornone}% +\xdef\pagecolortmpc{\thepagecolornone}% \pagecolor{#1}% } % \end{macrocode} % \end{macro} % -% |\newpagecolor{<|\textit{some colour}|>}| will execute |\pagecolor{somecolour}| -% and remember the page colour used before. +% |\newpagecolor{<|\textit{some color}|>}| will execute |\pagecolor{some color}| +% and remember the page color used before. % % \begin{macro}{\restorepagecolor} % \begin{macrocode} -\newcommand{\restorepagecolor}{\pagecolor{\pagecolourtmpc}} +\newcommand{\restorepagecolor}{\pagecolor{\pagecolortmpc}} % \end{macrocode} % \end{macro} % -% |\restorecolor| (without argument) restores the page colour to the one used before +% |\restorecolor| (without argument) restores the page color to the one used before % use of the |\newpagecolor{...}| command. % % \begin{macrocode} -\gdef\pagecolourtmpc{\thepagecolor} +\gdef\pagecolortmpc{\thepagecolor} % \end{macrocode} % is just a precaution for |\restorecolor| being used when no |\newpagecolor{...}| % was used before it.\\ % -% When you want to change the colour for just one page and do not want to +% When you want to change the color for just one page and do not want to % (or cannot) manually determine where the page ends,\\ -% |\newpagecolor{<|\textit{some colour}|>}\afterpage{\restorepagecolor}|\\ +% |\newpagecolor{<|\textit{some color}|>}\afterpage{\restorepagecolor}|\\ % does the trick (and requires an additional |\usepackage{afterpage}| in the % document's preamble).\\ % % We checked whether the \xpackage{crop} package had been loaded before % the \xpackage{pagecolor} package, but maybe it has been loaded afterwards. -% This is checked |\AtBeginDocument|: +% This is checked at the end of |\begin{document}|: % % \begin{macrocode} -\AtBeginDocument{% - \def\pagecolourtmpb{0}% - \ifx\pagecolor@cl\pagecolourtmpb\relax% +\AddToHook{begindocument/end}{% + \def\pagecolortmpb{0}% + \ifx\pagecolor@cl\pagecolortmpb\relax% % crop not loaded before pagecolor, but maybe afterwards: - \@ifpackageloaded{crop}{% crop indeed loaded afterwards. + \IfPackageLoadedTF{crop}{% crop indeed loaded afterwards. \gdef\pagecolor@cl{1}% - \@ifpackagelater{crop}{2003/05/21}{% - % later than 2003/05/20 v1.9 might be OK - \PackageWarning{pagecolor}{% - \string\nopagecolor\space did not work with package\MessageBreak% - crop 2003/05/20 v1.9. A newer version is used, \MessageBreak% - which the pagecolor package does not know how to handle.% - \MessageBreak% - Please contact the maintainer of the pagecolor package!% - \MessageBreak% - }% - % Let us just hope everything got fixed: - \renewcommand{\nopagecolor}{% - \xdef\thepagecolor{white}% - \xdef\thepagecolornone{none}% - \orignopagecolour% - % That will not have any effect except when things got fixed! - }% +% \end{macrocode} +% \pagebreak +% \begin{macrocode} + \IfPackageAtLeastTF{crop}{2017/11/20}{% + % later than 2017/11/19 v1.10 might be OK + \pagecolor@warning{% + \string\nopagecolor\ did not work with package \\% + crop 2017/11/19 v1.10. A newer version is used, % + which the pagecolor package does not know how to handle. % + Please contact the maintainer of the pagecolor package!% + }% + % Let us just hope everything got fixed: + \renewcommand{\nopagecolor}{% + \xdef\thepagecolor{white}% + \xdef\thepagecolornone{none}% + \orignopagecolor% + % That will not have any effect except when things got fixed! + }% }{% else: older package version - \PackageWarning{pagecolor}{% - \string\nopagecolor\space does not work with\MessageBreak% - the used crop package. Using\MessageBreak% - \pagecolor@nopagecolor\MessageBreak% - as nopagecolor now\MessageBreak% + \pagecolor@warning{pagecolor}{% + \string\nopagecolor\space does not work with % + the used crop package. Using \\% + \pagecolor@nopagecolor\ \\% + as nopagecolor now.% }% - \def\pagecolourtmpb{none}% - \edef\pagecolourtmpa{\pagecolor@nopagecolor}% - \ifx\pagecolourtmpa\pagecolourtmpb% - \PackageWarning{pagecolor}{% - Option nopagecolor=none requested \MessageBreak% - but this does not work with the crop package.\MessageBreak% - By option nopagecolor the "colour" to be used with % - \string\nopagecolor\MessageBreak% - is set. The current value is "none" (maybe by default),% - \MessageBreak% - but the crop package broke \string\nopagecolor .\MessageBreak% - Therefore the colour cannot be "none".\MessageBreak% - Please change the option accordingly!\MessageBreak% - As first aid nopagecolor is now set to white\MessageBreak% + \def\pagecolortmpb{none}% + \edef\pagecolortmpa{\pagecolor@nopagecolor}% + \ifx\pagecolortmpa\pagecolortmpb% + \pagecolor@warning{% + Option nopagecolor=none requested % + but this does not work with the crop package. % + By option nopagecolor the "color" to be used with % + \string\nopagecolor\ is set. The current value is "none" % + (maybe by default), but the crop package broke % + \string\nopagecolor . Therefore the color cannot be "none". % + Please change the option accordingly! \\% + As first aid nopagecolor is now set to white.% }% \setkeys{pagecolor}{nopagecolor=white}% \fi% @@ -912,6 +813,8 @@ in mid-sentence! \fi% } +% \end{macrocode} +% % \begin{macrocode} %</package> % \end{macrocode} @@ -919,9 +822,7 @@ in mid-sentence! % \newpage % % \section{Installation} -% -% \subsection{Downloads\label{ss:Downloads}} -% +% \subsection{Downloads} % Everything is available at \url{https://www.ctan.org}, % but may need additional packages themselves.\\ % @@ -929,12 +830,12 @@ in mid-sentence! % For unpacking the |pagecolor.dtx| file and constructing the documentation % it is required: % \begin{description} -% \item[-] \TeX Format \LaTeXe{}: \url{https://www.CTAN.org} +% \item[-] \TeX Format \LaTeXe{} 2021-11-15 or newer: \url{https://www.CTAN.org} % -% \item[-] document class \xclass{ltxdoc}, 2015/03/26, v2.0w, +% \item[-] document class \xclass{ltxdoc}, 2020/12/05, v2.1b, % \url{https://www.ctan.org/pkg/ltxdoc} % -% \item[-] package \xpackage{holtxdoc}, 2012/03/21, v0.24, +% \item[-] package \xpackage{holtxdoc}, 2019/12/09, v0.30, % \url{https://www.ctan.org/pkg/holtxdoc} % \end{description} % @@ -942,25 +843,22 @@ in mid-sentence! % The |pagecolor.sty| for \LaTeXe{} (i.\,e. each document using % the \xpackage{pagecolor} package) requires: % \begin{description} -% \item[-] \TeX{} Format \LaTeXe{}, \url{https://www.CTAN.org} +% \item[-] \TeX{} Format \LaTeXe{} 2021-11-15 or newer, \url{https://www.CTAN.org} % -% \item[-] package \xpackage{kvoptions}, 2011/06/30, v3.11, -% \url{https://www.ctan.org/pkg/kvoptions} +% \item[-] package \xpackage{hardwrap}, 2011/02/12, v0.2, +% \url{https://www.ctan.org/pkg/hardwrap} % -% \item[-] package \xpackage{ifpdf}, 2011/01/30, v2.3, -% \url{https://www.ctan.org/pkg/ifpdf} -% -% \item[-] package \xpackage{ifluatex}, 2010/03/01, v1.3, -% \url{https://www.ctan.org/pkg/ifluatex} +% \item[-] package \xpackage{kvoptions}, 2020-10-07, v3.14, +% \url{https://www.ctan.org/pkg/kvoptions} % \end{description} % and either % \begin{description} -% \item[-] package \xpackage{xcolor}, 2007/01/21, v2.11, +% \item[-] package \xpackage{xcolor}, 2021/10/31, v2.13, % \url{https://www.ctan.org/pkg/xcolor} % \end{description} % or % \begin{description} -% \item[-] package \xpackage{color}, 2014/10/28, v1.1a, +% \item[-] package \xpackage{color}, 2021/12/07, v1.3c, % \url{https://www.ctan.org/pkg/color} (from the\\ % \xpackage{graphics} package bundle). % \end{description} @@ -969,7 +867,7 @@ in mid-sentence! % The |pagecolor-example.tex| requires the same file as all % documents using the \xpackage{pagecolor} package, i.\,e. % \begin{description} -% \item[-] package \xpackage{pagecolor}, 2017/05/29, v1.0i, +% \item[-] package \xpackage{pagecolor}, 2022-11-20, v1.1a, % \url{https://www.ctan.org/pkg/pagecolor}\\ % (Well, it is the example file for this package, and because you are reading the % documentation for the \xpackage{pagecolor} package, it~can be assumed that you already @@ -977,57 +875,51 @@ in mid-sentence! % \end{description} % and additionally: % \begin{description} -% \item[-] class \xpackage{article}, 2014/09/29, v1.4h, from \xpackage{classes}:\\ +% \item[-] class \xpackage{article}, 2021/10/04, v1.4n, from \xpackage{classes}:\\ % \url{https://www.ctan.org/pkg/classes} % -% \item[-] package \xpackage{xcolor}, 2007/01/21, v2.11, +% \item[-] package \xpackage{xcolor}, 2021/10/31, v2.13, % \url{https://www.ctan.org/pkg/xcolor}\\ -% This package would not be needed for the use of just base colours only, +% This package would not be needed for the use of just base colors only, % the \xpackage{color} package would be sufficient for that. % % \item[-] package \xpackage{afterpage}, 2014/10/28, v1.08, % \url{https://www.ctan.org/pkg/afterpage}\\ % This package is only needed for demonstrating the\\ -% |\newpagecolor{somecolour}\afterpage{\restorepagecolor}| construct. +% |\newpagecolor{somecolor}\afterpage{\restorepagecolor}| construct. % -% \item[-] package \xpackage{lipsum}, 2014/07/27, v1.3, +% \item[-] package \xpackage{lipsum}, 2021-09-20, v2.7, % \url{https://www.ctan.org/pkg/lipsum}\\ % This package is only needed for some blind text. -% -% \item[-] package \xpackage{hologo}, 2012/04/26, v1.10, -% \url{https://www.ctan.org/pkg/hologo}\\ -% This package is only needed to write \hologo{pdfTeX}, \hologo{LuaTeX}, -% and \hologo{XeTeX}. % \end{description} % % \DescribeMacro{Alternatives} % \DescribeMacro{transparent} -% \DescribeMacro{hrefhide} +% \DescribeMacro{OCG} % As possible alternatives in section~\ref{s:Alternatives}, Alternatives, % there are listed (newer versions might be available): % \begin{description} -% \item[-] package \xpackage{transparent}, 2007/01/08, v1.0, \\ +% \item[-] package \xpackage{transparent}, 2022-10-27, v1.5,\\ % \url{https://www.ctan.org/pkg/transparent} % -% \item[-] package \xpackage{hrefhide}, 2011/04/29, v1.0h, \\ -% \url{https://www.ctan.org/pkg/hrefhide} +% \item[-] OCG (Optional Content Groups),\\ +% \url{https://www.ctan.org/search?phrase=ocg} % \end{description} % % \DescribeMacro{Oberdiek} -% \DescribeMacro{hologo} % \DescribeMacro{holtxdoc} % \DescribeMacro{kvoptions} -% All packages of \textsc{Heiko Oberdiek's} bundle `oberdiek' -% (especially \xpackage{hologo}, \xpackage{holtxdoc}, and \xpackage{kvoptions}) +% All packages of the `oberdiek' bundle +% (especially \xpackage{holtxdoc} and \xpackage{kvoptions}) % are also available in a TDS compliant ZIP archive:\\ -% \url{http://mirror.ctan.org/install/macros/latex/contrib/oberdiek.tds.zip}.\\ +% \url{https://mirror.ctan.org/install/macros/latex/contrib/oberdiek.tds.zip}.\\ % It is probably best to download and use this, because the packages in there % are quite probably both recent and compatible among themselves.\\ % % \DescribeMacro{hyperref} % \noindent \xpackage{hyperref} is not included in that bundle and needs to be % downloaded separately,\\ -% \url{http://mirror.ctan.org/install/macros/latex/contrib/hyperref.tds.zip}.\\ +% \url{https://mirror.ctan.org/install/macros/latex/contrib/hyperref.tds.zip}.\\ % % \DescribeMacro{M\"{u}nch} % A hyperlinked list of my (other) packages can be found at @@ -1036,19 +928,19 @@ in mid-sentence! % \subsection{Package, unpacking TDS} % \paragraph{Package.} This package is available on \url{https://www.CTAN.org}. % \begin{description} -% \item[\url{http://mirror.ctan.org/macros/latex/contrib/pagecolor/pagecolor.dtx}]\hspace*{0.1cm} +% \item[\url{https://mirror.ctan.org/macros/latex/contrib/pagecolor/pagecolor.dtx}]\hspace*{0.1cm} % The source file. -% \item[\url{http://mirror.ctan.org/macros/latex/contrib/pagecolor/pagecolor.pdf}]\hspace*{0.1cm} +% \item[\url{https://mirror.ctan.org/macros/latex/contrib/pagecolor/pagecolor.pdf}]\hspace*{0.1cm} % The documentation. -% \item[\url{http://mirror.ctan.org/macros/latex/contrib/pagecolor/pagecolor-example.pdf}]\hspace*{0.1cm} +% \item[\url{https://mirror.ctan.org/macros/latex/contrib/pagecolor/pagecolor-example.pdf}]\hspace*{0.1cm} % The compiled example file, as it should look like. -% \item[\url{http://mirror.ctan.org/macros/latex/contrib/pagecolor/README}]\hspace*{0.1cm}\\ +% \item[\url{https://mirror.ctan.org/macros/latex/contrib/pagecolor/README}]\hspace*{0.1cm}\\ % \hspace*{1em}The README file. % \end{description} % % There is also a |pagecolor.tds.zip| available: % \begin{description} -% \item[\url{http://mirror.ctan.org/install/macros/latex/contrib/pagecolor.tds.zip}]\hspace*{0.1cm} +% \item[\url{https://mirror.ctan.org/install/macros/latex/contrib/pagecolor.tds.zip}]\hspace*{0.1cm} % Everything in TDS compliant, compiled format. % \end{description} % which additionally contains\\ @@ -1200,13 +1092,13 @@ in mid-sentence! % % \section{Acknowledgements} % -% I would like to thank \textsc{Heiko Oberdiek} for providing a~lot~(!) of +% I would like to thank \textsc{Heiko Oberdiek} for providing a lot of % useful packages (from which I also got everything I know about creating % a file in \xext{dtx} format, ok, say it: copying), and the % \Newsgroup{comp.text.tex} and \Newsgroup{de.comp.text.tex} newsgroups % for their help in all things \TeX{}, especially all contributors to the % discussion at -% \url{https://groups.google.com/forum/#!topic/comp.text.tex/UzV26-RNYPY}% +% \url{https://groups.google.com/g/comp.text.tex/c/UzV26-RNYPY}% % \ (\textsc{H.~Oberdiek} \& \textsc{Gouailles}).\\ % I thank \textsc{haoyun\_tex} for suggesting the |\newpagecolor|/|\restorepagecolor| % pair of commands and everyone at \url{https://tex.stackexchange.com/q/25137/6865} @@ -1215,7 +1107,7 @@ in mid-sentence! % and to \textsc{Reuben Thomas} for suggestions for improvements % of this documentation. % -% \bigskip +% \pagebreak % % \phantomsection % \begin{History}\label{History} @@ -1255,10 +1147,24 @@ in mid-sentence! % but some of the related code must already be performed earlier. % Bug found by \textsc{Heiner Richter} and reported by % \textsc{Johannes B\"{o}ttcher}, thanks! +% \item This version has been archived at\\ +% \url{https://web.archive.org/web/20161114093809/https://mirror.ctan.org/install/macros/latex/contrib/pagecolor.tds.zip} % \end{Version} % \begin{Version}{2017/05/29 v1.0i} % \item Documentation update following suggestions for improvements by % \textsc{Reuben Thomas}, thanks! +% \item This version has been archived at\\ +% \url{https://web.archive.org/web/20220120221237/https://mirror.ctan.org/install/macros/latex/contrib/pagecolor.tds.zip} +% \end{Version} +% \begin{Version}{2022-11-20 v1.1a} +% \item Conversion to UTF-8. +% \item Update to \LaTeX{} format 2021-11-15. +% \item Corrected an error in the example. +% \item \XeLaTeX{} and others now do know \verb|\nopagecolor|. +% \item Package \xpackage{crop} has been updated, but \verb|\nopagecolor| +% still applies to the physical background sheet instead of the logical foreground area. +% \item Now using the \xpackage{hardwrap} package. +% \item Documentation updates. % \end{Version} % \end{History} % @@ -1267,8 +1173,6 @@ in mid-sentence! % When you find a mistake or have a suggestion for an improvement of this package, % please send an e-mail to the maintainer, thanks! (Please see BUG REPORTS in the README.) % -% \newpage -% % \PrintIndex % % \Finale diff --git a/Master/texmf-dist/source/latex/pagecolor/pagecolor.ins b/Master/texmf-dist/source/latex/pagecolor/pagecolor.ins index a0095e5535e..867923602f3 100644 --- a/Master/texmf-dist/source/latex/pagecolor/pagecolor.ins +++ b/Master/texmf-dist/source/latex/pagecolor/pagecolor.ins @@ -9,13 +9,13 @@ %% This is a generated file. %% %% Project: pagecolor -%% Version: 2017/05/29 v1.0i +%% Version: 2022-11-20 v1.1a %% -%% Copyright (C) 2011 - 2017 by -%% H.-Martin M"unch <Martin dot Muench at Uni-Bonn dot de> +%% Copyright (C) 2011 - 2022 by +%% H.-Martin Muench <Martin dot Muench at Uni-Bonn dot de> %% %% The usual disclaimer applies: -%% If it doesn't work right that's your problem. +%% If it does not work right that is your problem. %% (Nevertheless, send an e-mail to the maintainer %% when you find an error in this package.) %% @@ -23,11 +23,11 @@ %% conditions of the LaTeX Project Public License, either %% version 1.3c of this license or (at your option) any later %% version. This version of this license is in -%% http://www.latex-project.org/lppl/lppl-1-3c.txt +%% https://www.latex-project.org/lppl/lppl-1-3c.txt %% and the latest version of this license is in -%% http://www.latex-project.org/lppl.txt +%% https://www.latex-project.org/lppl.txt %% and version 1.3c or later is part of all distributions of -%% LaTeX version 2005/12/01 or later. +%% LaTeX version 2005-12-01 or later. %% %% This work has the LPPL maintenance status "maintained". %% @@ -40,14 +40,14 @@ %% pagecolor-example.tex, pagecolor-example.pdf. %% %% In memoriam -%% Claudia Simone Barth + 1996/01/30 -%% Tommy Muench + 2014/01/02 -%% Hans-Klaus Muench + 2014/08/24 +%% Claudia Simone Barth + 1996-01-30 +%% Tommy Muench + 2014-01-02 +%% Hans-Klaus Muench + 2014-08-24 %% \input docstrip.tex \Msg{******************************************************************} \Msg{* Installation *} -\Msg{* Package: pagecolor 2017/05/29 v1.0i Provides thepagecolor (HMM)*} +\Msg{* Package: pagecolor 2022-11-20 v1.1a Provides thepagecolor (HMM)*} \Msg{******************************************************************} \keepsilent @@ -59,13 +59,13 @@ This is a generated file. Project: pagecolor -Version: 2017/05/29 v1.0i +Version: 2022-11-20 v1.1a -Copyright (C) 2011 - 2017 by - H.-Martin M"unch <Martin dot Muench at Uni-Bonn dot de> +Copyright (C) 2011 - 2022 by + H.-Martin Muench <Martin dot Muench at Uni-Bonn dot de> The usual disclaimer applies: -If it doesn't work right that's your problem. +If it does not work right that is your problem. (Nevertheless, send an e-mail to the maintainer when you find an error in this package.) @@ -73,11 +73,11 @@ This work may be distributed and/or modified under the conditions of the LaTeX Project Public License, either version 1.3c of this license or (at your option) any later version. This version of this license is in - http://www.latex-project.org/lppl/lppl-1-3c.txt + https://www.latex-project.org/lppl/lppl-1-3c.txt and the latest version of this license is in - http://www.latex-project.org/lppl.txt + https://www.latex-project.org/lppl.txt and version 1.3c or later is part of all distributions of -LaTeX version 2005/12/01 or later. +LaTeX version 2005-12-01 or later. This work has the LPPL maintenance status "maintained". @@ -90,9 +90,9 @@ the README, and the derived files pagecolor-example.tex, pagecolor-example.pdf. In memoriam - Claudia Simone Barth + 1996/01/30 - Tommy Muench + 2014/01/02 - Hans-Klaus Muench + 2014/08/24 + Claudia Simone Barth + 1996-01-30 + Tommy Muench + 2014-01-02 + Hans-Klaus Muench + 2014-08-24 \endpreamble \let\MetaPrefix\DoubleperCent diff --git a/Master/texmf-dist/tex/latex/pagecolor/pagecolor.sty b/Master/texmf-dist/tex/latex/pagecolor/pagecolor.sty index 912187a91bc..8d5330de8e9 100644 --- a/Master/texmf-dist/tex/latex/pagecolor/pagecolor.sty +++ b/Master/texmf-dist/tex/latex/pagecolor/pagecolor.sty @@ -9,13 +9,13 @@ %% This is a generated file. %% %% Project: pagecolor -%% Version: 2017/05/29 v1.0i +%% Version: 2022-11-20 v1.1a %% -%% Copyright (C) 2011 - 2017 by -%% H.-Martin M"unch <Martin dot Muench at Uni-Bonn dot de> +%% Copyright (C) 2011 - 2022 by +%% H.-Martin Muench <Martin dot Muench at Uni-Bonn dot de> %% %% The usual disclaimer applies: -%% If it doesn't work right that's your problem. +%% If it does not work right that is your problem. %% (Nevertheless, send an e-mail to the maintainer %% when you find an error in this package.) %% @@ -23,11 +23,11 @@ %% conditions of the LaTeX Project Public License, either %% version 1.3c of this license or (at your option) any later %% version. This version of this license is in -%% http://www.latex-project.org/lppl/lppl-1-3c.txt +%% https://www.latex-project.org/lppl/lppl-1-3c.txt %% and the latest version of this license is in -%% http://www.latex-project.org/lppl.txt +%% https://www.latex-project.org/lppl.txt %% and version 1.3c or later is part of all distributions of -%% LaTeX version 2005/12/01 or later. +%% LaTeX version 2005-12-01 or later. %% %% This work has the LPPL maintenance status "maintained". %% @@ -40,251 +40,217 @@ %% pagecolor-example.tex, pagecolor-example.pdf. %% %% In memoriam -%% Claudia Simone Barth + 1996/01/30 -%% Tommy Muench + 2014/01/02 -%% Hans-Klaus Muench + 2014/08/24 +%% Claudia Simone Barth + 1996-01-30 +%% Tommy Muench + 2014-01-02 +%% Hans-Klaus Muench + 2014-08-24 %% -\NeedsTeXFormat{LaTeX2e}[2014/05/01] -\ProvidesPackage{pagecolor}[2017/05/29 v1.0i +\NeedsTeXFormat{LaTeX2e}[2021-11-15] +\ProvidesPackage{pagecolor}[2022-11-20 1.1a Provides thepagecolor (HMM)] %% Provides the \thepagecolor, \thepagecolornone, \newpagecolor{...}, -%% and \restorepagecolor commands and the a replacement for the -%% \nopagecolor command, if it is not available. -\RequirePackage{kvoptions}[2011/06/30]% v3.11 +%% and \restorepagecolor commands and a replacement for the +%% \nopagecolor command, if this is not available. +\RequirePackage{hardwrap}[2011/02/12]% v0.2 +\GenerateLogMacros{package}{pagecolor} + +\RequirePackage{kvoptions}[2020-10-07]% v3.14 %% \RequirePackage{ either color or xcolor }: -\@ifpackageloaded{xcolor}{% xcolor loaded - \@ifpackagelater{xcolor}{2007/01/21}{% - % 2007/01/21, v2.11, or even more recent: OK - }{% else: older package version - \PackageWarning{pagecolor}{% - It is requested version `2007/01/21' of package\MessageBreak% - xcolor, but only an older version is available\MessageBreak% - }% - }% +\IfPackageLoadedTF{xcolor}{% xcolor loaded + \RequirePackage{xcolor}[2021/10/31]% v2.13 }{% xcolor not loaded - \@ifpackageloaded{color}{% - \RequirePackage{color}[2014/10/28]% v1.1a - }{% \else - \PackageWarning{pagecolor}{% - The pagecolor package must be loaded after either\MessageBreak% - package color or after package xcolor (at your\MessageBreak% - option). Neither package was loaded before package\MessageBreak% - pagecolor. Loading of package xcolor will now be\MessageBreak% - tried automatically.\MessageBreak% - When the pagecolor package is used with option\MessageBreak% - pagecolor using a colour requiring e. g. x11names\MessageBreak% - option for xcolor package, this will not work!\MessageBreak% + \IfPackageLoadedTF{color}{% + \RequirePackage{color}[2021/12/07]% v1.3c + }{\pagecolor@warning@noline{% + The pagecolor package must be loaded after either % + package color or after package xcolor (at your % + option). Neither package was loaded before package % + pagecolor. Loading of package xcolor will now be % + tried automatically. \\% + When the pagecolor package is used with option % + pagecolor using a color requiring e.g. x11names % + option for xcolor package, this will not work!% } - }% \fi - \RequirePackage{xcolor}[2007/01/21]% v2.11 - }% \fi -\RequirePackage{ifpdf}[2011/01/30]% v2.3 -\RequirePackage{ifluatex}[2010/03/01]% v1.3 -%% pagecolor may work with earlier versions of LaTeX and the -%% packages, but this was not tested. Please consider updating -%% your LaTeX and packages to the most recent version -%% (if they are not already the most recent version). + } + \RequirePackage{xcolor}[2021/10/31]% v2.13 + } \SetupKeyvalOptions{family=pagecolor,prefix=pagecolor@} \DeclareStringOption[none]{pagecolor}% \pagecolor@pagecolor \DeclareStringOption[none]{nopagecolor}% \pagecolor@nopagecolor \ProcessKeyvalOptions* -%% \nopagecolor is only available for pdf(La)TeX and Lua(La)TeX -%% but not for dvips, dvipdfm(x), Xe(La)TeX,... -\def\pagecolourtmpa{0} -\ifluatex\def\pagecolourtmpa{1}\fi -\ifpdf\def\pagecolourtmpa{1}\fi -\def\pagecolourtmpb{1} -\ifx\pagecolourtmpa\pagecolourtmpb\relax% -\else% - \PackageInfo{pagecolor}{\string\nopagecolor\space is undefined}% - \def\pagecolourtmpb{none}% - \edef\pagecolourtmpa{\pagecolor@nopagecolor}% - \ifx\pagecolourtmpa\pagecolourtmpb% - \PackageWarning{pagecolor}{% - Option nopagecolor=none requested but \string\nopagecolor\space% - unknown:\MessageBreak% - By option nopagecolor the "colour" to be used with% - \string\nopagecolor\MessageBreak% - is set. The current value is "none" (maybe by default),% - \MessageBreak% - but command \string\nopagecolor\space is undefined.\MessageBreak% - Therefore the colour cannot be "none".\MessageBreak% - Please change the option accordingly!\MessageBreak% - As first aid nopagecolor is now set to white\MessageBreak% - }% - \setkeys{pagecolor}{nopagecolor=white}% - \fi% - \edef\pagecolourtmpa{\pagecolor@pagecolor}% - \ifx\pagecolourtmpa\pagecolourtmpb% - \PackageWarning{pagecolor}{% - Option pagecolor=none (maybe by default) used,\MessageBreak% - but \string\nopagecolor\space is unknown.\MessageBreak% - Please use anotheroption value;\MessageBreak% - \pagecolor@nopagecolor\space\MessageBreak% - will be used now\MessageBreak% - }% - \setkeys{pagecolor}{pagecolor={\pagecolor@nopagecolor}}% - \fi% - \@ifundefined{nopagecolor}{% - \newcommand{\nopagecolor}{\pagecolor{\pagecolor@nopagecolor}}% - }{\renewcommand{\nopagecolor}{\pagecolor{\pagecolor@nopagecolor}}% - }% -\fi% +\ifdefined\nopagecolor\relax +\else + \pagecolor@info@noline{\string\nopagecolor\ is undefined!} + \def\pagecolortmpb{none} + \edef\pagecolortmpa{\pagecolor@nopagecolor} + \ifx\pagecolortmpa\pagecolortmpb + \pagecolor@warning@noline{% + Option nopagecolor=none requested but \string\nopagecolor\ % + unknown: \\% + By option nopagecolor the "color" to be used with % + \string\nopagecolor\ % + is set. The current value is "none" (maybe by default), % + but command \string\nopagecolor\ is undefined. % + Therefore the color cannot be "none". % + Please change the option accordingly! - % + As first aid nopagecolor is now set to white.% + } + \setkeys{pagecolor}{nopagecolor=white} + \fi + \edef\pagecolortmpa{\pagecolor@pagecolor} + \ifx\pagecolortmpa\pagecolortmpb\relax + \pagecolor@warning@noline{% + Option pagecolor=none (maybe by default) used, % + but \string\nopagecolor\ is unknown. % + Please use another option value; % + \pagecolor@nopagecolor\ will be used now.% + } + \setkeys{pagecolor}{pagecolor={\pagecolor@nopagecolor}} + \fi + \newcommand{\nopagecolor}{\pagecolor{\pagecolor@nopagecolor}} +\fi -\let\origpagecolour\pagecolor +\let\origpagecolor\pagecolor \renewcommand{\pagecolor}[1]{\@bsphack% - \edef\pagecolourtmpa{#1}% - \def\pagecolourtmpb{none}% - \ifx\pagecolourtmpa\pagecolourtmpb\relax% - \@ifundefined{nopagecolor}{% - \PackageWarning{pagecolor}{% - pagecolor=none requested but \string\nopagecolor\space% - unknown:\MessageBreak% - \string\pagecolor{none} was used, but the command\MessageBreak% - \string\nopagecolor\space is undefined.\MessageBreak% - Please use another colour.\MessageBreak% - pagecolor=\pagecolor@nopagecolor \MessageBreak% - will be used now\MessageBreak% + \edef\pagecolortmpa{#1}% + \def\pagecolortmpb{none}% + \ifx\pagecolortmpa\pagecolortmpb\relax% + \ifdefined\nopagecolor\relax% + \nopagecolor% + \else% + \pagecolor@warning{% + pagecolor=none requested but \string\nopagecolor\ % + unknown: \\% + \string\pagecolor{none} was used, but the command % + \string\nopagecolor\ is undefined. % + Please use another color. \\% + pagecolor=\pagecolor@nopagecolor\ \\% + will be used now.% }% \xdef\thepagecolor{\pagecolor@nopagecolor}% \xdef\thepagecolornone{\pagecolor@nopagecolor}% - % although it should be "none" - \origpagecolour{\pagecolor@nopagecolor}% - }{\nopagecolor% - }% + % although it should be "none" + \origpagecolor{\pagecolor@nopagecolor}% + \fi% \else% \xdef\thepagecolor{#1}% \xdef\thepagecolornone{#1}% - \origpagecolour{\thepagecolornone}% + \origpagecolor{\thepagecolornone}% \fi% \@esphack% } -\let\orignopagecolour\nopagecolor\relax% +\let\orignopagecolor\nopagecolor\relax -\gdef\pagecolor@cl{0}% -\@ifpackageloaded{crop}{% crop loaded - \gdef\pagecolor@cl{1}% - \@ifpackagelater{crop}{2003/05/21}{% - % later than 2003/05/20 v1.9 might be OK - \PackageWarning{pagecolor}{% - \string\nopagecolor\space did not work with package% - \MessageBreak% - crop 2003/05/20 v1.9. A newer version is used, \MessageBreak% - which the pagecolor package does not know how to handle.% - \MessageBreak% +\gdef\pagecolor@cl{0} +\IfPackageLoadedTF{crop}{% crop loaded + \gdef\pagecolor@cl{1} + \IfPackageAtLeastTF{crop}{2017/11/20}{ + % later than 2017/11/19 v1.10 might be OK + \pagecolor@warning@noline{% + \string\nopagecolor\ did not work with package \\% + crop 2017/11/19 v1.10. A newer version is used, % + which the pagecolor package does not know how to handle. % Please contact the maintainer of the pagecolor package!% - \MessageBreak% }% % Let us just hope everything got fixed: \renewcommand{\nopagecolor}{% \xdef\thepagecolor{white}% \xdef\thepagecolornone{none}% - \orignopagecolour% + \orignopagecolor% % That will not have any effect except when things got fixed! }% }{% else: older package version - \PackageWarning{pagecolor}{% - \string\nopagecolor\space does not work with\MessageBreak% - the used crop package. Using\MessageBreak% - \pagecolor@nopagecolor\MessageBreak% - as nopagecolor now\MessageBreak% - }% - \def\pagecolourtmpb{none}% - \edef\pagecolourtmpa{\pagecolor@nopagecolor}% - \ifx\pagecolourtmpa\pagecolourtmpb% - \PackageWarning{pagecolor}{% - Option nopagecolor=none requested \MessageBreak% - but this does not work with the crop package.\MessageBreak% - By option nopagecolor the "colour" to be used with % - \string\nopagecolor\MessageBreak% - is set. The current value is "none" (maybe by default),% - \MessageBreak% - but the crop package broke \string\nopagecolor .% - \MessageBreak% - Therefore the colour cannot be "none".\MessageBreak% - Please change the option accordingly!\MessageBreak% - As first aid nopagecolor is now set to white\MessageBreak% - }% - \setkeys{pagecolor}{nopagecolor=white}% - \fi% - \renewcommand{\nopagecolor}{\pagecolor{\pagecolor@nopagecolor}}% - }% + \pagecolor@warning@noline{% + \string\nopagecolor\ does not work with % + the used crop package. Using \\% + \pagecolor@nopagecolor\ \\% + as nopagecolor now.% + } + \def\pagecolortmpb{none} + \edef\pagecolortmpa{\pagecolor@nopagecolor} + \ifx\pagecolortmpa\pagecolortmpb\relax + \pagecolor@warning@noline{% + Option nopagecolor=none requested % + but this does not work with the crop package. % + By option nopagecolor the "color" to be used with % + \string\nopagecolor\ % + is set. The current value is "none" (maybe by default), % + but the crop package broke \string\nopagecolor . % + Therefore the color cannot be "none". % + Please change the option accordingly! % + As first aid nopagecolor is now set to white.% + } + \setkeys{pagecolor}{nopagecolor=white} + \fi + \renewcommand{\nopagecolor}{\pagecolor{\pagecolor@nopagecolor}} + } }{% crop not loaded - \def\pagecolourtmpa{0}% - \ifluatex\def\pagecolourtmpa{1}\fi% - \ifpdf\def\pagecolourtmpa{1}\fi% - \def\pagecolourtmpb{1}% - \ifx\pagecolourtmpa\pagecolourtmpb\relax% - \gdef\pagecolourtmpa{none}% - \else% - \gdef\pagecolourtmpa{\pagecolor@nopagecolor}% - \fi% + \ifdefined\nopagecolor\relax + \gdef\pagecolortmpa{none} + \else + \gdef\pagecolortmpa{\pagecolor@nopagecolor} + \fi \renewcommand{\nopagecolor}{% \xdef\thepagecolor{white}% - \xdef\thepagecolornone{\pagecolourtmpa}% - \orignopagecolour% - }% + \xdef\thepagecolornone{\pagecolortmpa}% + \orignopagecolor% + } } \pagecolor{\pagecolor@pagecolor} \newcommand{\newpagecolor}[1]{% -\xdef\pagecolourtmpc{\thepagecolornone}% +\xdef\pagecolortmpc{\thepagecolornone}% \pagecolor{#1}% } -\newcommand{\restorepagecolor}{\pagecolor{\pagecolourtmpc}} +\newcommand{\restorepagecolor}{\pagecolor{\pagecolortmpc}} -\gdef\pagecolourtmpc{\thepagecolor} +\gdef\pagecolortmpc{\thepagecolor} -\AtBeginDocument{% - \def\pagecolourtmpb{0}% - \ifx\pagecolor@cl\pagecolourtmpb\relax% +\AddToHook{begindocument/end}{% + \def\pagecolortmpb{0}% + \ifx\pagecolor@cl\pagecolortmpb\relax% % crop not loaded before pagecolor, but maybe afterwards: - \@ifpackageloaded{crop}{% crop indeed loaded afterwards. + \IfPackageLoadedTF{crop}{% crop indeed loaded afterwards. \gdef\pagecolor@cl{1}% - \@ifpackagelater{crop}{2003/05/21}{% - % later than 2003/05/20 v1.9 might be OK - \PackageWarning{pagecolor}{% - \string\nopagecolor\space did not work with package\MessageBreak% - crop 2003/05/20 v1.9. A newer version is used, \MessageBreak% - which the pagecolor package does not know how to handle.% - \MessageBreak% - Please contact the maintainer of the pagecolor package!% - \MessageBreak% - }% - % Let us just hope everything got fixed: - \renewcommand{\nopagecolor}{% - \xdef\thepagecolor{white}% - \xdef\thepagecolornone{none}% - \orignopagecolour% - % That will not have any effect except when things got fixed! - }% + \IfPackageAtLeastTF{crop}{2017/11/20}{% + % later than 2017/11/19 v1.10 might be OK + \pagecolor@warning{% + \string\nopagecolor\ did not work with package \\% + crop 2017/11/19 v1.10. A newer version is used, % + which the pagecolor package does not know how to handle. % + Please contact the maintainer of the pagecolor package!% + }% + % Let us just hope everything got fixed: + \renewcommand{\nopagecolor}{% + \xdef\thepagecolor{white}% + \xdef\thepagecolornone{none}% + \orignopagecolor% + % That will not have any effect except when things got fixed! + }% }{% else: older package version - \PackageWarning{pagecolor}{% - \string\nopagecolor\space does not work with\MessageBreak% - the used crop package. Using\MessageBreak% - \pagecolor@nopagecolor\MessageBreak% - as nopagecolor now\MessageBreak% + \pagecolor@warning{pagecolor}{% + \string\nopagecolor\space does not work with % + the used crop package. Using \\% + \pagecolor@nopagecolor\ \\% + as nopagecolor now.% }% - \def\pagecolourtmpb{none}% - \edef\pagecolourtmpa{\pagecolor@nopagecolor}% - \ifx\pagecolourtmpa\pagecolourtmpb% - \PackageWarning{pagecolor}{% - Option nopagecolor=none requested \MessageBreak% - but this does not work with the crop package.\MessageBreak% - By option nopagecolor the "colour" to be used with % - \string\nopagecolor\MessageBreak% - is set. The current value is "none" (maybe by default),% - \MessageBreak% - but the crop package broke \string\nopagecolor .\MessageBreak% - Therefore the colour cannot be "none".\MessageBreak% - Please change the option accordingly!\MessageBreak% - As first aid nopagecolor is now set to white\MessageBreak% + \def\pagecolortmpb{none}% + \edef\pagecolortmpa{\pagecolor@nopagecolor}% + \ifx\pagecolortmpa\pagecolortmpb% + \pagecolor@warning{% + Option nopagecolor=none requested % + but this does not work with the crop package. % + By option nopagecolor the "color" to be used with % + \string\nopagecolor\ is set. The current value is "none" % + (maybe by default), but the crop package broke % + \string\nopagecolor . Therefore the color cannot be "none". % + Please change the option accordingly! \\% + As first aid nopagecolor is now set to white.% }% \setkeys{pagecolor}{nopagecolor=white}% \fi% |