summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/pagecolor
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2022-11-21 03:04:15 +0000
committerNorbert Preining <norbert@preining.info>2022-11-21 03:04:15 +0000
commitcf9efbbd09ec0218821a622f2ff7dc2ce0ad5645 (patch)
tree6da67db1fcedb1d9d25e76ad43115e1642710955 /macros/latex/contrib/pagecolor
parent999f362e8eb932fc5a4a09a0105de82c52456dbf (diff)
CTAN sync 202211210304
Diffstat (limited to 'macros/latex/contrib/pagecolor')
-rw-r--r--macros/latex/contrib/pagecolor/README34
-rw-r--r--macros/latex/contrib/pagecolor/pagecolor-example.pdfbin85717 -> 81832 bytes
-rw-r--r--macros/latex/contrib/pagecolor/pagecolor.dtx800
-rw-r--r--macros/latex/contrib/pagecolor/pagecolor.pdfbin320120 -> 339411 bytes
4 files changed, 369 insertions, 465 deletions
diff --git a/macros/latex/contrib/pagecolor/README b/macros/latex/contrib/pagecolor/README
index a1dc382c79..0bae5caeb6 100644
--- a/macros/latex/contrib/pagecolor/README
+++ b/macros/latex/contrib/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/macros/latex/contrib/pagecolor/pagecolor-example.pdf b/macros/latex/contrib/pagecolor/pagecolor-example.pdf
index dba8dd4f91..ae63e8048c 100644
--- a/macros/latex/contrib/pagecolor/pagecolor-example.pdf
+++ b/macros/latex/contrib/pagecolor/pagecolor-example.pdf
Binary files differ
diff --git a/macros/latex/contrib/pagecolor/pagecolor.dtx b/macros/latex/contrib/pagecolor/pagecolor.dtx
index 7df746c450..c23d9c4b86 100644
--- a/macros/latex/contrib/pagecolor/pagecolor.dtx
+++ b/macros/latex/contrib/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/macros/latex/contrib/pagecolor/pagecolor.pdf b/macros/latex/contrib/pagecolor/pagecolor.pdf
index d2f611b6ee..08642c75e5 100644
--- a/macros/latex/contrib/pagecolor/pagecolor.pdf
+++ b/macros/latex/contrib/pagecolor/pagecolor.pdf
Binary files differ