diff options
author | Karl Berry <karl@freefriends.org> | 2011-09-17 23:01:07 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2011-09-17 23:01:07 +0000 |
commit | f12dd7727abc99394ce4f9a397a6929c341bdb67 (patch) | |
tree | f318964040ba0e58593c842de37f329ec46c49b9 /Master/texmf-dist/doc/latex/paracol | |
parent | 4c3d942ca695f11236ecee35e9ac3cbe3c28d452 (diff) |
new latex package paracol (17sep11)
git-svn-id: svn://tug.org/texlive/trunk@23995 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/paracol')
-rw-r--r-- | Master/texmf-dist/doc/latex/paracol/README | 35 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/paracol/paracol-man.pdf | bin | 0 -> 85173 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/paracol/paracol-man.tex | 808 |
3 files changed, 843 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/paracol/README b/Master/texmf-dist/doc/latex/paracol/README new file mode 100644 index 00000000000..a8cee1b5f52 --- /dev/null +++ b/Master/texmf-dist/doc/latex/paracol/README @@ -0,0 +1,35 @@ +paracol (v0.91): a multi-column package to typeset columns in "parallel". +=== +Copyright (C) 2005-2011 + Hiroshi Nakashima <h.nakashima@DOMAIN; DOMAIN=media.kyoto-u.ac.jp> + (Kyoto Univerisity) +This package can be redistributed and/or modified under the terms +of the LaTeX Project Public License Distributed from CTAN +archives in directory macros/latex/base/lppl.txt; either +version 1 of the License, or any later version. +=== + +[Contents] + +- README ............ this document +- paracol.sty ....... the style file +- paracol-man.tex ... LaTeX source of the manual +- paracol-man.pdf ... PDF of the manual + +[Features] + ++ "paracol" environment in which you may "switch" and "synchronize columns + by \switchcolumn(*). + ++ "column", "nthcolumn", "leftcolumn" and "rightcolumn" environments used in + "paracol" to enclose texts to appear in a column. + ++ Counters are "local" to each column in default but you may make some of + them global to all columns by \globalcounter{<ctr>}. + ++ \definethecounter{<ctr>}{<i>}{<def>} to give <ctr> its appearance + <def>inition specific to <i>-th column. + +Enjoy! + +Hiroshi Nakashima <h.nakashima@DOMAIN; DOMAIN=media.kyoto-u.ac.jp> diff --git a/Master/texmf-dist/doc/latex/paracol/paracol-man.pdf b/Master/texmf-dist/doc/latex/paracol/paracol-man.pdf Binary files differnew file mode 100644 index 00000000000..ffd8f72a0a9 --- /dev/null +++ b/Master/texmf-dist/doc/latex/paracol/paracol-man.pdf 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} |