path: root/Master/texmf-dist/source/latex/paracol/ppts.dtx

% \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