summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/paracol/ppts.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/paracol/ppts.dtx')
-rw-r--r--macros/latex/contrib/paracol/ppts.dtx472
1 files changed, 472 insertions, 0 deletions
diff --git a/macros/latex/contrib/paracol/ppts.dtx b/macros/latex/contrib/paracol/ppts.dtx
new file mode 100644
index 0000000000..cc7847db7c
--- /dev/null
+++ b/macros/latex/contrib/paracol/ppts.dtx
@@ -0,0 +1,472 @@
+% \def\oddeven#1#2{\ifodd\value{page}#1\else#2\fi}
+% \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 \oddeven{left}{right}, or in
+% other word inside, margin of this \oddeven{odd}{even}-numbered page is
+% narrower than that of the previous pages because the author reduced the
+% effective \oddeven{left}{right} side margin being calculated from
+% \oddeven{\cs{oddsidemargin}}{\cs{evesidemargin}}
+% 
+% \SpecialIndex{\oddsidemargin}
+% \SpecialIndex{\evensidemargin}
+% 
+% 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 \oddeven{right}{left} side or outside margin of
+% this page enlarged by 125\,\%, as well as the \oddeven{left}{right} side
+% and outside margin of the next \oddeven{even}{odd}-numbered page specified
+% by \oddeven{\cs{evensidemargin}}{\cs{oddsidemargin}}.
+%
+% 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 (\oddeven{left}{right} ones in \oddeven{odd}{even}-numbered pages)
+% are wider than the \emph{outside} ones and all marginal notes go to
+% outside (\oddeven{right}{left} in \oddeven{odd}{even}-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\par
+%
+% This is the third paragraph of the inside column-0 having a page break in
+% it. Since shortly we will be in an \oddeven{even}{odd}-numbered page
+% \pageref{page:ppts2} (now), this wider column\Marginpar{Third marginal
+% note from column-0} is now \oddeven{right}{left} one keeping it
+% inside, while the marginal note given in the first line of this page goes
+% to \oddeven{left}{right} 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\par
+%
+% This is the third paragraph of the outside column-1, which becomes
+% \oddeven{left}{right} 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.
+%
+% \ifodd\value{page}
+% We will see a few examples of \parapag{}ing shortly, but before that we
+% will have an intentional black page to make the first page of the example
+% odd-numbered to avoid you have an impression that its layout is
+% incorrect\footnote{
+% 
+% At least the author himself had such impression without the blank page.}
+% 
+% because if it were in an even page you would see the {\em outside\/} third
+% and fourth supplementary {\em columns\/} at first.
+% 
+% \newpage\vspace*{\fill}\centerline{(intentionally blanked page)}\vfill
+% 
+% \else
+% From the next page, we will see a few examples of \parapag{}ing.
+% \fi
+%
+%
+%
+% \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