From 370b075ef6c7f53a7303af7b3d1e40fd7bfe5e20 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 4 Feb 2012 00:54:24 +0000 Subject: pagecolor (1feb12) git-svn-id: svn://tug.org/texlive/trunk@25284 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/pagecolor/README | 58 ++++++++----- .../doc/latex/pagecolor/pagecolor-example.pdf | Bin 57923 -> 85390 bytes .../doc/latex/pagecolor/pagecolor-example.tex | 93 +++++++++++++++++---- .../texmf-dist/doc/latex/pagecolor/pagecolor.pdf | Bin 291452 -> 304734 bytes 4 files changed, 115 insertions(+), 36 deletions(-) (limited to 'Master/texmf-dist/doc/latex') diff --git a/Master/texmf-dist/doc/latex/pagecolor/README b/Master/texmf-dist/doc/latex/pagecolor/README index df751cfc9c7..5d9bb71b6b6 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, 2011/08/08, v1.0c +README for pagecolor package, 2012/02/01, v1.0d TABLE OF CONTENTS @@ -23,6 +23,8 @@ the most recent call of \pagecolor{...}. The command \thepagecolornone gives the same colour as \thepagecolor, except when the page background colour is "none". In that case \thepagecolor is white and \thepagecolornone is none. +Similar to \newgeometry and \restoregeometry of the geometry +package \newpagecolor{...} and \restorepagecolor are provided. This material is subject to the LaTeX Project Public License (LPPL). See http://www.ctan.org/tex-archive/help/Catalogue/ licenses.lppl.html for the details of that license. @@ -34,7 +36,15 @@ licenses.lppl.html for the details of that license. `pagecolor' is available on CTAN: CTAN:macros/latex/contrib/pagecolor/ -Also a ZIP file is provided that contains the files, already +Running +tex pagecolor.dtx +generates the files +pagecolor.ins, pagecolor.drv, pagecolor.sty, +and pagecolor-example.tex. + +Also a ZIP file is provided that contains these files, +the manual (pagecolor.pdf), the compiled example +(pagecolor-example.pdf), and this README, already sorted in a TDS tree: CTAN:install/macros/latex/contrib/pagecolor.tds.zip @@ -54,9 +64,9 @@ corresponds to Installation with ZIP file in TDS format ---------------------------------------- -The ZIP file `pagecolor.tds.zip' contains the files sorted -in a TDS tree. Thus you can directly unpack the ZIP file -inside a TDS tree. +The ZIP file `pagecolor.tds.zip' contains the files +sorted in a TDS tree. Thus you can directly unpack the +ZIP file inside a TDS tree. (See CTAN:tds.zip for an explanation of TDS.) Example: cd /...somewhere.../texmf @@ -68,20 +78,30 @@ Example: Manual installation ------------------- -a) Download the pagecolor files from CTAN or the TUG server. +a) Download the pagecolor files from CTAN. If necessary, unpack them. b) Generate the package and driver files: - tex pagecolor.ins + tex pagecolor.dtx c) Install the file `*.sty' in your TDS tree: cp *.sty TDS:tex/latex/pagecolor/ Replace `TDS:' by the prefix of your TDS tree (texmf directory). -d) Copy the documentation files to +d) Create the documentation (if necessary), e.g. + pdflatex pagecolor.dtx + makeindex -s gind.ist pagecolor.idx + pdflatex pagecolor.dtx + makeindex -s gind.ist pagecolor.idx + pdflatex pagecolor.dtx +e) Update the databases if necessary, e.g. for teTeX: + mktexlsr .../texmf +f) Create the pagecolor-example.pdf (if necessary), e.g. + pdflatex pagecolor-example.tex + pdflatex pagecolor-example.tex + pdflatex pagecolor-example.tex +g) Copy the documentation files to "TDS:doc/latex/pagecolor/": README, pagecolor.pdf, pagecolor-example.tex, pagecolor-example.pdf. -e) Update the databases if necessary, e.g. for teTeX: - mktexlsr .../texmf 4 ADDITIONAL PACKAGES @@ -101,7 +121,7 @@ which again load other packages 5 PACKAGE COMPATIBILITY ======================= -pagecolor should be loaded quite early, i.e. before +pagecolor should be loaded quite early, i. e. before \pagecolor{...} is used by some other package (but can be loaded later using the pagecolor={...} option with accordingly chosen value), but must be loaded after @@ -112,7 +132,7 @@ at all). 6 AUTHOR/MAINTAINER ===================== -* H.-Martin Münch +* H.-Martin Münch 7 BUG REPORTS @@ -121,15 +141,15 @@ at all). A bug report should contain: * Comprehensive problem description. This includes error or warning messages. - * \errorcontextlines=\maxdimen can be added in the - TeX code to get more information in TeX error messages. +* \errorcontextlines=\maxdimen can be added in the + TeX code to get more information in TeX error messages. * Minimal test file that shows the problem, but does not 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 - of the LaTeX run. +* If you are using LaTeX, then add "\listfiles". 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 necessary, so send them only on request. @@ -138,11 +158,11 @@ A bug report should contain: Bug address ----------- Bug reports can be send to the maintainer: - H.-Martin Münch + H.-Martin Münch 8 KNOWN PROBLEMS ================= -* as yet: none... \ No newline at end of file +* as yet: none. \ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.pdf b/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.pdf index 11e8a4abaae..0fbe9179eb4 100644 Binary files a/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.pdf and b/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.pdf differ diff --git a/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.tex b/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.tex index aa095260c5d..0ed479b3d22 100644 --- a/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.tex +++ b/Master/texmf-dist/doc/latex/pagecolor/pagecolor-example.tex @@ -9,12 +9,12 @@ %% This is a generated file. %% %% Project: pagecolor -%% Version: 2011/08/08 v1.0c +%% Version: 2012/02/01 v1.0d %% -%% Copyright (C) 2011 by +%% Copyright (C) 2011 - 2012 by %% H.-Martin M"unch %% -%% The usual disclaimer applys: +%% The usual disclaimer applies: %% If it doesn't work right that's your problem. %% (Nevertheless, send an e-mail to the maintainer %% when you find an error in this package.) @@ -33,30 +33,42 @@ %% %% The Current Maintainer of this work is H.-Martin Muench. %% -%% This work consists of the main source file pagecolor.dtx -%% and the derived files -%% pagecolor.sty, pagecolor.pdf, pagecolor.ins, pagecolor.drv, -%% pagecolor-example.tex. +%% This work consists of the main source file pagecolor.dtx, +%% the README, and the derived files +%% pagecolor.sty, pagecolor.pdf, +%% pagecolor.ins, pagecolor.drv, +%% pagecolor-example.tex, pagecolor-example.pdf. %% \documentclass[british]{article}[2007/10/19]% v1.4h %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\usepackage{hyperref}[2011/04/17]% v6.82g -\hypersetup{extension=pdf,% +\usepackage[% + extension=pdf,% plainpages=false,% pdfpagelabels=true,% hyperindex=false,% pdflang={en},% pdftitle={pagecolor package example},% - pdfauthor={Hans-Martin Muench},% + pdfauthor={H.-Martin Muench},% pdfsubject={Example for the pagecolor package},% - pdfkeywords={LaTeX, pagecolor, thepagecolor, page colour, Hans-Martin Muench},% + pdfkeywords={LaTeX, pagecolor, thepagecolor, page colour,% + H.-Martin Muench},% pdfview=Fit,pdfstartview=Fit,% pdfpagelayout=SinglePage% -} +]{hyperref}[2011/12/04]% v6.82m \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. -\usepackage[pagecolor={LightGoldenrod1}]{pagecolor}[2011/08/08]% v1.0c + % The xcolor package would not be needed for just using + % the base colours. The color package would be sufficient for that. +\usepackage[pagecolor={LightGoldenrod1}]{pagecolor}[2012/02/01]% v1.0d + +\usepackage{afterpage}[1995/10/27]% v1.08 + % The afterpage package is generally not needed, + % but the |\newpagecolor{somecolour}\afterpage{\restorepagecolor}| + % construct shall be demonstrated. + +\usepackage{lipsum}[2011/04/14]% v1.2 + % The lipsum package is generally not needed, + % but some blind text is needed for the example. + \gdef\unit#1{\mathord{\thinspace\mathrm{#1}}}% \listfiles \begin{document} @@ -64,7 +76,7 @@ \section*{Example for pagecolor} This example demonstrates the use of package\newline -\textsf{pagecolor}, v1.0c as of 2011/08/08 (HMM).\newline +\textsf{pagecolor}, v1.0d as of 2012/02/01 (HMM).\newline The used option was \verb|pagecolor={LightGoldenrod1}|.\newline \verb|pagecolor={none}| would be the default.\newline @@ -89,7 +101,54 @@ when the page colour would be \verb|none|). {\color{\thepagecolor} And that makes this text practically invisible. \newline} -Which made the preceding line of text practically invisible. +{\color{white} Which made the preceding line of text practically +invisible.} + +\pagebreak +\newpagecolor{red} + +This page uses \verb|\newpagecolor{red}|. + +\pagebreak +\restorepagecolor + +{\color{white}And this page uses \verb|\restorepagecolor| to restore +the page colour 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 (pdf\TeX and Lua\TeX; not yet for dvips, dvipdfm(x) +or Xe\TeX), the page colour is now \verb|none|, otherwise \verb|white|: +\verb|\thepagecolor|\ =\ \thepagecolor\ and +\verb|\thepagecolornone|\ =\ \thepagecolornone . + +\pagebreak +\restorepagecolor + +{\color{white}\verb|\restorepagecolor| restored the page colour again.} + +\pagebreak +\pagecolor{green} + +This page is green due to \verb|\pagecolor{green}|. + +\pagebreak +\newpagecolor{blue}\afterpage{\restorepagecolor} + +{\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 +here (i.\,e. green).} + +\smallskip +{\color{red}\textbf{\lipsum[1-11]}} +\bigskip + +The page colour was changed back at the end of the page - +in mid-sentence! \end{document} \endinput diff --git a/Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf b/Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf index 03267664120..e320c292ba4 100644 Binary files a/Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf and b/Master/texmf-dist/doc/latex/pagecolor/pagecolor.pdf differ -- cgit v1.2.3