summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/paracol/paracol-man.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/paracol/paracol-man.tex')
-rw-r--r--Master/texmf-dist/doc/latex/paracol/paracol-man.tex808
1 files changed, 808 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/paracol/paracol-man.tex b/Master/texmf-dist/doc/latex/paracol/paracol-man.tex
new file mode 100644
index 00000000000..f2af2d6b6f6
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/paracol/paracol-man.tex
@@ -0,0 +1,808 @@
+%234567890123456789012345678901234567890123
+\documentclass{article}
+\usepackage{paracol}
+\usepackage{newvbtm}
+
+\textwidth210mm
+\advance\textwidth-40mm \oddsidemargin20mm \advance\oddsidemargin-1in
+\columnsep10mm
+\marginparwidth20mm \advance\marginparwidth-\marginparsep
+\marginparsep.5\marginparsep
+
+\def\|{\verb|}
+
+\newverbatim{Verbatim}{\topsep0pt \partopsep0pt}{}{}{}
+
+%\def\topfraction{.9}
+%\def\bottomfraction{.9}
+%\def\textfraction{.1}
+
+% making counters global
+\globalcounter{section}
+\globalcounter{figure}
+\globalcounter{table}
+
+% giving local \theCTR definition
+\definethecounter{footnote}{1}{\textit{\arabic{footnote}}}
+\definethecounter{subsection}{1}{%
+ \texttt{\arabic{section}.\arabic{subsection}}}
+
+\let\AB\allowbreak
+
+\hyphenation{col-umn col-umns}
+
+\title{Package \textsf{paracol} User's Manual\\
+ (version 0.91)}
+\author{Hiroshi Nakashima\\(Kyoto University)}
+\date{2011/09/16}
+
+
+
+\begin{document}
+\hbadness9000 \hfuzz6pt
+\maketitle
+\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 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
+\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
+
+\begin{verbatim}
+\end{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{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
+\|paracol| and the command \|\switchcolumn|. The \|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{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{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
+last column number and $n$ is the number of columns given to \|paracol|
+environment.
+
+
+
+\switchcolumn[0]*[\section{Column Synchronization}\label{sec:sync}]
+The \|\switchcolumn| command may also be followed by a `\|*|' to {\em
+synchronize} 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 multi-column text whose bottom is the vertical alignment
+points of the columns. For example, \|\section| commands in this manual are
+given as optional arguments of\break\|\switchcolumn*| like;
+\begin{Verbatim}
+ \switchcolumn*[\section{Basic Usage}]
+\end{Verbatim}
+The \|paracol| environment may also start with a multi-column text by
+specifying it as the optional argument of \|\begin{paracol}|. For example,
+at the beginning of this document, the author put;
+\begin{Verbatim}
+ \begin{paracol}[\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}]
+\subsection{Environment \texttt{column}}
+The \|\switchcolumn| is simple but you may prefer to pack the contents of a
+column in an environment. The \|column| environment is available for this
+well-structurization of \LaTeX{} sources for parallel columned documents. A
+construct;
+\begin{quote}
+\|\begin{column}|\\
+\textit{text for a column}\\
+\|\end{column}|
+\end{quote}
+is (almost) equivalent to;
+\begin{quote}
+\|\switchcolumn|\\
+\textit{text for a column}
+\end{quote}
+The \|column*| environment is also available for the column synchronization
+and may have an optional argument for multi-column text.
+\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 \|column|
+environment cannot do it. If you want to start $i$-th column, you have to
+do \|\beign{nthcolumn}{|$i$\|}| (or \|nthcolumn*| with an optional argument
+to synchronize).
+\end{nthcolumn}
+
+
+
+\begin{leftcolumn*}
+\subsection{Environment \texttt{leftcolumn} and\\\texttt{rightcolumn}}
+The environment \|leftcolumn| and \|rightcolumn| (and their starred
+versions with an optional argument) are available as more convenient means
+than saying \|\begin{nthcolumn}{0}| and \|\begin{nthcolumn}{1}|.
+
+\begin{figure*}
+\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]
+\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{%
+ Environment \texttt{leftcolumn} and\\
+ \texttt{rightcolumn}}
+The environment \|leftcolumn| and
+\|rightcolumn| (and their starred versions
+with an optional argument) are available as
+more convenient means than saying
+\|\begin{nthcolumn}{0}| and
+\|\begin{nthcolumn}{1}|.
+\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]
+\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}]
+\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) may be placed by \|figure*| and
+\|table*| environments as usual. A single-column figure\slash table will be
+placed in the column in which you put \|figure| and \|table|. For example,
+the contents of \|figure| environment in a \|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 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 synchronize columns.
+The rule is as follows; after you synchronize columns in a page, the page
+cannot have top-floats any more. When you synchronize columns,
+\textsf{paracol} fixes a virtual horizontal line in the page as the
+synchronization 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 \|figure| environments for the figures shown
+in the previous page into the \|leftcolumn*| and \|rigtcolumn| environment
+for the previous section.
+
+\subsection{Footnotes and Marginal Notes}
+Footnotes are also put at the bottom of the column in which \|\footnote|
+commands and their references (like this\footnote{%
+%
+An example of footnote.})
+%
+reside, as shown in page~2 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 just right of the column. Thus marginal notes
+of non-leftmost and non-rightmost columns will appear in the space
+separating columns rather than the margin of a page.}.
+
+\subsection{Local and Global Counters}
+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, sub-section numbering is local and the headings in right
+columns have typewriter-face numbers.
+
+This happens because the author declared the counters \|figure| and \|table|
+are \emph{global} in the preamble of this document by saying;
+\begin{itemize}\item[]%{
+\|\globalcounter{figure}|\\
+\|\globalcounter{table}|
+\end{itemize}%}
+and do nothing about \|footnote| and \|subsection| counters. By default,
+all the counters except for \|page| are local to columns. The value of a
+local counter of a column is saved somewhere when you leave the column, and
+it is restored when you revisit the column. The initial value of the
+local counters are the value they have at \|\begin{paracol}|. After you
+close the \|paracol| environment, the values of the left-most column are
+used for the rest of your document.
+
+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| or commands such as
+\|\caption| and \|\section|. Note that the value of a global counter
+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
+\|table| environment here to increment \|table| counter, the right-column
+table at the bottom of page~\pageref{tab:right} would be Table~3 because its
+\|table| environment does not appear yet in the source code.
+
+Another counter which the author made global in this documnet is
+\|section|. As explained in Section~\ref{sec:sync}, an optional
+multi-column text of column switching is considered as in the left-most
+column. Since \|\section| commands in this document are always multi-column
+texts, so far, it seems unnecessary to make \|section| global because it is
+incremented correctly in the left-most column. However, the stepping
+\|section| has a side effect to reset its decendent counter \|subsection|
+and referred from \|\thesubsection| command. Thus if \|section| were local,
+the right-column sub-sections in Section~\ref{sec:env} would be numbered as
+``0.1'', ``0.2'' and ``0.3'' because the local value of \|section| would be
+zero. Moreover, the right-column sub-sections of this section would be
+``0.4'', ``0.5'' and ``0.6'' because stepping \|section| local to
+left-columns would not reset \|subsection| local to right-columns.
+
+You may give a local appearance to a counter \textit{ctr} for the $i$-th
+column (zero origin) by a command;
+\begin{itemize}\item[]%
+ \|\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
+\|\thesubsetion| 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]
+\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.}. ...}
+
+\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 (like this\footnote{%
+An example of footnote.}) reside, 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
+\end{Verbatim}
+\|note in this page\footnote{...}. ...|%
+\marginpar{\raggedright\ttfamily
+Another example of marginal note.}
+
+\begin{figure}[h]%{
+\centerline{\begin{tabular}[b]{|c|}\hline
+ \hbox to.9\columnwidth{}\\\\
+ \ttfamily a figure with [h] option\\
+ \ttfamily to fill space\\
+ \\\\\hline
+ \end{tabular}}
+\caption{\ttfamily
+A Figure with [h] Option}
+\end{figure}%}
+
+\begin{figure}[b]%{
+\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}%}
+
+\begin{figure}[p]%{
+\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]%{
+\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]%{
+\centerline{\begin{tabular}[b]{|c|}\hline
+ \hbox to.9\columnwidth{}\\\\\\\\
+ \ttfamily yet another a figure with [p]\\
+ \ttfamily option to fill space
+ \\\\\\\\\hline
+ \end{tabular}}
+\caption{\ttfamily
+Yet Another Figure with [p] 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*}
+\end{Verbatim}
+\textit{source}.
+
+\begin{figure}[t]%{
+\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}%}
+\end{rightcolumn}
+\end{paracol}
+
+
+
+\section{Closing \texttt{paracol} Environment and Page Flushing}
+The final example shown here is this single-column text which the author put
+after \|paracol| environment is closed. As you are seeing, \|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 affects the layout of the right column.
+
+To flush all columns in a page, a command \|\flush|\AB\|page| is available.
+This command in $i$-th column is almost equivalent to;
+\begin{itemize}\item[]%{
+\|\switchcolumn[|$i$\|]*[\newpage]|
+\end{itemize}%}
+but more robust\footnote{%
+%
+For example \texttt{\string\switchcolumn*} may flush a page for the
+synchronization and thus \texttt{\string\newpage} may leave an empty page.}.
+%
+The ordinary page breaking command \|\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{leftcolumn}
+The environment may also be restarted
+anywhere you like as shown here. ...
+\end{leftcolumn}
+\end{Verbatim}
+\textit{source}
+\end{rightcolumn}
+
+\begin{leftcolumn}
+Now the aurthor will do \|\flushpage| shortly to start a real binlingual
+example from the next page. O.K., now!!\flushpage
+\end{leftcolumn}
+
+
+
+\newenvironment{Gverse}{\begin{leftcolumn*}%[\centerline{\hrulefill}]
+ \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}\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, this footnote
+would say ``This part was added by Beethoven.'' in German.}.
+\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.}.
+\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 brothere\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}
+%\flushpage
+\begin{Gverse}
+Freude trinken alle Wesen
+an den Br\"usten der Natur;\\
+Alle Guten, all 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}
+
+
+
+\section*{Acknowledgements}
+The author thanks to Yacine Daddi Addoun who gave the author the motivation
+to write the style for his bilingual document. He also thanks to Robin
+Fairbairns who kindly invited the style to CTAN after the author's lazy six
+years failing to upload the style.
+\end{document}