From 08521dabedd78b6b28f56c0fc227f17acfbd5daa Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 28 Oct 2011 23:39:47 +0000 Subject: paracol (28oct11) git-svn-id: svn://tug.org/texlive/trunk@24426 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/paracol/README | 40 +- .../texmf-dist/doc/latex/paracol/paracol-man.pdf | Bin 85173 -> 125522 bytes .../texmf-dist/doc/latex/paracol/paracol-man.tex | 819 +-------------------- 3 files changed, 53 insertions(+), 806 deletions(-) (limited to 'Master/texmf-dist/doc/latex/paracol') diff --git a/Master/texmf-dist/doc/latex/paracol/README b/Master/texmf-dist/doc/latex/paracol/README index a8cee1b5f52..be9b330bab7 100644 --- a/Master/texmf-dist/doc/latex/paracol/README +++ b/Master/texmf-dist/doc/latex/paracol/README @@ -1,10 +1,10 @@ -paracol (v0.91): a multi-column package to typeset columns in "parallel". +paracol (v1.00): a multi-column package to typeset columns in "parallel". === Copyright (C) 2005-2011 Hiroshi Nakashima (Kyoto Univerisity) This package can be redistributed and/or modified under the terms -of the LaTeX Project Public License Distributed from CTAN +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. === @@ -12,9 +12,32 @@ 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 +- paracol.ins ....... for docstrip +- paracol.dtx ....... main dtx for manual and implementation document +- man.dtx ........... source of Section 1 to 6 of user's manual +- ref.dtx ........... source of Section 7 of user's manual +- impl.dtx .......... source of implementation document +- paracol-man.pdf ... PDF of user's manual + +[How to "make"] + + % tex paracol.ins # you'll have paracol.sty and paracol-man.tex + +# to have user's manual (its PDF is included in the distribution) + % latex paracol-man + % latex paracol-man # you need do it twice to make index correct. + % makeindex -s gind.ist -o paracol-man.ind paracol-man.idx + % latex paracol-man + +# to have implementation document + % latex paracol.dtx + % latex paracol.dtx # you need do it twice to make index correct. + % makeindex -s gind.ist -o paracol.ind paracol.idx + % makeindex -s gglo.ist -o paracol.gls paracol.glo + % latex paracol.dtx + +Note that if you want LaTeXing paracol-man.tex and/or paracol.dtx, +you need newvbtm.sty being also available in CTAN. [Features] @@ -27,8 +50,11 @@ version 1 of the License, or any later version. + Counters are "local" to each column in default but you may make some of them global to all columns by \globalcounter{}. -+ \definethecounter{}{}{} to give its appearance - inition specific to -th column. ++ \definethecounter{}{}{} to give its resentaion + specific to -th column. + ++ \addcontentsonly{}{} to allow contents output for only + from (new for v1.00). Enjoy! diff --git a/Master/texmf-dist/doc/latex/paracol/paracol-man.pdf b/Master/texmf-dist/doc/latex/paracol/paracol-man.pdf index ffd8f72a0a9..bda56762ffe 100644 Binary files a/Master/texmf-dist/doc/latex/paracol/paracol-man.pdf and b/Master/texmf-dist/doc/latex/paracol/paracol-man.pdf differ diff --git a/Master/texmf-dist/doc/latex/paracol/paracol-man.tex b/Master/texmf-dist/doc/latex/paracol/paracol-man.tex index f2af2d6b6f6..16fe5567df7 100644 --- a/Master/texmf-dist/doc/latex/paracol/paracol-man.tex +++ b/Master/texmf-dist/doc/latex/paracol/paracol-man.tex @@ -1,808 +1,29 @@ -%234567890123456789012345678901234567890123 -\documentclass{article} +%% LaTeX file 'paracol-man'. +%% Copyright (C) 2005-2011 +%% Hiroshi Nakashima +%% (Kyoto University) +%% This program 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. + +\ProvidesFile{paracol-man.tex} +[2011/10/10 v1.0 ] +\documentclass{ltxdoc} \usepackage{paracol} \usepackage{newvbtm} - +\DisableCrossrefs +\PageIndex +\CodelineNumbered +\RecordChanges +\OnlyDescription +\def\ONLYDESCRIPTION{} \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} - - - +\raggedbottom \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. +\DocInput{paracol.dtx} \end{document} -- cgit v1.2.3