diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/paracol/bgpaint.dtx')
-rw-r--r-- | Master/texmf-dist/source/latex/paracol/bgpaint.dtx | 601 |
1 files changed, 601 insertions, 0 deletions
diff --git a/Master/texmf-dist/source/latex/paracol/bgpaint.dtx b/Master/texmf-dist/source/latex/paracol/bgpaint.dtx new file mode 100644 index 00000000000..ac79f4e9a91 --- /dev/null +++ b/Master/texmf-dist/source/latex/paracol/bgpaint.dtx @@ -0,0 +1,601 @@ +% \backgroundcolor{t}[rgb]{0.7,0,0} +% \backgroundcolor{b}[rgb]{0.8,0.6,0} +% \backgroundcolor{l}[rgb]{0,0,0.7} +% \backgroundcolor{r}[rgb]{0,0.7,0} +% \backgroundcolor{c[0]}[rgb]{1,0.8,1} +% \backgroundcolor{c[1]}[rgb]{1,1,0.8} +% \backgroundcolor{g}[rgb]{0.8,1,1} +% \backgroundcolor{f}[rgb]{0.8,0,1} +% \backgroundcolor{n}[rgb]{0.8,0.6,1} +% \backgroundcolor{p}[rgb]{0.8,1,0.6} +% \backgroundcolor{s}[rgb]{0.8,0.8,0.8} +% \pagerim5pt +% +% \section{Examples of Background Painting} +% \label{sec:bgpaint} +% \subsection{Fundamental Painting} +% \label{sec:bgpaint-fund} +% \twosided[pcm] +% +% As you undoubtedly notice, this page and a few pages following it are +% colorfully painted. For this and the next three pages, the author +% declared the \bground{} color of each region as follows. +% +% \begin{itemize}\item[] +% |\backgroundcolor{t}[rgb]{0.7,0,0} % dark red for top margin|\\ +% |\backgroundcolor{b}[rgb]{0.8,0.6,0} % dark orange for bottom margin|\\ +% |\backgroundcolor{l}[rgb]{0,0,0.7} % dark blue for left margin|\\ +% |\backgroundcolor{r}[rgb]{0,0.7,0} % dark green for right margin|\\ +% |\backgroundcolor{c[0]}[rgb]{1,0.8,1} % pink for colunmn-0|\\ +% |\backgroundcolor{c[1]}[rgb]{1,1,0.8} % cream yellow for column-1|\\ +% |\backgroundcolor{g}[rgb]{0.8,1,1} % light blue for the gap|\\ +% |\backgroundcolor{f}[rgb]{0.8,0,1} % purple for page-wise floats|\\ +% |\backgroundcolor{n}[rgb]{0.8,0.6,1} | +% |% light purple for page-wise footnotes|\\ +% |\backgroundcolor{p}[rgb]{0.8,1,0.6} | +% |% pale green for pre/post-environment|\\ +% |\backgroundcolor{s}[rgb]{0.8,0.8,0.8} % light gray for spanning texts| +% \end{itemize} +% +% \SpecialUsageIndex{\backgroundcolor} +% +% Therefore, the \bground{} of this |p|re-environment paragraph and other +% stuff above is painted by pale green. +% +% \Index{pre-environment stuff} +% +% Since the author set \Uidx{\!\pagerim!} to be 5\,|pt|, you will see +% unpainted strips of 5\,|pt| wide at all paper edges surrounding painted +% regions. For this and the next three pages, \Uidx{\!\twosided!}|[pcm]| is +% declared to enable |p|, |c| and |m| features but to disable the |b| +% feature. Therefore, though this page \pageref{sec:bgpaint} is even and +% thus the left outside margin is wider than the right inside one, the +% \bground{}s of |l|(eft) and |r|(ight) margins are painted by dark blue and +% dark green respectively. +% \par\bigskip +% +% \begin{paracol}{2} +% This column-0 is now right and inside because of the |c| feature of +% \!\twosided! is enabled. On the other hand, the \bground{} is this column +% is painted by pink because \!\backgroundcolor! for |c[0]| specifies so. +% That is, the column ordinals optionally given to |c|(olumn) (and |g|(ap)) +% regions are \emph{logical} ones not always corresponding to their +% \emph{physical} positions in a page. +% +% \switchcolumn +% \begingroup\it +% As explained in the right column-0, the \bground{} of this left and +% outside column-1 is painted by cream yellow as +% {\rm\!\backgroundcolor!|{c[1]}|} specifies. Now we have a +% {\rm\!\switchcolumn!|*|} with a \mctext{} to show the \bgpaint{} for +% it\footnote{ +% +% Since the footnotes in this \env{paracol} environment are \scfnote{} and +% \mgfnote{}, and \!\backgroundcolor!\texttt{\char`\{n\char`\}} specifies +% light purple, the \bground{} of this (foot)|n|(ote) region is painted by +% the color.}. +% +% \par\endgroup +% \switchcolumn*[\subsection*{The background of this |s|(panning text) +% region is painted by light gray}\medskip] +% +% \begin{figure*}\nosv +% \def\arraystretch{0.8} +% \centerline{\begin{tabular}[b]{|c|}\hline +% \hbox to.9\textwidth{}\\ +% \texttt{f}(loat) region for this page-wise figure is painted by purple\\ +% \\\hline +% \end{tabular}} +% \caption{A Page-Wise Figure} +% \end{figure*} +% +% This paragraph is to show how the first line of a paragraph just below a +% \mctext{} is placed in the painted region. +% \par\vfill +% +% \switchcolumn +% \begingroup\it +% See the right column for the reason why this paragraph is here. +% \par\vfill +% +% See the right column for what we are now doing. +% \par\endgroup +% \switchcolumn +% +% Now we have a \!\flushpage! to see the \bgpaint{} for a material not shown +% in the page, i.e., a page-wise float. +% \flushpage +% +% Since we are now in an odd-numbered page \pageref{page:bgpaint2}, this +% column-0 is now a left one and is still painted by pink of course. +% \par\vfill\label{page:bgpaint2} +% +% This paragraph is to show how the last line of a page without \Scfnote{}s +% is placed in the painted region. +% \par\newpage +% +% This page is to show how the page without any \pwstuff{} looks like. +% \par\vfill +% +% Shortly we will close this \env{paracol} environment in the next page. +% \par\newpage +% +% Now we are closing this \env{paracol} environment to show how its +% \postenv{} is painted. +% +% \switchcolumn +% \begingroup\it +% As expected, the \bground{} of this column-1 is still painted by cream +% yellow. +% \par\vfill +% +% See the comment in the left column. +% \par\newpage +% +% See the right column for the reason why we have this almost blank page. +% \par\vfill +% +% See the right column for what will happen shortly. +% \par\newpage +% +% See the left column for the reason why we are now closing the environment. +% \endgroup +% \end{paracol} +% \bigskip +% +% The \bground{} of this paragraph in |p|(ost-environment) region is also +% painted by pale green, because \postenv{} can be \preenv{} at the same +% time as we see shortly. \par\bigskip +% +% \begin{paracol}{2} +% This short \env{paracol} environment illustrates how the \preenv{} of this +% environment, or the \postenv{} of the last environment in other words, is +% painted. +% +% \switchcolumn +% \begingroup\it +% Therefore, the author does not have much to say in this column, except for +% giving a footnote here\footnote{ +% +% Since this footnote is \mgfnote{} with that in the \postenv{}, it is +% considered as a part of \postenv{} and thus painted by pale green rather +% than light purple.\label{fn:bgpaint1}}. +% \endgroup +% \end{paracol} +% \bigskip +% +% Before moving to the next example, one caution is given for \bgpaint{} of +% \Mgfnote{}s. As the footnote \ref{fn:bgpaint1} itself says, \Mgfnote{}s +% given in the \lpage{} of a \env{paracol} environment are considered as +% belonging to \postenv{}. Therefore, the footnote \ref{fn:bgpaint1} is +% painted by pale green as well as another footnote given now\footnote{ +% +% Since this footnote really belongs to \postenv{}, its \bground{} is painted +% by pale green naturally.}. +% \par\label{page:bgpaint4} +% +% +% +% \newpage +% \backgroundcolor{t(0pt,0pt)(0pt,-4pt)}[rgb]{0.7,0,0} +% \backgroundcolor{b(0pt,-4pt)(0pt,0pt)}[rgb]{0.8,0.6,0} +% \backgroundcolor{l(0pt,4pt)(-4pt,4pt)}[rgb]{0,0,0.7} +% \backgroundcolor{r(-4pt,4pt)(0pt,4pt)}[rgb]{0,0.7,0} +% \backgroundcolor{c[0](4pt,4pt)}[rgb]{1,0.8,1} +% \backgroundcolor{c[1](4pt,4pt)}[rgb]{1,1,0.8} +% \backgroundcolor{g(-4pt,4pt)}[rgb]{0.8,1,1} +% \backgroundcolor{f(4pt,4pt)(4pt,-4pt)}[rgb]{0.8,0,1} +% \backgroundcolor{n(4pt,-4pt)(4pt,4pt)}[rgb]{0.8,0.6,1} +% \backgroundcolor{p(4pt,4pt)}[rgb]{0.8,1,0.6} +% \backgroundcolor{s(4pt,-4pt)}[rgb]{0.8,0.8,0.8} +% +% \subsection{Mirrored Painting and Enlarging/Shrinking/Shifting Regions} +% \label{sec:bgpaint-me} +% \twosided +% +% At a glance, this and the next three pages look painted similarly to +% previous four pages, but by a careful examination you should notice +% two important differences. The first one is found in the colors +% of left and right margins. As the author enabled all features of +% \Uidx{\!\twosided!} including |b| for \mirror{}ing and we are now in an +% even-numbered page \pageref{sec:bgpaint-me}, the left and outside margin +% is painted by dark green for the region |r|(ight margin), while the right +% and inside one is painted by dark blue for |l|(eft margin). +% +% The other is that regions are enlarged, shrunk or shifted by 4\,|pt| by +% the following \!\backgroundcolor! commands with extensions. +% +% \begin{itemize}\item[] +% |\backgroundcolor{t(0pt,0pt)(0pt,-4pt)}[rgb]{0.7,0,0} | +% |% B up|\\ +% |\backgroundcolor{b(0pt,-4pt)(0pt,0pt)}[rgb]{0.8,0.6,0} | +% |% T down|\\ +% |\backgroundcolor{l(0pt,4pt)(-4pt,4pt)}[rgb]{0,0,0.7} | +% |% R left T/B outside|\\ +% |\backgroundcolor{r(-4pt,4pt)(0pt,4pt)}[rgb]{0,0.7,0} | +% |% L right T/B outside|\\ +% |\backgroundcolor{c[0](4pt,4pt)}[rgb]{1,0.8,1} | +% |% all edges outside|\\ +% |\backgroundcolor{c[1](4pt,4pt)}[rgb]{1,1,0.8} | +% |% all edges outside|\\ +% |\backgroundcolor{g(-4pt,4pt)}[rgb]{0.8,1,1} | +% |% L/R inside & T/B outside|\\ +% |\backgroundcolor{f(4pt,4pt)(4pt,-4pt)}[rgb]{0.8,0,1} | +% |% L/R outside & T/B up|\\ +% |\backgroundcolor{n(4pt,-4pt)(4pt,4pt)}[rgb]{0.8,0.6,1} | +% |% L/R outside & T/B down|\\ +% |\backgroundcolor{p(4pt,4pt)}[rgb]{0.8,1,0.6} | +% |% all edges outside|\\ +% |\backgroundcolor{s(4pt,-4pt)}[rgb]{0.8,0.8,0.8} | +% |% L/R outside & T/B inside| +% \end{itemize} +% +% \SpecialUsageIndex{\backgroundcolor} +% +% In the comments above, |L|(eft), |R|(ight), |T|(op) and |B|(ottom) mean +% edges moved by a given extension. Therefore, for example, +% ``|L/R outside & T/B up|'' for |f|(loat) region means it is enlarged +% horizontally and shifted up vertically by the asymmetric extension +% |(4pt,4pt)(4pt,-4pt)|. These a little bit complicated setting of +% extensions are to solve the problems in the fundamental example shown in +% previous four pages, namely too strict definition of the regions to be +% painted. That is, both vertical edges of regions having texts, e.g., +% |c|(olumn) regions, should look too close to the first and last letters. +% Similarly both horizontal edges of those regions seem too close especially +% when the first line is tall (e.g., the section title in +% p.\Tie\pageref{sec:bgpaint} and the page-wise figure in +% p.\Tie\pageref{page:bgpaint2}) and the last line of a column is followed by +% \mctext{} or \postenv. Therefore, the author made fine tuning moving +% inside edges of margins outside, and so on. We will come back this issue +% after exemplifying the effect of the tuning. +% \par\bigskip +% +% \advance\skip\footins4pt\relax +% \begin{paracol}{2} +% By the tuning to enlarge this |c|(olumn) region, this paragraph has +% comfortable spaces above and below it, as well as at the both side edges. +% +% \switchcolumn +% \begingroup\it +% This paragraph is surrounded by spaces of a small but comfortable amount as +% well.\footnote{ +% +% Shifting this (foot)|n|(ote) region down a little bit, the space below this +% footnote and above the top edge of the |b|(ottom margin) region is enlarged.}. +% +% \par\endgroup +% \switchcolumn*[\subsection*{The background of this |s|(panning text) +% region is painted by light gray and enlarged horizontally but shrunk +% vertically}\par\medskip] +% +% \begin{figure*}\nosv +% \def\arraystretch{0.8} +% \centerline{\begin{tabular}[b]{|c|}\hline +% \hbox to.9\textwidth{}\\ +% shifting up this \texttt{f}(loat) region gives us a small space above +% the top edge of the rectangle\\ +% \\\hline +% \end{tabular}} +% \caption{A Page-Wise Figure} +% \end{figure*} +% +% This paragraph is to show how well the first line of a paragraph just below a +% \mctext{} is separated from the boundary of two painted regions. +% \par\vfill +% +% \switchcolumn +% \begingroup\it +% See the right column for the reason why this paragraph is here. +% \par\vfill +% +% See the right column for what we are now doing. +% \par\endgroup +% \switchcolumn +% +% By enlarging this |c|(olumn) region and shift the (foot)|n|(ote) region +% down, this paragraph has a comfortable amount of space below it. +% \flushpage +% +% Similarly to other paragraphs below \pwstuff, this paragraph is well +% separated from the bottom edge of the |f|(loat) region above. +% +% \par\vfill\label{page:bgpaint-me2} +% +% As in the case of the line above \Scfnote{}s, the last line of this +% paragraph has a sufficient space separating it from the top edge of the +% |b|(ottom margin) region. +% \par\newpage +% +% This page is to show how the page without any \pwstuff{} looks like. As +% you are seeing, the space above this paragraph is sufficient and +% comfortable. +% \par\vfill +% +% Shortly we will close this \env{paracol} environment in the next page. +% \par\newpage +% +% Now we are closing this \env{paracol} environment to show how this +% paragraph is separated from the boundary of |c|(olumn) and +% |p|(ost-environment) regions. +% +% \switchcolumn +% \begingroup\it +% See the comment in the left column for the intention of placing this +% paragraph here. +% \par\vfill +% +% See the comment in the left column, too. +% \par\newpage +% +% See the right column for the reason why we have this almost blank page. +% \par\vfill +% +% See the right column for what will happen shortly. +% \par\newpage +% +% See the left column for the reason why we are now closing the environment. +% \endgroup +% \end{paracol} +% \bigskip +% +% The \bground{} of this paragraph in |p|(ost-environment) region is +% painted by pale green as done in p.\Tie\pageref{page:bgpaint4}, but its top +% and bottom edges \emph{look} shifted down and up to give spaces below and +% above the last and first paragraphs in \env{paracol} environments, +% respectively. +% \par\bigskip +% +% \begin{paracol}{2} +% This short \env{paracol} environment illustrates how the \preenv{} of this +% environment, or the \postenv{} of the last environment in other words, is +% painted. +% +% \switchcolumn +% \begingroup\it +% Therefore, the author does not have much to say in this column, except for +% giving a footnote here\footnote{ +% +% As the footnote \ref{fn:bgpaint1} in p.\Tie\pageref{fn:bgpaint1}, this +% \Mgfnote{} is a part of \postenv{} and thus painted by pale green rather +% than light purple.\label{fn:bgpaint-me1}}. +% \endgroup +% \end{paracol} +% \bigskip +% +% In the setting with \!\backgroundcolor! commands in +% p.\Tie\pageref{sec:bgpaint-me}, the author carefully moved contacting edges +% of regions. For example, to enlarge |c|(olumn) regions, the inside edges +% of |l|(eft margin) and |r|(ight margin) regions are moved outside, and both +% vertical edges of the |g|(ap) region shifted toward its inside. As for +% the horizontal edges, the bottom edges of |t|(op margin) and |f|(loat) +% regions are moved up, the top edges of |b|(ottom margin) and +% (foot)|n|(ote) regions are moved down, and both top and bottom edges of +% the |s|(panning text) region are shifted toward its inside. +% +% These edge shifting could make a region too narrow or too much shifted +% resulting in a material in it overreaching its boundary, especially in +% vertical shifting of horizontal edges. However we can exploit some large +% space automatically or manually inserted above and/or below the material +% to avoid overreaching. That is the author exploited the following spaces; +% \!\headsep! below the page head (though it is empty in this document); +% \!\dbltextfloatsep! below the bottom-most page-wise float; spaces that +% \!\subsection!|*| inserts above and below it together with manually +% inserted \!\medskip! below it; \!\skip!\!\footins!\footnote{ +% +% This is a kind of ``length command'' maybe not widely known.} +% +% above the first footnote which the author enlarged by 4\,|pt| temporarily +% for this and the next subsections; and \!\footskip! from the bottom edge +% of text area to that of the page number. +% +% Now you might notice that the explanation above does not mention the |p| +% region for \Preenv{} and \postenv. As you should find in the settings, +% this region is enlarged horizontally \emph{and vertically} so that its top +% and bottom edges are moved up and down when the region is at the top or +% bottom of a page, as you are seeing now and find in +% p.\Tie\pageref{sec:bgpaint-me}. However, this enlargement of course has a +% side effect that the region collides against |c|(olumn) and |g|(ap) regions +% also enlarged vertically making them overlapped. This overlap will be +% invisible with most of \emph{printers} because, as shown in +% Section\Tie\ref{sec:ref-bgpaint}, |p| region is painted \emph{before} |c| +% and |g| regions are painted. In addition, since relatively large spaces +% of \!\bigskip! are manually inserted before each \beginparacol{} and after +% each \Endparacol{}, texts in \Preenv{} and \postenv{} are well separated +% from region boundaries. +% +% This overlay painting |c| and |g| over |p|, however, might produce an +% unexpected result with some printer with which, for example, two colors +% are \emph{blended} in the thin overlapped strip\footnote{ +% +% For example, a dvi previewer |dviout| produces such a blended result with +% the default setting of coloring.}. +% +% Unfortunately, this overlay painting is inevitable in the current version +% 1.3, but in a future version, hopefully 1.4, more sophisticated +% \emph{position-dependent} region definition, for example, to shift the top +% edge of |p| region only when the region is at the top of page, could be +% introduced. +% +% Another remark is that the \mirror{}ing specified by the |b| feature of +% \!\twosided! works not only on the colors of side margins but also on +% their asymmetric shrinkage. That is, the asymmetric shifts of vertical +% edges of |l| and |r| regions correctly performed irrespective of their +% physical positions, i.e., even when the |l| (resp.\ |r|) region is at +% the right (resp.\ left) margin and the edge to be shift is the left +% (resp.\ right) one rather than right (resp.\ left). +% +% +% +% \newpage \suppressfloats +% \nobackgroundcolor{t} +% \nobackgroundcolor{b} +% \nobackgroundcolor{l} +% \nobackgroundcolor{r} +% \nobackgroundcolor{g} +% \backgroundcolor{c[0](4pt,4pt)(0.5\columnsep,4pt)}[rgb]{1,0.8,1} +% \backgroundcolor{c[1](0.5\columnsep,4pt)(4pt,4pt)}[rgb]{1,1,0.8} +% \backgroundcolor{C[0](10000pt,10000pt)(0.5\columnsep,10000pt)}[rgb]{1,0.8,1} +% \backgroundcolor{C[1](0.5\columnsep,10000pt)(10000pt,10000pt)}[rgb]{1,1,0.8} +% +% \subsection{Regions with Infinite Extensions} +% \label{sec:bgpaint-inf} +% +% You are now seeing another \bgpaint{} much different from previous two +% examples. That is, after disabling painting of |t|, |b|, |l|, |r| and |g| +% regions by \Uidx{\!\nobackgroundcolor!}, the author gave the followings +% for painting this and the next pages. +% +% \begin{itemize}\item[] +% |\backgroundcolor| +% |{c[0](4pt,4pt)(0.5\columnsep,4pt)}[rgb]{1,0.8,1}|\\ +% |\backgroundcolor| +% |{c[1](0.5\columnsep,4pt)(4pt,4pt)}[rgb]{1,1,0.8}|\\ +% |\backgroundcolor| +% |{C[0](10000pt,10000pt)(0.5\columnsep,10000pt)}[rgb]{1,0.8,1}|\\ +% |\backgroundcolor| +% |{C[1](0.5\columnsep,10000pt)(10000pt,10000pt)}[rgb]{1,1,0.8}| +% \end{itemize} +% +% \SpecialUsageIndex{\backgroundcolor} +% +% The first two lines above is different from the previous declaration +% because inside edges of |c[0]| and |c[1]| regions are shifted toward +% outside of them and thus inside of unpainted |g| region so that the edges +% are contacted. On the other hand, the last two lines are for +% \emph{under-painting} of columns and has \emph{\bginfext} to make top, +% bottom and outside edges of |C| regions reaching to the corresponding +% paper edges. Since this under-painting is done with colors same as those +% of over-painting of |c| regions, you will have an impression that the +% paper is two-toned and \pwstuff{} are pasted on the paper\footnote{ +% +% This footnote is given outside \env{paracol} environment but its +% \bground{} is painted by light purple because it is merged with the +% footnote \ref{fn:bgpaint-inf2}.\label{fn:bgpaint-inf1}}. +% +% \par\bigskip +% +% \begin{figure}\nosv +% \def\arraystretch{0.8} +% \centerline{\begin{tabular}[b]{|c|}\hline +% \hbox to.9\textwidth{}\\ +% \parbox{.8\textwidth}{ +% This \texttt{f}(loat) region could be extended to both side edges +% and the top edge of the paper if its extension were +% \texttt{(10000pt,10000pt)(10000pt,-4pt)}.}\\ +% \\\hline +% \end{tabular}} +% \caption{A Page-Wise Figure \emph{Imported} from Pre-Environment} +% \label{fig:bgpaint-inf} +% \end{figure} +% +% \begin{paracol}{2} +% Though you cannot see, the right edge of this over-painted |c[0]| region +% is shifted right by 4\,|pt| to hide the small patch at the right bottom +% corner of the |p| region above by overlaying. +% +% \switchcolumn +% \begingroup\it +% As explained in the right column, this {\rm|c[1]|} region also has an +% invisible left edge shifted left by {\rm4\,|pt|}\footnote{ +% +% This (foot)|n|(ote) region could be extended to both side edges and the +% bottom edge of the paper if its extension were +% \texttt{(10000pt,-4pt)(10000pt,10000pt)}.\label{fn:bgpaint-inf2}}. +% \endgroup +% +% \switchcolumn*[\subsection*{This \texttt{s}(panning text) region could be +% extended to both side edges of the paper if its extension were +% \texttt{(10000pt,-4pt)}.}\par\medskip] +% +% The author does not have much to say now for this column chunk. +% \par\vfill +% +% Still nothing to say particular to the page break we will have shortly. +% \par\newpage +% +% This paragraph is just for keeping the \env{paracol} environment alive in +% this page. +% \switchcolumn +% +% \begingroup\it +% Little to say as well. +% \par\vfill +% +% Nothing to say as well. +% \par\newpage +% +% This paragraph is not necessary for keeping alive the environment but is +% given for consistent view. +% \endgroup +% +% \begin{figure*}\nosv +% \def\arraystretch{0.8} +% \centerline{\begin{tabular}[b]{|c|}\hline +% \hbox to.9\textwidth{}\\ +% \parbox{.8\textwidth}{ +% This figure is given in the \env{paracol} environment closed in the +% previous page but its background is not painted.}\\ +% \\\hline +% \end{tabular}} +% \caption{A Page-Wise Figure \emph{Exported} to Post-Environment} +% \label{fig:bgpaint-inf2} +% \end{figure*} +% \end{paracol} +% \bigskip +% +% Note that overlay painting is inevitable for two-toned page painting, as +% far as you want to paint \bground{} of \pwstuff. +% +% The last issue of \bgpaint{} is about painting materials given outside +% \env{paracol}. As you have seen, \Preenv{} and \postenv{} are painted but +% it is done only when they reside in a page having a portion of a +% \env{paracol} environment (maybe) of course. Therefore, the next page is +% \emph{not} painted because the page does not have any parallel-columned +% stuff. Therefore, even if you wish to paint the whole of your document +% including pages without \env{paracol} stuff, you cannot do it just with +% \Paracol{} package, at least so far. +% +% On the other hand, some materials given outside \env{paracol} environments +% are painted as if they are given in the environment when they are +% \emph{imported} into the environment. One category has footnotes given in +% \preenv{} when \!\footnotelayout!|{m}| is specified for merging, as +% exemplified by the footnote \ref{fn:bgpaint-inf1} in the previous page. +% Note that such a footnote is painted by the color for |n| region rather +% than |p| region even when there are no footnotes in the \env{paracol} +% environment. The other category has ordinary floats given by \env{figure} +% and/or \env{table} +% (i.e., neither \env{figure*} nor \env{table*}) environments outside +% \env{paracol} and then \emph{deferred} to a page having (a portion of) +% stuff produced by \env{paracol}. Since such a float, e.g., +% Figure\Tie\ref{fig:bgpaint-inf} in this page, is considered as a page-wise +% float given in the \env{paracol} environment in this section, its +% background is painted by the color for the |f| region, rather than that +% for the |p| region which would be used if the float were is placed in the +% previous page. Note that such a deferred float import could occur not +% only from the page having \beginparacol{} but also from pages preceding +% it. For example, if you have three \env{figure} environments in a page +% $p-1$ just preceding the page $p$ in which you start a \env{paracol} +% environment, it could happen that first one is placed in $p-1$ without +% painting, the second is placed in $p$ and painted by the color for |p|, +% and the third is placed in $p+1$ and painted by the color for |f|. +% +% Finally some materials \emph{exported} from a \env{paracol} environment +% are painted as if they are in \postenv. In previous two subsections, we +% saw \Mgfnote{}s (e.g., \ref{fn:bgpaint1} in p.\Tie\pageref{fn:bgpaint1} +% and \ref{fn:bgpaint-me1} in p.\Tie\pageref{fn:bgpaint-me1}) are painted by +% the color of |p| rather than |n|. The other kind of exportation is of +% page-wise floats given in a \env{paracol} environment but deferred to the +% page next to the page having \Endparacol, or further. For example, +% Figure~\ref{fig:bgpaint-inf2} is given in the \env{paracol} environment +% above in this page, but its \bground{} is not painted because the next page +% in which the figure is placed does not have any parallel-columned +% stuff\footnote{ +% +% If it has, the background is painted by the color for |p|.}. +% +% \newpage\vspace*{\fill} +% \centerline{(intentionally blanked page to show this page is \emph{not} +% painted)} +% \vfill +% \advance\skip\footins-4pt\relax +% \endinput |