From c7114843bd7744e08eedba6eaff2e358b78e2349 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 12 Oct 2015 22:17:55 +0000 Subject: missed commit git-svn-id: svn://tug.org/texlive/trunk@38621 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/source/latex/paracol/ppts.dtx | 448 ++++++++++++++++++++++++ 1 file changed, 448 insertions(+) create mode 100644 Master/texmf-dist/source/latex/paracol/ppts.dtx diff --git a/Master/texmf-dist/source/latex/paracol/ppts.dtx b/Master/texmf-dist/source/latex/paracol/ppts.dtx new file mode 100644 index 00000000000..311a1efda13 --- /dev/null +++ b/Master/texmf-dist/source/latex/paracol/ppts.dtx @@ -0,0 +1,448 @@ +% \marginparpush5pt \@mparswitchtrue +% \section{Two-Sided Typesetting and Parallel-Paging} +% \label{sec:ppts} +% \changes{v1.3-2}{2013/09/17} +% {Add the section ``Two-Sided Typesetting and Parallel-Paging''.} +% \changes{v1.3-4}{2013/09/17} +% {Add the section ``Two-Sided Typesetting and Parallel-Paging''.} +% \changes{v1.3-5}{2013/09/17} +% {Add the section ``Two-Sided Typesetting and Parallel-Paging''.} +% +% This and the next section are typeset with \Uidx{\!\twosided!} enabling +% features |p|, |c| and |m| and also |b| for a part of the next section. +% The effect of |p| feature can be seen by the left side, or in other word +% inside, margin of this odd-numbered page is narrower than that of the +% previous pages because the author reduced the effective left side margin +% being $\!\oddsidemargin!+1\,|in|$ by 75\,\%\footnote{ +%  +% This document itself does not have |twoside| option in its +% \!\documentclass! but the inconsistency between the option and +% \!\twosided! is not visible because \!\pagestyle! is |plain|.}. +%  +% This setting makes the right side or outside margin of this page enlarged +% by 125\,\% as well as the left side and outside margin of the next +% even-numbered page. +% +% Next, we see the effects of |c| and |m| features by the \env{paracol} +% environment below for which \Uidx{\!\columnratio!}|{0.6}| and +% \Uidx{\!\marginparthreshold!}|{0}| are declared to make the \emph{inside} +% columns (left ones in odd-numbered pages) are wider than the +% \emph{outside} ones and all marginal notes go to outside (right in +% odd-numbered pages) margins. +%  +% \columnratio{0.6}\marginparthreshold{0} +%  +% \par\Hrule +% \begin{paracol}{2} +% \switchcolumn +% \footnotetext*{Since the author is temporarily disabling the warning from +% marginal note placement mechanism of \LaTeX, pushing down the second +% marginal note from column-1 is silently performed when you process this +% document.} +% \switchcolumn +% This line\Marginpar{First marginal note from column-0.} of the first +% paragraph of the inside column-0 has a marginal note. Now the author puts +% a few dummy lines to keep a space below the marginal note.\\ +% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ +% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\par +% +% This line\Marginpar{Second marginal note from column-0.} of the second +% paragraph of the inside column-0 also has a marginal note. Now the author +% puts a few dummy lines again but this time to go down to the bottom of the +% page.\\ +% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ +% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ +% \Dotfill\\ \Dotfill\\ \Dotfill\par +% +% This is the third paragraph of the inside column-0 having a page break in +% it. Since shortly we will be in an even-numbered page +% \pageref{page:ppts2} (now), this wider column\Marginpar{Third marginal +% note from column-0} is now right one keeping it +% inside, while the marginal note given in the first line of this page goes +% to left and outside. Now we will have a \!\switchcolumn! below this +% paragraph to go to the column-1 and back to the previous page +% \pageref{sec:ppts}.\label{page:ppts2} +% \switchcolumn +% \it +% This is the first paragraph in the narrower, italicized and outside +% column-1. In this paragraph, we shortly have a marginal note, italicized +% too, which goes to the outside margin shared by all marginal notes from +% both columns.\Marginpar{\it First marginal note from column-1.} The +% marginal note given here is placed its natural position and its first line +% is aligned to the first line of the second sentence of this paragraph by +% exploitation of the space between two marginal notes from the column-0, +% though we already have had three notes from the column. +% +% Now\Marginpar{\it Second marginal note from column-1.} the author puts +% another marginal note whose first line would be aligned to that of this +% paragraph, but it is pushed down below the second marginal note from the +% column-0 because two notes conflict with each other over the +% space\footnotemark*[+0]. Note that since the note from this column is given +% \emph{after} that from the column-0 was given, the conflict is solved +% pushing the note from this column down rather than that from the +% column-0. Now the author puts a few dummy lines to go to the second last +% line of this page.\\ +% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ +% \Dotfill\par +% +% This is the third paragraph of the outside column-1, which becomes left +% shortly by the page break.\Marginpar{\it Third marginal note from +% column-1.} The third marginal note is given in the first line of this +% page, but it is pushed down again due to the conflict with the note from +% the column-0. +% \end{paracol} +% \Hrule +% +% Note that the position of the last marginal note in the \env{paracol} +% \Marginpar{Marginal note given after \env{paracol} environment is closed.} +% environment which we just have closed affects the marginal note placement +% in \postenv. For example, the marginal note given in the first line of +% this paragraph is pushed down. +% +% From the next page, we will see a few examples of \parapag{}ing. +% +% +% +% \newpage +% \subsection{Example of Paired Parallel-Paging} +% \label{sec:ppts-paired} +% +% Shortly we will start a \env{paracol} environment by \beginparacol|[2]{4}| +% having four columns but two for each of left and right \paired{} +% \parapag{}es. Since the author declares \!\columnratio!|{0.6}[0.5]|, the +% columns in left pages are made unbalanced while those in right pages are +% balanced. +%  +% \columnratio{0.6}[0.5] +% \par\Hrule +% \begin{paracol}[2]{4} +% This is the first paragraph of the leftmost column-0, +% \Marginpar{Marginal note from column-0.} +% whose first line has a marginal note placed in the right margin because +% the setting of \!\marginparthreshold! being 0 is still effective and we +% are in the odd-numbered page \pageref{sec:ppts-paired}. Now we +% have a \!\switchcolumn! to the next column-1. +% +% \switchcolumn +% \begin{Hfuzz}{1.1pt}\it +% This is the first paragraph of the second and right column-1 in the left +% \parapag{}e. We shortly give an italicized mar\-gin\-al note carefully, so +% that it does not conflict with the marginal note from the column-0. +% \Marginpar{\it Marginal note from column-1.} +% That is, now the author puts the note. Now we +% have a \!\switchcolumn! to the next column-2. +% \end{Hfuzz} +% \footnotetext*{This footnote is put in the left \parapag{}e together with +% another footnote below given in the column-2 in the right \parapag{}e. +% \label{fn:ppts-paired1}} +% +% \switchcolumn +% \begingroup\sf +% This is the first paragraph of the column-2 being the left column of the +% right \parapag{}e. Though we are in a page different from that column-0 +% and 1 reside in, this page is still numbered \pageref{sec:ppts-paired} +% because the left and right page is \paired. Therefore, the left margin of +% this page is narrower than the right margin because the page number is +% odd. +%  +% \footnotetext*{This footnote is \emph{not} put in the right \parapag{}e +% though it is given in the column-2 in the right \parapag{}e and thus its +% reference is in the column, of course.\label{fn:ppts-paired2}} +% +% You have to notice +% \Marginpar{\sf Marginal note from column-2.} +% the first paragraph does not start from the page top +% but above it we have some space of exactly same size as the \preenv{} +% shown in the left \parapag{}e. Therefore, the top of the first paragraphs +% in all columns are aligned. The marginal note given in the first line of +% this paragraph goes to the right margin of this page because of the +% \!\marginparthreshold! setting and the parity of this page. Now we have a +% \!\switchcolumn! to the next column-3. +% \par\endgroup +% \begin{figure*}\nosv +% \def\arraystretch{0.8} +% \centerline{\begin{tabular}[b]{|c|}\hline +% \hbox to.9\textwidth{}\\ +% \sf page-wise figure given in column-2\\ +% \\\hline +% \end{tabular}} +% \caption{A Page-Wise Figure} +% \end{figure*} +% +% \switchcolumn +% \begingroup\sl +% This is the first paragraph +% \Marginpar{\sl Marginal note from column-3.} +% in the last rightmost column-3 whose width is equal to that of the column-2. +% The marginal note given in the first line goes to right and does not +% conflict with that from the column-2. We are now going back to the +% column-0 by a {\rm\!\switchcolumn!|*|} with a \mctext. +% \endgroup +% +% \switchcolumn*[\subsection*{A Spanning Text: though this is wider than the +% page width, this text does not span the boundary between the left and +% right parallel-pages.}] +% +% We have come back to this column-0. The space above the \mctext{} is due +% to the \sync{}ation because two paragraphs in the column-2 are +% significantly taller in total than the paragraphs in other columns. As +% the spanning text itself says, it cannot extend to the right \parapag{}e. +% The author puts dummy lines to go to the page bottom.\\ +% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ +% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\par +% +% Now we will have a page break shortly. You could be surprised by seeing +% this column is not in the left \parapag{}e after the break but in the +% right one. This is because the feature |c| is enabled to swap not only +% columns in a page but also the left and right \paired{} \parapag{}es when +% they are even-numbered. The other feature |p| makes the left outside +% margins of this right and the previous left pages wider than the right +% inside margins.\label{page:ppts-paired2} +% +% \switchcolumn +% \begingroup\it +% We have restarted this column-1. This paragraph has a +% footnote\footnotemark*[-1] as shown below.\\ +% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ +% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ +% \Dotfill\\ \Dotfill\par +% +% After the page break below, this column also goes to the right page +% together with the column-0 +% \Marginpar{\it Another marginal note from column-1.} +% and is placed outside (left) in the page, as well as the marginal note +% in this right page but in the outside margin. +% \par\endgroup +% +% \switchcolumn +% \begingroup\sf +% We have a few other materials not shown in right \parapag{}es. The space +% above this paragraph is for the \mctext{} placed in the left \parapag{}e. +% The \Scfnote{} given here\footnotemark{} is also not in this page but in +% the left. Finally, the author has put a page-wise figure spanning columns +% just before \!\switchcolumn! by which we left this column, but it will be +% in the right page \pageref{page:ppts-paired2} together with column-0 and +% 1.\\ +% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ +% \Dotfill\\ \Dotfill\\ \Dotfill\par +% +% Though the footnote numbered \ref{fn:ppts-paired2} goes to the left page, +% its space and that of \ref{fn:ppts-paired1} make this and the next columns +% shorter in the previous page. Similarly, we have a space above for the +% page-wise figure shown in the right page. +% \par\endgroup +% +% \switchcolumn +% \begingroup\sl +% As expected, this line is aligned to the first line of the paragraph in +% the column-2 as well as those in column-0 and 1. It is also consistent +% the first lines including that of this paragraph are not indented because +% the \mctext{} is given by {\rm\!\subsection!|*|} which makes first +% paragraphs unindented.\\ +% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ +% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\par +% +% After the page break we will have shortly, this column becomes the +% leftmost in the left \parapag{}e, as you are seeing now, +% \Marginpar{\sl Another marginal note from column-3.} +% but still outermost as well as the marginal note in the outside left +% margin. +% \endgroup +% \end{paracol} +% \Hrule +% +% Now you are seeing yet another material placed only in the page in which +% the column-0 resides and thus being the right page now, i.e., this +% paragraph and the next one in the \postenv. You might be disappointed by +% the fact the \emph{outside} pages, i.e., left in this page +% \pageref{page:ppts-paired2} and right in the previous page +% \pageref{sec:ppts-paired}, cannot have \pwstuff{} but it is what the +% author can do now for the version 1.3 and thus you have to wait some +% future versions in which the author could devise a mechanism to exploit +% the corresponding space in the pages\footnote{ +%  +% You might complain the immaturity of \parapag{}ing and might claim that it +% should be included in \Paracol{} after the author implements the +% mechanism. In fact the author himself is frustrated current features of +% \parapag{}ing but he dared to release the version 1.3 knowing that there +% are people who happily typeset their \parapag{}ed documents with the +% current limited features.}. +%  +% In addition, you might think it is weird that the |c| feature of +% \!\twosided! swaps columns \emph{and} paired pages. However this swapping +% is a natural consequence of the combination of \cswap{} and \paired{} +% \parapag{}ing. Therefore, you can simply disable the |c| feature (maybe +% together with other features) to have more intuitive results. +% +% In the next Section~\ref{sec:ppts-npaired}, you will see another kind of +% \parapag{}ing namely \npaired{} one. Before that, we need a blank page to +% let the \npaired{} \parapag{}ing start from an even-numbered page so that +% a left and right page pair comprises a double spread. A short remark on +% the blank next page is that it does not have a right counterpart +% \parapag{}e because the page is outside \env{paracol} environments and does +% not have any portion from the environments\footnote{ +%  +% To illustrate this fact, the author dares to put a real blank page rather +% than stepping the \counter{page} counter.}. +%  +% \newpage\vspace*{\fill}\centerline{(intentionally blanked page)}\vfill +% +% +% +% \newpage +% \subsection{Example of Non-Paired Parallel-Paging} +% \label{sec:ppts-npaired} +% +% This and following three pages are to show an example of \npaired{} +% \parapag{}ing, in which the author keeps the setting of \!\twosided!, +% \!\columnratio! and \!\marginparthreshold! unchanged. +% The arguments of \beginparacol{} for column population are also unchanged +% to have $2+2$ configuration, but the first argument is followed by |*| for +% \npaired{} typesetting. That is, the environment below starts by +% \beginparacol|[2]*{4}|. The contents of the environment is also almost +% same as the previous Section~\ref{sec:ppts-paired}, while +% \Emph{bold-faced} words show the difference from the \paired{} +% typesetting. +%  +% \columnratio{0.6}[0.5] +% \par\Hrule +% \begin{paracol}[2]*{4} +% This is the first paragraph of the leftmost column-0, +% \Marginpar{Marginal note from column-0.} +% whose first line has a marginal note placed in the \Emph{left} margin +% because the setting of \!\marginparthreshold! being 0 is still effective +% and we are in the \Emph{even}-numbered page +% \Emph{\pageref{sec:ppts-npaired}}. Now we have a \!\switchcolumn! to the +% next column-1. +% +% \switchcolumn +% \begingroup\it +% This is the first paragraph of the second and right column-1 in the left +% \parapag{}e. We shortly give an italicized mar\-gin\-al note carefully, so +% that it does not conflict with the marginal note from the column-0. +% \Marginpar{\it Marginal note from column-1.} +% That is, now the author puts the note. Now we +% have a \!\switchcolumn! to the next column-2. +% \par\endgroup +% \footnotetext*{This footnote is put in the left \parapag{}e together with +% another footnote below given in the column-2 in the right \parapag{}e. +% \label{fn:ppts-npaired1}} +% +% \switchcolumn +% \begingroup\sf\label{page:ppts-npaired1r} +% This is the first paragraph of the column-2 being the left column of the +% right \parapag{}e. \Emph{Since we are in the page next to} that column-0 +% and 1 reside in, this page is numbered \Emph{\pageref{page:ppts-npaired1r}} +% because the left and right page is \Emph{\npaired}. Therefore, the left +% margin of this page is narrower than the right margin because the page +% number is odd. +%  +% \footnotetext*{This footnote is \emph{not} put in the right \parapag{}e +% though it is given in the column-2 in the right \parapag{}e and thus its +% reference is in the column, of course.\label{fn:ppts-npaired2}} +% +% You have to notice +% \Marginpar{\sf Marginal note from column-2.} +% the first paragraph does not start from the page top +% but above it we have some space of exactly same size as the \preenv{} +% shown in the left \parapag{}e. Therefore, the top of the first paragraphs +% in all columns are aligned. The marginal note given in the first line of +% this paragraph goes to the right margin of this page because of the +% \!\marginparthreshold! setting and the parity of this page. Now we have a +% \!\switchcolumn! to the next column-3. +% \par\endgroup +% \begin{figure*}\nosv +% \def\arraystretch{0.8} +% \centerline{\begin{tabular}[b]{|c|}\hline +% \hbox to.9\textwidth{}\\ +% \sf page-wise figure given in column-2\\ +% \\\hline +% \end{tabular}} +% \caption{A Page-Wise Figure} +% \end{figure*} +% +% \switchcolumn +% \begingroup\sl +% This is the first paragraph +% \Marginpar{\sl Marginal note from column-3.} +% in the last rightmost column-3 whose width is equal to that of the column-2. +% The marginal note given in the first line goes to right and does not +% conflict with that from the column-2. We are now going back to the +% column-0 by a {\rm\!\switchcolumn!|*|} with a \mctext. +% \endgroup +% +% \switchcolumn*[\subsection*{A Spanning Text: though this is wider than the +% page width, this text does not span the boundary between the left and +% right parallel-pages.}] +% +% We have come back to this column-0. The space above the \mctext{} is due +% to the \sync{}ation because two paragraphs in the column-2 are +% significantly taller in total than the paragraphs in other columns. As +% the spanning text itself says, it cannot extend to the right \parapag{}e. +% The author puts dummy lines to go to the page bottom.\\ +% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ +% \Dotfill\\ \Dotfill\par +% +% Now we will have a page break shortly. You \Emph{will not} be surprised +% by seeing this column \Emph{is still in the left \parapag{}e after the +% break.} This is because the feature |c| is \Emph{not effective in +% \npaired{} \parapag{}ing.} The other feature |p| \Emph{consistently makes +% the left outside margins of this and the previous page in which this +% column resides} wider than the right inside margins. +% \label{page:ppts-npaired2} +% +% \switchcolumn +% \begingroup\it +% We have restarted this column-1. This paragraph has a +% footnote\footnotemark*[-1] as shown below.\\ +% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ +% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\par +% +% After the page break below, this column also \Emph{stays in the left page} +% together with the column-0 +% \Marginpar{\it Another marginal note from column-1.} +% and is placed \Emph{inside (right)} in the page, as well as the marginal +% note in this \Emph{left} page \Emph{still} in the outside margin. +% \par\endgroup +% +% \switchcolumn +% \begingroup\sf +% We have a few other materials not shown in right \parapag{}es. The space +% above this paragraph is for the \mctext{} placed in the left \parapag{}e. +% The \Scfnote{} given here\footnotemark{} is also not in this page but in +% the left. Finally, the author has put a page-wise figure spanning columns +% just before \!\switchcolumn! by which we left this column, but it will be +% in the \Emph{left} page \Emph{\pageref{page:ppts-npaired2}} together with +% column-0 and 1.\\ +% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\par +% +% Though the footnote numbered \Emph{\ref{fn:ppts-npaired2}} goes to the +% left page, its space and that of \Emph{\ref{fn:ppts-npaired1}} make this +% and the next columns shorter in the previous page. Similarly, we have a +% space above for the page-wise figure shown in the \Emph{left} page. +% \par\endgroup +% +% \switchcolumn +% \begingroup\sl +% As expected, this line is aligned to the first line of the paragraph in +% the column-2 as well as those in column-0 and 1. It is also consistent +% the first lines including that of this paragraph are not indented because +% the \mctext{} is given by {\rm\!\subsection!|*|} which makes first +% paragraphs unindented.\\ +% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ +% \Dotfill\\ \Dotfill\par +% +% After the page break we will have shortly, this column \Emph{is kept being +% the rightmost in the right \parapag{}e}, as you are seeing now, +% \Marginpar{\sl Another marginal note from column-3.} +% \Emph{and} still outermost as well as the marginal note in the outside +% \Emph{right} margin. +% \endgroup +% \end{paracol} +% \Hrule +% +% As the \postenv{} in Section~\ref{sec:ppts-paired} is, this paragraph +% being the \postenv{} of the \npaired{} \parapag{}es appears only in the +% \parapag{}e in which the column-0 belongs to, and thus in the left +% \parapag{}e in this case. +% \endinput -- cgit v1.2.3