From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 2 Sep 2019 13:46:59 +0900 Subject: Initial commit --- macros/latex/contrib/paracol/man.dtx | 863 +++++++++++++++++++++++++++++++++++ 1 file changed, 863 insertions(+) create mode 100644 macros/latex/contrib/paracol/man.dtx (limited to 'macros/latex/contrib/paracol/man.dtx') diff --git a/macros/latex/contrib/paracol/man.dtx b/macros/latex/contrib/paracol/man.dtx new file mode 100644 index 0000000000..f604ba24fa --- /dev/null +++ b/macros/latex/contrib/paracol/man.dtx @@ -0,0 +1,863 @@ +% \begingroup +% \hbadness9000 \hfuzz6pt +% +% \begin{paracol}{2}[\section{Introduction}] +% This document describes the usage of yet another multi-column package named +% \textsf{paracol}. The unique feature of the package is that columns are +% typeset {\em in parallel.} +% +% Suppose you are writing a bilingual document whose left column is written in +% a language, say English, and right column has the translation of the left +% column in another language, e.g., Japanese. With the \textsf{paracol} +% package you may write an English part of arbitrarily length and then {\em +% switch} to its Japanese counterpart to place both parts side by side. Of +% course you may return to the English writing similarly. +% +% The {\em\Uidx\cswitch} is always allowed when you complete an outermost +% level paragraph. You may be unaware whether a column is broken into +% multiple pages before switching because the package automatically goes +% back and forward to the correct page and vertical position when you switch +% the column. Moreover, you may {\em\Uidx\sync{}e} columns so that the tops +% of the first paragraphs after switching in all columns are vertically +% aligned. At a \sync{}ation point, you may give a single-column text, +% for example a common section header, optionally. You may also switch +% single-column and multi-column in a page arbitrary. +% +% This manual itself is an example of two-column documents typeset by +% \textsf{paracol}. Since the author is not familiar with languages other +% than English and Japanese and the latter should be hardly understood by +% most of readers, the right column is the translation of the left English +% column into a computational language. That is, the right column is the +% \LaTeX{} source code of the left column\footnote{ +%  +% Not really but its essence +% is shown.\label{fn:first}}. +% +% \switchcolumn +%\begin{Verbatim} +%\begin{paracol}{2}[\section{Introduction}] +%\hbadness5000 +%This document describes the usage of yet +%another multi-column package named +%\textsf{paracol}. The unique feature of +%the package is that columns are typeset +%{\em in parallel.} +% +%Suppose you are writing a bilingual +%document whose left column is written in a +%language, say English, and right column has +%the translation of the left column in +%another language, e.g. Japanese. With the +%\textsf{paracol} package you may write an +%English part of arbitrary length and then +%{\em switch} to its Japanese counterpart to +%place both parts side by side. Of course +%you may return to the English writing +%similarly. +% +%The column switching is always allowed when +%you complete an outermost level paragraph. +%You may be unaware whether a column is +%broken into multiple pages before switching +%because the package automatically goes back +%and forward to the correct page and +%vertical position when you switch the +%column. Moreover, you may {\em +%synchronize} columns so that the tops of +%the first paragraphs after switching in all +%columns are vertically aligned. At a +%synchronization point, you may give a +%single-column text, for example a common +%section header, optionally. You may also +%switch single-column and multi-column in a +%page arbitrary. +% +%This manual itself is an example of +%two-column documents typeset by +%\textsf{paracol}. Since the author is not +%familiar with languages other than English +%and Japanese and the latter should be +%hardly understood by most of readers, the +%right column is the translation of the left +%English column into a computational +%language. That is, the right column is the +%\LaTeX{} source code of the left column% +%\footnote{Not really but its essence is +%shown.}. +% +%\switchcolumn +% \end{Verbatim} +% |\begin{verbatim}|\\ +% {\it Here is the source of above.}\\ +% |\end{verbatim}|\footnote{ +% This \texttt{verbatim} construct is simply referred as to +% ``\textit{source}'' hereafter.} +% +% +% +% \switchcolumn*[\section{Basic Usage}] +% Loading the package is very simple. What you have to do is +% \!\usepackage!|{|\Uidx{\env{paracol}}|}| in the preamble. Note that +% \textsf{paracol} can be used with \LaTeXe{} and does not work with +% \LaTeX{} 2.09. +% +% \switchcolumn +% +%\begin{Verbatim} +%\switchcolumn*[\section{Basic Usage}] +%Loading the package is very simple. What +%you have to do is |\usepackage{paracol}| +%\end{Verbatim} +% |in the preamble. ...|\footnote{ +% Hereafter, a part of the source code may be omitted like this.}\\ +% |\switchcolumn|\\ +% \textit{source} +% +% \switchcolumn* +% The fundamental means of parallel-column typesetting are the environment +% \env{paracol} and the command \Uidx{\!\switchcolumn!}. The \env{paracol} +% environment needs an argument to specify the number of columns. Thus the +% following is the basic construct for two-parallel-column documents. +% \begin{quote} +% \!\begin!|{|\env{paracol}|}{2}|\\ +% \textit{left column text}\\ +% \!\switchcolumn!\\ +% \textit{right column text}\\ +% \!\switchcolumn!\\ +% \textit{left column text}\\ +% \!\switchcolumn!\\ +% \textit{right column text}\\ +% \!\switchcolumn!\\ +% \mbox{\hspace{4em}}$\vdots$\\ +% \!\end!|{|\env{paracol}|}| +% \end{quote} +% +% \switchcolumn +%\begin{Verbatim} +%\switchcolumn* +%The fundamental means of parallel-column +%typesetting are the environment |paracol| +%and the command |\switchcolumn|. ... +%\switchcolumn +%\end{Verbatim} +% \textit{source} +% +% \switchcolumn[1]* +%\begin{Verbatim} +%\switchcolumn[1]* +%\end{Verbatim} +% \textit{source} +%\begin{Verbatim} +%\switchcolumn[0] +%The |\switchcolumn| command may have an +%optional argument to specify the column +%number (zero origin) to start. ... +%\end{Verbatim} +% +% \switchcolumn[0] +% The \!\switchcolumn! command may have an optional argument to specify the +% column number (zero origin) to start. That is, \!\switchcolumn!|[0]| +% means to switch to the leftmost column, |\switchcolumn[1]| is to start the +% second column and so on. Thus the |\switchcolumn| without the optional +% argument may be considered as \!\switchcolumn!|[|$i+1\bmod{n}$|]| where +% $i$ is the ordinal of the column you are leaving from and $n$ is the +% number of columns given to \env{paracol} environment. +% +% +% +% \switchcolumn[0]*[\section{Column Synchronization}\label{sec:sync}] +% The \!\switchcolumn! command may also be followed by a `|*|' to +% {\em\Uidx\sync{}e} columns. After you switch from a column to another by +% \!\switchcolumn!|*| (or \!\switchcolumn!|[|$i$|]*|), all the columns are +% vertically aligned at the bottom of the {\em deepest} one preceding the +% command. For example, the previous section has three \!\switchcolumn!|*| +% commands at which left and right columns are vertically aligned. +% +% The {\em starred} version of \!\switchcolumn! may have an optional +% argument to specify a single-column {\em\Uidx\mctext} whose bottom is the +% vertical alignment point of columns. For example, \!\section! +% commands in this manual are given as optional arguments +% of \!\switchcolumn!|*| like; +%\begin{Verbatim} +% \switchcolumn*[\section{Basic Usage}] +%\end{Verbatim} +% The \env{paracol} environment may also start with a \mctext{} by +% specifying it as the optional argument of \!\begin!|{|\env{paracol}|}|. +% For example, at the beginning of this document, the author put; +%\begin{Verbatim} +% \begin{paracol}{2}[\section{Introduction}] +%\end{Verbatim} +% +% \switchcolumn +%\begin{Verbatim} +%\switchcolumn[0]*[% +% \section{Column Synchronization} +% \label{sec:sync}] +%The |\switchcolumn| command may also be +%followed by a `|*|' to {\em synchronize} +%columns. ... +% +%The {\em starred} version of +%|\switchcolumn| may have an optional +%argument to specify a multi-column text +%whose bottom is the vertical alignment +%points of the columns. ... +%\switchcolumn +%\end{Verbatim} +% \textit{source} +% +% +% +% \begin{column*}[\section{Environments for Columns}\label{sec:env}] +% \Uidx{\Index{column-switching environment}} +% \subsection{Environment \texttt{column}} +% The \!\switchcolumn! is simple but you may prefer to pack the contents of a +% column in an environment. The \Uidx{\env{column}} environment is +% available for this well-structuralization of \LaTeX{} sources for +% parallel-columned documents. A construct; +% \begin{quote} +% \!\begin!|{|\env{column}|}|\\ +% \textit{text for a column}\\ +% \!\end!|{|\env{column}|}| +% \end{quote} +% is (almost) equivalent to; +% \begin{quote} +% \!\switchcolumn!\\ +% \textit{text for a column} +% \end{quote} +% The \Uidx{\env{column*}} environment is also available for the column +% \sync{}ation and may have an optional argument for \mctext. +% \end{column*} +% +% \begin{column} +% \subsection{\ttfamily Environment column} +%\begin{Verbatim} +%\begin{column*}[% +% \section{Environments for Columns} +% \label{sec:env}] +%\subsection{Environment \texttt{column}} +%The |\switchcolumn| is simple but you may +%prefer to pack the contents of a column in +%an environment. ... +%\end{column*} +%\begin{column} +%\end{Verbatim} +% \textit{source}\\ +% |\end{column}| +% \end{column} +% +% \begin{nthcolumn*}{1} +% \subsection{\ttfamily Environment nthcolumn} +%\begin{Verbatim} +%\begin{nthcolumn*}{1} +%\end{Verbatim} +% \textit{source} +%\begin{Verbatim} +%\end{nthcolumn*} +% +%\begin{nthcolumn}{0} +%\subsection{Environment \texttt{nthcolumn}} +%The |\switchcolumn| can start an +%arbitrarily specified column with the +%column number given through its optional +%argument, but the |column| environment +%cannot do it. ... +%\end{nthcolumn} +%\end{Verbatim} +% \end{nthcolumn*} +% \begin{nthcolumn}{0} +% \subsection{Environment \texttt{nthcolumn}} +% The \!\switchcolumn! can start an arbitrarily specified column with the +% column number given through its optional argument, but the \env{column} +% environment cannot do it. If you want to start $i$-th column, you have to +% do \!\begin!|{|\Uidx{\env{nthcolumn}}|}{|$i$|}| (or +% \Uidx{\env{nthcolumn*}} with an optional argument to \sync{}e). +% \end{nthcolumn} +% +% +% +% \begin{leftcolumn*} +% \subsection[Environments \texttt{leftcolumn} and \texttt{rightcolumn}] +% {Environments \texttt{leftcolumn} and\\\texttt{rightcolumn}} +% The environments \Uidx{\env{leftcolumn}} and \Uidx{\env{rightcolumn}} (and +% their starred versions with an optional argument) are available as more +% convenient means than saying \!\begin!|{|\env{nthcolumn}|}{0}| to switch +% to the left(most) column and +% \!\begin!|{|\env{nthcolumn}|}{1}| to the right (but may not be rightmost) +% one. +%  +% \Uidx{\EnvIndex{leftcolumn*}}\Uidx{\EnvIndex{rightcolumn*}} +% +% \begin{figure*}\nosv +% \def\arraystretch{0.8} +% \centerline{\begin{tabular}[b]{|c|}\hline +% \hbox to.9\textwidth{}\\ +% double-column figure \#1\\ +% \\\hline +% \end{tabular}} +% \caption{A Double-Column Figure} +% \end{figure*} +% \begin{figure}[t]\nosv +% \def\arraystretch{0.8} +% \centerline{\begin{tabular}[b]{|c|}\hline +% \hbox to.9\columnwidth{}\\\\ +% single-column figure \#1\\ +% \\\\\hline +% \end{tabular}} +% \caption{A Single-Column Figure} +% \end{figure} +% \end{leftcolumn*} +% +% \begin{rightcolumn} +% \subsection{\ttfamily Environment leftcolumn and\\rightcolumn} +%\begin{Verbatim} +%\begin{leftcolumn*} +%\subsection{% +% Environments \texttt{leftcolumn} and\\ +% \texttt{rightcolumn}} +%The environments |leftcolumn| and +%|rightcolumn| (and their starred versions +%with an optional argument) are available as +%more convenient means than saying +%|\begin{nthcolumn}{0}| to switch to the +%left(most) column and ... +%\begin{figure*}...\end{figure*} +%\begin{figure}[t]...\end{figure} +%\end{leftcolumn*} +%\begin{rightcolumn} +%\end{Verbatim} +% \textit{source and a \texttt{figure} env}\\ +% |\end{rightcolumn}| +% \begin{figure}[t]\nosv +% \def\arraystretch{0.8} +% \centerline{\begin{tabular}[b]{|c|}\hline +% \hbox to.9\columnwidth{}\\ +% \ttfamily single-column figure \#2\\ +% \\\hline +% \end{tabular}} +% \caption{\ttfamily Another Single-Column Figure} +% \end{figure} +% \end{rightcolumn} +% +% +% +% \begin{leftcolumn*}[\section{Floats, Footnotes and Counters} +% \label{sec:float}] +% \changes{v1.2-7}{2013/05/11} +% {Remove \cs{nosv} from verbatim example of Table~1 shown in the right +% column.} +% \changes{v1.32-3}{2015/10/10} +% {Add footnote to mention the page-wise float problem.} +% \begin{table}[b]\nosv +% \caption{A Single-Column Table} +% \centerline{\begin{tabular}[t]{|l|c|r|}\hline +% An&example&of\\\hline +% single&column&table\\\hline +% \end{tabular}} +% \end{table} +% \subsection{Figures and Tables} +% As shown in this page, double-column figures\slash tables (or those +% spanned multiple columns if you have three or more) may be placed by +% \env{figure*} and \env{table*} environments as usual\footnote{ +%  +% See Section~\ref{sec:problem} for the appearance order issue of +% double-column floats.}. +%  +% A single-column figure\slash table will be placed in the column in which +% you put \env{figure} and \env{table}. For example, the body of a +% \env{figure} environment in a \env{leftcolumn} environment is +% \emph{always} placed in a left column. That is, even if the column of the +% \emph{current} page does not have enough room to place the figure, it will +% not be thrown to the right column but will be placed in the left column of +% the next page\footnote{ +%  +% Or some farther page if \LaTeX{} cannot solve the placement problem wisely.}. +% +% Another caution about float placement is that you have to be careful when +% you try to put a top-float explicitly with |t|-option or implicitly without +% placement option (i.e., |tbp| in most classes) and to \sync{}e columns. +% The rule is as follows; after you \sync{}e columns in a page, the page +% cannot have top-floats any more. When you \sync{}e columns, +% \textsf{paracol} fixes a virtual horizontal line in the page as the +% \sync{}ation barrier. Thus no top-floats cannot be added above the +% line\footnote{ +%  +% Even if you have enough space above, sorry.}. +%  +% Therefore, the author put two \env{figure} environments for the figures +% shown in this page into the \env{leftcolumn*} and \env{rightcolumn} +% environment for the previous section. +% +% \subsection{Footnotes and Marginal Notes} +% \changes{v1.2-2}{2013/05/11} +% {Add a footnote mentioning page-wise footnotes.} +% +% Footnotes are also put at the bottom of the column in which \!\footnote! +% commands and their references reside (like this\footnote{ +%  +% Unless you specify to make footnotes {\em page-wise} as explained in +% Section \ref{sec:ref-scfnote} and \ref{sec:fnnp}.}), +%  +% as shown in page~\pageref{fn:first} and this page. Marginal +% notes behave similarly like what you are seeing in the left margin of this +% sentence\marginpar{ +%  +% \raggedright An example of marginal note.} +%  +% and the right marginal note in this page\footnote{ +%  +% If you have three or more columns, marginal notes of the second or +% succeeding columns are placed in the right margin in default setting. The +% \textsf{paracol} package solves the placement problem of marginal notes +% from two or more columns sharing a side margin by moving some of them down +% if they conflict over the space with each other.}. +% +% \subsection{Local and Global Counters} +% \UsageIndex{local counter} +% \UsageIndex{global counter} +%  +% You probably found that the numbering of figures and tables is \emph{global} +% while that of footnotes are \emph{local}. That is, the figure in the right +% column of the previous page has number~3 following its left-column +% counterpart Figure~2. The tables in the page are also numbered as 1 and 2 +% crossing the column boundary. However, the footnotes in each column have +% their own numbering sequence. Moreover, the footnote numbers in left +% columns are typeset in roman font while those in right columns have italic +% shapes. Similarly, subsection numbering is local and the headings in right +% columns have typewriter-face numbers. +% +% This happens because the author declared the counters \counter{figure} and +% \counter{table} are \emph{global} in the preamble of this document by +% saying; +% \begin{itemize}\item[] +% \Uidx{\!\globalcounter!}|{figure}|\\ +% \!\globalcounter!|{table}| +% \end{itemize} +% and do nothing about \counter{footnote} and \counter{subsection} counters. +% By default, all the counters except for |page| are local to columns. The +% value of a \lcounter{} of a column is saved somewhere when you leave the +% column, and it is restored when you revisit the column. The initial values +% of the \lcounter{}s are the values they have at +% \!\begin!|{|\env{paracol}|}|. After you close the \env{paracol} +% environment, the values of the leftmost column are used for the rest of +% your document until you start new \env{paracol} environment. On a +% restart, \lcounter{}s in a column have the values they had at the last +% \Endparacol, except for those which have been modified outside the +% environment because the modifications are \emph{broadcasted} to +% \lcounter{}s in all columns. You will see the effect of this +% inter-environment counter value conservation in the footnote numbers in +% the right column in page~\pageref{fn:right3} and \pageref{fn:right4}. +% +% This broadcasting of a \lcounter{} value can be done explicitly in +% \env{paracol} environments by a command $\Uidx{\!\synccounter!}\Arg{ctr}$. +% This command makes $\mathit{ctr}$ in all columns have the value of that in +% the column in which the command appears. In addition, another command +% \Uidx{\!\syncallcounters!} performs this broadcasting for all \lcounter{}s. +% +% If you make a counter global by the command \!\globalcounter!, the +% save/restore operations are not performed to the counter and thus it is +% globally incremented by |\[ref]|\AB|stepcounter| +%  +% \SpecialIndex{\refstepcounter}\SpecialIndex{\stepcounter} +%  +% or commands such as \!\caption! and \!\section!. Note that the value of a +% \gcounter{} depends on the place where it is incremented (or set) in +% the \emph{source code} rather than where it appears in the output. Thus +% if the author put a \env{table} environment here to increment \env{table} +% counter, the right-column table at the bottom of page~\pageref{tab:right} +% would be Table~3 because its \env{table} environment does not appear yet +% in the source code. Note that, however, though the counter \counter{page} +% is global as expected, its numbering is consistent among all columns as +% far as you refer to the value by $\!\pageref!\Arg{label}$ and/or see the +% values in table of contents, etc. +% +% Another counter which the author made global in this document is +% \counter{section}. As explained in Section~\ref{sec:sync}, an optional +% \mctext{} of \cswitch{} is considered as in the leftmost column. Since +% \!\section! commands in this document are always given in \mctext{}s, so +% far, it seems unnecessary to make \counter{section} global because it is +% incremented correctly in the leftmost column. However, the stepping +% \counter{section} has a side effect to reset its descendent counter +% \counter{subsection} and referred to from \!\thesubsection! command. Thus +% if \counter{section} were local, the right-column subsections in +% Section~\ref{sec:env} would be numbered as ``0.1'', ``0.2'' and ``0.3'' +% because the local value of \counter{section} would be zero. Moreover, the +% right-column subsections of this section would be ``0.4'', ``0.5'' and +% ``0.6'' because stepping \counter{section} local to the left column would +% not reset \counter{subsection} local to the right column. +% +% You may give a local appearance to a counter \textit{ctr} for the $i$-th +% column (zero origin) by a command; +% \begin{itemize}\item[] +% \Uidx{\!\definethecounter!}|{|\textit{ctr}|}{|$i$|}{|\textit{def}|}| +% \end{itemize} +% where \textit{def} is to be the body of the local definition of +% |\the|\textit{ctr}. For example, the preamble of this document has the +% following to give non-default defitions to \!\thefootnote! and +% \!\thesubsection! for right columns. +%  +%\begin{Verbatim} +% \definethecounter{footnote}{1}{% +% \textit{\arabic{footnote}}} +% \definethecounter{subsection}{1}{% +% \texttt{% +% \arabic{section}.\arabic{subsection}}} +%\end{Verbatim} +%\end{leftcolumn*} +% +% \begin{rightcolumn} +% \begin{table}[b]\nosv +% \caption{\ttfamily Another Single-Column Table} +% \label{tab:right} +% \centerline{\ttfamily \begin{tabular}[t]{|l|r|}\hline +% Another&example\\\hline +% of&single\\\hline +% column&table\\\hline +% \end{tabular}} +% \end{table} +% \subsection{\ttfamily Figures and Tables} +%\begin{Verbatim} +%\begin{leftcolumn*}[\section{% +% Floats, Footnotes and Counters}] +%\begin{table}[b] +%\caption{A Single-Column Table} +%\centerline{\begin{tabular}[t]{|l|c|r|} +% \hline +% An&example&of\\\hline +% single&column&table\\\hline +% \end{tabular}} +%\end{table} +%\subsection{Figures and Tables} +%As shown in this page, double-column +%figures\slash tables (or those spanned +%multiple columns if you have three or more +%columns) may be placed by |figure*| and +%\end{Verbatim} +% {\ttfamily |table*| environments as usual\footnote{Another example +% of footnote.\label{fn:right3}}. ...} +% +% \subsection{\ttfamily Footnotes and Marginal Notes} +%\begin{Verbatim} +%Footnotes are also put at the bottom of the +%column in which |\footnote| commands and +%their references reside (like +%this\footnote{...}), as shown in page~2 and +%this page. Marginal notes behave similarly +%like what you are seeing in the left margin +%of this sentense\marginpar{\raggedright +%An example of marginal note.} and the right +%marginal note in this +%\end{Verbatim} +% |page\footnote{...}. ...| +% \marginpar{\raggedright\ttfamily +% Another example of marginal note.} +% +% \begin{figure}[t]\nosv +% \centerline{\begin{tabular}[b]{|c|}\hline +% \hbox to.9\columnwidth{}\\\\\\\\ +% \ttfamily another figure with [t] option\\ +% \ttfamily to fill space +% \\\\\\\\\hline +% \end{tabular}} +% \caption{\ttfamily +% Another Figure with [t] Option} +% \end{figure} +% +% \begin{figure}[b]\nosv +% \centerline{\begin{tabular}[b]{|c|}\hline +% \hbox to.9\columnwidth{}\\ +% \ttfamily a figure with [b] option\\ +% \ttfamily to fill space\\ +% \\\hline +% \end{tabular}} +% \caption{\ttfamily +% A Figure with [b] Option} +% \end{figure} +% +% \subsection{\ttfamily Local and Global Counters} +%\begin{Verbatim} +%You probably found that the numbering of +%figures and tables is \emph{global} while +%that of footnotes are \emph{local}. ... +%\end{leftcolumn*} +%\begin{rightcolumn} +%\end{Verbatim} +% \textit{source}.\\ +% |\end{rightcolumn}| +% +% \begin{figure}[p]\nosv +% \centerline{\begin{tabular}[b]{|c|}\hline +% \hbox to.9\columnwidth{}\\\\\\\\ +% \ttfamily a figure with [p] option\\ +% \ttfamily to fill space +% \\\\\\\\\hline +% \end{tabular}} +% \caption{\ttfamily +% A Figure with [p] Option} +% \end{figure} +% +% \begin{figure}[p]\nosv +% \centerline{\begin{tabular}[b]{|c|}\hline +% \hbox to.9\columnwidth{}\\\\\\\\ +% \ttfamily another figure with [p] option\\ +% \ttfamily to fill space +% \\\\\\\\\hline +% \end{tabular}} +% \caption{\ttfamily +% Another Figure with [p] Option} +% \end{figure} +% +% \begin{figure}[p]\nosv +% \centerline{\begin{tabular}[b]{|c|}\hline +% \hbox to.9\columnwidth{}\\\\\\\\ +% \ttfamily yet another figure with [p]\\ +% \ttfamily option to fill space +% \\\\\\\\\hline +% \end{tabular}} +% \caption{\ttfamily +% Yet Another Figure with [p] Option} +% \end{figure} +% +% \begin{figure}[p]\nosv +% \centerline{\begin{tabular}[b]{|c|}\hline +% \hbox to.9\columnwidth{}\\\\\\\\ +% \ttfamily fourth figure with [p]\\ +% \ttfamily option to fill space +% \\\\\\\\\hline +% \end{tabular}} +% \caption{\ttfamily +% Forth Figure with [p] Option} +% \end{figure} +% +% \begin{figure}[t]\nosv +% \centerline{\begin{tabular}[b]{|c|}\hline +% \hbox to.9\columnwidth{}\\\\\\ +% \ttfamily yet another figure with [t]\\ +% \ttfamily option to fill space +% \\\\\\\hline +% \end{tabular}} +% \caption{\ttfamily +% Yet Another Figure with [t] Option} +% \end{figure} +% \end{rightcolumn} +% \switchcolumn* +% \flushpage +% \end{paracol} +% +% +% +% \section{Closing \texttt{paracol} Environment and Page Flushing} +% \label{sec:man-close} +% The final example shown here is this single-column text which the author put +% after the \env{paracol} environment above is closed. As you are seeing, a +% \env{paracol} environment can be finished at any vertical position in a +% page and can be followed by ordinary single column texts. +% +% \begin{paracol}{2} +% \begin{leftcolumn} +% The environment may also be restarted anywhere you like as shown here. +% +% The last issue is to flush a page. The ordinary \!\newpage! command works +% as you expect. If you say \!\newpage! in the left column in a page, the +% contents following it will appear in the left column in the next page. Note +% that this does not affect the layout of the right column. +% +% To flush all columns in a page, a command \Uidx{\!\flushpage!} is +% available. This command in $i$-th column is almost equivalent to; +% \begin{itemize}\item[] +% \!\switchcolumn!|[|$i$|]*[|\!\newpage!|]| +% \end{itemize} +% but more robust\footnotemark\label{fn:flush}. +% The ordinary page breaking command \Uidx{\!\clearpage!} may also be used +% to flush all columns and to start a fresh page, but it has a side effect +% to put all figures and tables which are not yet output. +% \end{leftcolumn} +% +% \begin{rightcolumn} +%\begin{Verbatim} +%\begin{paracol}{2} +%\begin{leftcolumn} +%The environment may also be restarted +%anywhere you like as shown here. ... +%\end{leftcolumn} +%\begin{rightcolumn} +%\end{Verbatim} +% \textit{source}\\ +% |\end{rightcolumn}|\\ +% |\end{paracol}|\\ +% |Now the aurthor will do ...| +% \end{rightcolumn} +% \end{paracol} +% +% \changes{v1.1}{2012/05/11} +% {Add \cs{columnratio}\texttt{\char`\{0.6\char`\}} and a phrase +% for it.} +% Now the author will do |\flushpage| shortly to start a real binlingual +% example from the next page, after showing another example of closing +% \env{paracol} environments in this sentence and of restarting in the next +% one, in which {\em unbalanced column width} is demonstrated using +% \Uidx{\!\columnratio!} command shown in Section~\ref{sec:ref-colwidth}. +% +% \columnratio{0.6} +% \begin{paracol}{2} +% \begin{leftcolumn} +% O.K., we have restarted \env{paracol} environment and we will see the +% effect of \!\flushpage! now!!\footnotetext{ +%  +% For example \texttt{\string\switchcolumn*} may flush a page for the +% \sync{}ation and thus \texttt{\string\newpage} may leave an empty page.} +%  +% \end{leftcolumn} +% \begin{rightcolumn} +%\begin{Verbatim} +%\columnratio{0.6} +%\begin{paracol}{2} +%\begin{leftcolumn} +%O.K., ... +%\end{leftcolumn} +%\end{Verbatim} +% |\begin{rightcolumn}| \textit{source}\\ +% |\end{rightcolumn}| +% \flushpage +% \end{rightcolumn} +% +% +% +% \changes{v1.2-7}{2013/05/11} +% {Correct a few words in German and English libretti.} +% \newenvironment{Gverse}{\ensurevspace{2\baselineskip}\begin{leftcolumn*} +% \begin{myverse}} +% {\end{myverse}\end{leftcolumn*}} +% \newenvironment{Everse}{\begin{rightcolumn}\begin{myverse}} +% {\end{myverse}\end{rightcolumn}} +% \makeatletter +% \newenvironment{myverse}{\leftmargini0pt\partopsep0pt\verse}{\endverse} +% +% \begin{leftcolumn*}[ +% \centerline{\Large An Die Freude/To Joy}\label{page:bfreude}\smallskip +% \centerline{\large Friedrich Schiller}\smallskip +% The following is the libretto of the fourth movement of Beethoven's Ninth +% Symphony, his adaptation of Schiller's ode ``An Die Freude'' (or ``To Joy'' in +% English). Beethoven's additions and revisions are indicated in italics.] +% \end{leftcolumn*} +% \begin{Gverse} +% \itshape O Freunde, nicht diese T\"one! \\ +% Sondern la{\ss}t uns angenehmere anstimmen und freu\-denvollere +% \footnote{If I had been a good student in my German class, I could find +% the German translation of the right column footnote \ref{fn:right4} is +% ``Dieser Teil wurde van Beethoven hinzugef\"ugt'' by myself without +% the kind help from a user.}. +% \end{Gverse} +% \begin{Everse} +% \itshape Oh friends, no more of these sad tones!\\ +% Let us rather raise our voices together\\ +% In more pleasant and joyful tones +% \footnote{This part was added by Beethoven.\label{fn:right4}}. +% \end{Everse} +% \begin{Gverse} +% Freude!\\ +% Freude, sch\"oner G\"otterfunken +% Tochter aus Elysium,\\ +% Wir betreten feuertrunken, +% Himmlische, dein Heiligtum!\\ +% Deine Zauber binden wieder, +% {\itshape Was die Mode streng geteilt;\\ +% Alle Menschen werden Br\"uder\footnote{ +% Original: Was der Mode Schwert geteilt;\\ +% Bettler werden F\"urstenbr\"uder,},} +% Wo dein sanfter Fl\"u\-gel weilt +% \end{Gverse} +% \begin{Everse} +% Joy! \\ +% Joy, thou shining spark of God,\\ +% Daughter of Elysium,\\ +% With fiery rapture, goddess,\\ +% We approach thy shrine.\\ +% Your magic reunites\\ +% {\itshape That which stern custom has parted;\\ +% All humans will become brothers\footnote{ +% Original: +% What custom's sword has parted;\\ +% Beggars become princes' brothers}}\\ +% Under your protective wing. +% \end{Everse} +% \begin{Gverse} +% Wem der gro{\ss}e Wurf gelungen, +% eines Freundes Freund zu sein;\\ +% Wer ein holdes Weib errungen, +% mische seinen Jubel ein!\\ +% Ja, wer auch nur eine Seele +% sein nennt auf dem Erdenrund!\\ +% Und wer's nie gekonnt, der stehle +% weinend sich aus diesem Bund! +% \end{Gverse} +% \begin{Everse} +% Let the man who has had the fortune\\ +% To be a helper to his friend,\\ +% And the man who has won a noble woman,\\ +% Join in our chorus of jubilation!\\ +% Yes, even if he holds but one soul\\ +% As his own in all the world!\\ +% But let the man who knows nothing of this\\ +% Steal away alone and in sorrow. +% \end{Everse} +% \begin{Gverse} +% Freude trinken alle Wesen +% an den Br\"usten der Natur;\\ +% Alle Guten, alle B\"osen +% folgen ihrer Rosenspur.\\ +% K\"usse gab sie uns und Reben, +% einen Freund, gepr\"uft im Tod;\\ +% Wollust ward dem Wurm gegeben, +% und der Cherub steht vor Gott. +% \end{Gverse} +% \begin{Everse} +% All the world's creatures drink\\ +% From the breasts of nature;\\ +% Both the good and the evil\\ +% Follow her trail of roses.\\ +% She gave us kisses and wine\\ +% And a friend loyal unto death;\\ +% She gave the joy of life to the lowliest,\\ +% And to the angels who dwell with God. +% \end{Everse} +% \begin{Gverse} +% Froh, wie seine Sonnen fliegen +% durch des Himmels pr\"acht'gen Plan,\\ +% Laufet, Br\"uder, eure Bahn, +% freudig, wie ein Held zum Siegen. +% \end{Gverse} +% \begin{Everse} +% Joyous, as his suns speed\\ +% Through the glorious order of Heaven,\\ +% Hasten, brothers, on your way,\\ +% Joyful as a hero to victory. +% \end{Everse} +% \begin{Gverse} +% Seid umschlungen, Millionen! +% Diesen Ku{\ss} der ganzen Welt!\\ +% Br\"uder, \"uber'm Sternenzelt +% mu{\ss} ein lieber Vater woh\-nen. +% \end{Gverse} +% \begin{Everse} +% Be embraced, all ye millions!\\ +% With a kiss for all the world!\\ +% Brothers, beyond the stars\\ +% Surely dwells a loving Father. +% \end{Everse} +% \begin{Gverse} +% Ihr st\"urzt nieder, Millionen? +% Ahnest du den Sch\"opfer, Welt?\\ +% Such'ihn \"uberm Sternenzelt! +% \"Uber Sternen mu{\ss} er wohnen. +% \end{Gverse} +% \begin{Everse} +% Do you kneel before him, oh millions?\\ +% Do you sense the Creator's presence?\\ +% Seek him beyond the stars!\\ +% He must dwell beyond the stars. +% \end{Everse} +% \end{paracol} +% \label{page:efreude} +% \endgroup +\endinput -- cgit v1.2.3