Debian Codegraph @

texmf-dist/source/latex/paracol/man.dtx

raw
1 % \begingroup
2 % \hbadness9000 \hfuzz6pt
3 %
4 % \begin{paracol}{2}[\section{Introduction}]
5 % This document describes the usage of yet another multi-column package named
6 % \textsf{paracol}. The unique feature of the package is that columns are
7 % typeset {\em in parallel.}
8 %
9 % Suppose you are writing a bilingual document whose left column is written in
10 % a language, say English, and right column has the translation of the left
11 % column in another language, e.g., Japanese. With the \textsf{paracol}
12 % package you may write an English part of arbitrarily length and then {\em
13 % switch} to its Japanese counterpart to place both parts side by side. Of
14 % course you may return to the English writing similarly.
15 %
16 % The {\em\Uidx\cswitch} is always allowed when you complete an outermost
17 % level paragraph. You may be unaware whether a column is broken into
18 % multiple pages before switching because the package automatically goes
19 % back and forward to the correct page and vertical position when you switch
20 % the column. Moreover, you may {\em\Uidx\sync{}e} columns so that the tops
21 % of the first paragraphs after switching in all columns are vertically
22 % aligned. At a \sync{}ation point, you may give a single-column text,
23 % for example a common section header, optionally. You may also switch
24 % single-column and multi-column in a page arbitrary.
25 %
26 % This manual itself is an example of two-column documents typeset by
27 % \textsf{paracol}. Since the author is not familiar with languages other
28 % than English and Japanese and the latter should be hardly understood by
29 % most of readers, the right column is the translation of the left English
30 % column into a computational language. That is, the right column is the
31 % \LaTeX{} source code of the left column\footnote{
32 % 
33 % Not really but its essence
34 % is shown.\label{fn:first}}.
35 %
36 % \switchcolumn
37 %\begin{Verbatim}
38 %\begin{paracol}{2}[\section{Introduction}]
39 %\hbadness5000
40 %This document describes the usage of yet
41 %another multi-column package named
42 %\textsf{paracol}. The unique feature of
43 %the package is that columns are typeset
44 %{\em in parallel.}
45 %
46 %Suppose you are writing a bilingual
47 %document whose left column is written in a
48 %language, say English, and right column has
49 %the translation of the left column in
50 %another language, e.g. Japanese. With the
51 %\textsf{paracol} package you may write an
52 %English part of arbitrary length and then
53 %{\em switch} to its Japanese counterpart to
54 %place both parts side by side. Of course
55 %you may return to the English writing
56 %similarly.
57 %
58 %The column switching is always allowed when
59 %you complete an outermost level paragraph.
60 %You may be unaware whether a column is
61 %broken into multiple pages before switching
62 %because the package automatically goes back
63 %and forward to the correct page and
64 %vertical position when you switch the
65 %column. Moreover, you may {\em
66 %synchronize} columns so that the tops of
67 %the first paragraphs after switching in all
68 %columns are vertically aligned. At a
69 %synchronization point, you may give a
70 %single-column text, for example a common
71 %section header, optionally. You may also
72 %switch single-column and multi-column in a
73 %page arbitrary.
74 %
75 %This manual itself is an example of
76 %two-column documents typeset by
77 %\textsf{paracol}. Since the author is not
78 %familiar with languages other than English
79 %and Japanese and the latter should be
80 %hardly understood by most of readers, the
81 %right column is the translation of the left
82 %English column into a computational
83 %language. That is, the right column is the
84 %\LaTeX{} source code of the left column%
85 %\footnote{Not really but its essence is
86 %shown.}.
87 %
88 %\switchcolumn
89 % \end{Verbatim}
90 % |\begin{verbatim}|\\
91 % {\it Here is the source of above.}\\
92 % |\end{verbatim}|\footnote{
93 % This \texttt{verbatim} construct is simply referred as to
94 % ``\textit{source}'' hereafter.}
95 %
96 %
97 %
98 % \switchcolumn*[\section{Basic Usage}]
99 % Loading the package is very simple. What you have to do is
100 % \!\usepackage!|{|\Uidx{\env{paracol}}|}| in the preamble. Or write
101 % \!\usepackage!|{|\Uidx{\env{paracol}}|}[=2018-12-31]| to get the last
102 % version authored by Hiroshi Nakashima, if this is your wish.
103 %
104 % \switchcolumn
105 %
106 %\begin{Verbatim}
107 %\switchcolumn*[\section{Basic Usage}]
108 %Loading the package is very simple. What
109 %you have to do is |\usepackage{paracol}|
110 %\end{Verbatim}
111 % |in the preamble. ...|\footnote{
112 % Hereafter, a part of the source code may be omitted like this.}\\
113 % |\switchcolumn|\\
114 % \textit{source}
115 %
116 % \switchcolumn*
117 % The fundamental means of parallel-column typesetting are the environment
118 % \env{paracol} and the command \Uidx{\!\switchcolumn!}. The \env{paracol}
119 % environment needs an argument to specify the number of columns. Thus the
120 % following is the basic construct for two-parallel-column documents.
121 % \begin{quote}
122 % \!\begin!|{|\env{paracol}|}{2}|\\
123 % \textit{left column text}\\
124 % \!\switchcolumn!\\
125 % \textit{right column text}\\
126 % \!\switchcolumn!\\
127 % \textit{left column text}\\
128 % \!\switchcolumn!\\
129 % \textit{right column text}\\
130 % \!\switchcolumn!\\
131 % \mbox{\hspace{4em}}$\vdots$\\
132 % \!\end!|{|\env{paracol}|}|
133 % \end{quote}
134 %
135 % \switchcolumn
136 %\begin{Verbatim}
137 %\switchcolumn*
138 %The fundamental means of parallel-column
139 %typesetting are the environment |paracol|
140 %and the command |\switchcolumn|. ...
141 %\switchcolumn
142 %\end{Verbatim}
143 % \textit{source}
144 %
145 % \switchcolumn[1]*
146 %\begin{Verbatim}
147 %\switchcolumn[1]*
148 %\end{Verbatim}
149 % \textit{source}
150 %\begin{Verbatim}
151 %\switchcolumn[0]
152 %The |\switchcolumn| command may have an
153 %optional argument to specify the column
154 %number (zero origin) to start. ...
155 %\end{Verbatim}
156 %
157 % \switchcolumn[0]
158 % The \!\switchcolumn! command may have an optional argument to specify the
159 % column number (zero origin) to start. That is, \!\switchcolumn!|[0]|
160 % means to switch to the leftmost column, |\switchcolumn[1]| is to start the
161 % second column and so on. Thus the |\switchcolumn| without the optional
162 % argument may be considered as \!\switchcolumn!|[|$i+1\bmod{n}$|]| where
163 % $i$ is the ordinal of the column you are leaving from and $n$ is the
164 % number of columns given to \env{paracol} environment.
165 %
166 %
167 %
168 % \switchcolumn[0]*[\section{Column Synchronization}\label{sec:sync}]
169 % The \!\switchcolumn! command may also be followed by a `|*|' to
170 % {\em\Uidx\sync{}e} columns. After you switch from a column to another by
171 % \!\switchcolumn!|*| (or \!\switchcolumn!|[|$i$|]*|), all the columns are
172 % vertically aligned at the bottom of the {\em deepest} one preceding the
173 % command. For example, the previous section has three \!\switchcolumn!|*|
174 % commands at which left and right columns are vertically aligned.
175 %
176 % The {\em starred} version of \!\switchcolumn! may have an optional
177 % argument to specify a single-column {\em\Uidx\mctext} whose bottom is the
178 % vertical alignment point of columns. For example, \!\section!
179 % commands in this manual are given as optional arguments
180 % of \!\switchcolumn!|*| like;
181 %\begin{Verbatim}
182 % \switchcolumn*[\section{Basic Usage}]
183 %\end{Verbatim}
184 % The \env{paracol} environment may also start with a \mctext{} by
185 % specifying it as the optional argument of \!\begin!|{|\env{paracol}|}|.
186 % For example, at the beginning of this document, the author put;
187 %\begin{Verbatim}
188 % \begin{paracol}{2}[\section{Introduction}]
189 %\end{Verbatim}
190 %
191 % \switchcolumn
192 %\begin{Verbatim}
193 %\switchcolumn[0]*[%
194 % \section{Column Synchronization}
195 % \label{sec:sync}]
196 %The |\switchcolumn| command may also be
197 %followed by a `|*|' to {\em synchronize}
198 %columns. ...
199 %
200 %The {\em starred} version of
201 %|\switchcolumn| may have an optional
202 %argument to specify a multi-column text
203 %whose bottom is the vertical alignment
204 %points of the columns. ...
205 %\switchcolumn
206 %\end{Verbatim}
207 % \textit{source}
208 %
209 %
210 %
211 % \begin{column*}[\section{Environments for Columns}\label{sec:env}]
212 % \Uidx{\Index{column-switching environment}}
213 % \subsection{Environment \texttt{column}}
214 % The \!\switchcolumn! is simple but you may prefer to pack the contents of a
215 % column in an environment. The \Uidx{\env{column}} environment is
216 % available for this well-structuralization of \LaTeX{} sources for
217 % parallel-columned documents. A construct;
218 % \begin{quote}
219 % \!\begin!|{|\env{column}|}|\\
220 % \textit{text for a column}\\
221 % \!\end!|{|\env{column}|}|
222 % \end{quote}
223 % is (almost) equivalent to;
224 % \begin{quote}
225 % \!\switchcolumn!\\
226 % \textit{text for a column}
227 % \end{quote}
228 % The \Uidx{\env{column*}} environment is also available for the column
229 % \sync{}ation and may have an optional argument for \mctext.
230 % \end{column*}
231 %
232 % \begin{column}
233 % \subsection{\ttfamily Environment column}
234 %\begin{Verbatim}
235 %\begin{column*}[%
236 % \section{Environments for Columns}
237 % \label{sec:env}]
238 %\subsection{Environment \texttt{column}}
239 %The |\switchcolumn| is simple but you may
240 %prefer to pack the contents of a column in
241 %an environment. ...
242 %\end{column*}
243 %\begin{column}
244 %\end{Verbatim}
245 % \textit{source}\\
246 % |\end{column}|
247 % \end{column}
248 %
249 % \begin{nthcolumn*}{1}
250 % \subsection{\ttfamily Environment nthcolumn}
251 %\begin{Verbatim}
252 %\begin{nthcolumn*}{1}
253 %\end{Verbatim}
254 % \textit{source}
255 %\begin{Verbatim}
256 %\end{nthcolumn*}
257 %
258 %\begin{nthcolumn}{0}
259 %\subsection{Environment \texttt{nthcolumn}}
260 %The |\switchcolumn| can start an
261 %arbitrarily specified column with the
262 %column number given through its optional
263 %argument, but the |column| environment
264 %cannot do it. ...
265 %\end{nthcolumn}
266 %\end{Verbatim}
267 % \end{nthcolumn*}
268 % \begin{nthcolumn}{0}
269 % \subsection{Environment \texttt{nthcolumn}}
270 % The \!\switchcolumn! can start an arbitrarily specified column with the
271 % column number given through its optional argument, but the \env{column}
272 % environment cannot do it. If you want to start $i$-th column, you have to
273 % do \!\begin!|{|\Uidx{\env{nthcolumn}}|}{|$i$|}| (or
274 % \Uidx{\env{nthcolumn*}} with an optional argument to \sync{}e).
275 % \end{nthcolumn}
276 %
277 %
278 %
279 % \begin{leftcolumn*}
280 % \subsection[Environments \texttt{leftcolumn} and \texttt{rightcolumn}]
281 % {Environments \texttt{leftcolumn} and\\\texttt{rightcolumn}}
282 % The environments \Uidx{\env{leftcolumn}} and \Uidx{\env{rightcolumn}} (and
283 % their starred versions with an optional argument) are available as more
284 % convenient means than saying \!\begin!|{|\env{nthcolumn}|}{0}| to switch
285 % to the left(most) column and
286 % \!\begin!|{|\env{nthcolumn}|}{1}| to the right (but may not be rightmost)
287 % one.
288 % 
289 % \Uidx{\EnvIndex{leftcolumn*}}\Uidx{\EnvIndex{rightcolumn*}}
290 %
291 % \begin{figure*}\nosv
292 % \def\arraystretch{0.8}
293 % \centerline{\begin{tabular}[b]{|c|}\hline
294 % \hbox to.9\textwidth{}\\
295 % double-column figure \#1\\
296 % \\\hline
297 % \end{tabular}}
298 % \caption{A Double-Column Figure}
299 % \end{figure*}
300 % \begin{figure}[t]\nosv
301 % \def\arraystretch{0.8}
302 % \centerline{\begin{tabular}[b]{|c|}\hline
303 % \hbox to.9\columnwidth{}\\\\
304 % single-column figure \#1\\
305 % \\\\\hline
306 % \end{tabular}}
307 % \caption{A Single-Column Figure}
308 % \end{figure}
309 % \end{leftcolumn*}
310 %
311 % \begin{rightcolumn}
312 % \subsection{\ttfamily Environment leftcolumn and\\rightcolumn}
313 %\begin{Verbatim}
314 %\begin{leftcolumn*}
315 %\subsection{%
316 % Environments \texttt{leftcolumn} and\\
317 % \texttt{rightcolumn}}
318 %The environments |leftcolumn| and
319 %|rightcolumn| (and their starred versions
320 %with an optional argument) are available as
321 %more convenient means than saying
322 %|\begin{nthcolumn}{0}| to switch to the
323 %left(most) column and ...
324 %\begin{figure*}...\end{figure*}
325 %\begin{figure}[t]...\end{figure}
326 %\end{leftcolumn*}
327 %\begin{rightcolumn}
328 %\end{Verbatim}
329 % \textit{source and a \texttt{figure} environment}\\
330 % |\end{rightcolumn}|
331 % \begin{figure}[t]\nosv
332 % \def\arraystretch{0.8}
333 % \centerline{\begin{tabular}[b]{|c|}\hline
334 % \hbox to.9\columnwidth{}\\
335 % \ttfamily single-column figure \#2\\
336 % \\\hline
337 % \end{tabular}}
338 % \caption{\ttfamily Another Single-Column Figure}
339 % \end{figure}
340 % \end{rightcolumn}
341 %
342 %
343 %
344 % \begin{leftcolumn*}[\section{Floats, Footnotes and Counters}
345 % \label{sec:float}]
346 % \changes{v1.2-7}{2013/05/11}
347 % {Remove \cs{nosv} from verbatim example of Table~1 shown in the right
348 % column.}
349 % \changes{v1.32-3}{2015/10/10}
350 % {Add footnote to mention the page-wise float problem.}
351 % \begin{table}[b]\nosv
352 % \caption{A Single-Column Table}
353 % \centerline{\begin{tabular}[t]{|l|c|r|}\hline
354 % An&example&of\\\hline
355 % single&column&table\\\hline
356 % \end{tabular}}
357 % \end{table}
358 % \subsection{Figures and Tables}
359 % As shown in this page, double-column figures\slash tables (or those
360 % spanned multiple columns if you have three or more) may be placed by
361 % \env{figure*} and \env{table*} environments as usual\footnote{
362 % 
363 % See Section~\ref{sec:problem} for the appearance order issue of
364 % double-column floats.}.
365 % 
366 % A single-column figure\slash table will be placed in the column in which
367 % you put \env{figure} and \env{table}. For example, the body of a
368 % \env{figure} environment in a \env{leftcolumn} environment is
369 % \emph{always} placed in a left column. That is, even if the column of the
370 % \emph{current} page does not have enough room to place the figure, it will
371 % not be thrown to the right column but will be placed in the left column of
372 % the next page\footnote{
373 % 
374 % Or some farther page if \LaTeX{} cannot solve the placement problem wisely.}.
375 %
376 % Another caution about float placement is that you have to be careful when
377 % you try to put a top-float explicitly with |t|-option or implicitly without
378 % placement option (i.e., |tbp| in most classes) and to \sync{}e columns.
379 % The rule is as follows; after you \sync{}e columns in a page, the page
380 % cannot have top-floats any more. When you \sync{}e columns,
381 % \textsf{paracol} fixes a virtual horizontal line in the page as the
382 % \sync{}ation barrier. Thus no top-floats cannot be added above the
383 % line\footnote{
384 % 
385 % Even if you have enough space above, sorry.}.
386 % 
387 % Therefore, the author put two \env{figure} environments for the figures
388 % shown in this page into the \env{leftcolumn*} and \env{rightcolumn}
389 % environment for the previous section.
390 %
391 % \subsection{Footnotes and Marginal Notes}
392 % \changes{v1.2-2}{2013/05/11}
393 % {Add a footnote mentioning page-wise footnotes.}
394 %
395 % Footnotes are also put at the bottom of the column in which \!\footnote!
396 % commands and their references reside (like this\footnote{
397 % 
398 % Unless you specify to make footnotes {\em page-wise} as explained in
399 % Section \ref{sec:ref-scfnote} and \ref{sec:fnnp}.}),
400 % 
401 % as shown in page~\pageref{fn:first} and this page. Marginal
402 % notes behave similarly like what you are seeing in the left margin of this
403 % sentence\marginpar{
404 % 
405 % \raggedright An example of marginal note.}
406 % 
407 % and the right marginal note in this page\footnote{
408 % 
409 % If you have three or more columns, marginal notes of the second or
410 % succeeding columns are placed in the right margin in default setting. The
411 % \textsf{paracol} package solves the placement problem of marginal notes
412 % from two or more columns sharing a side margin by moving some of them down
413 % if they conflict over the space with each other.}.
414 %
415 % \subsection{Local and Global Counters}
416 % \UsageIndex{local counter}
417 % \UsageIndex{global counter}
418 % 
419 % You probably found that the numbering of figures and tables is \emph{global}
420 % while that of footnotes are \emph{local}. That is, the figure in the right
421 % column of the previous page has number~3 following its left-column
422 % counterpart Figure~2. The tables in the page are also numbered as 1 and 2
423 % crossing the column boundary. However, the footnotes in each column have
424 % their own numbering sequence. Moreover, the footnote numbers in left
425 % columns are typeset in roman font while those in right columns have italic
426 % shapes. Similarly, subsection numbering is local and the headings in right
427 % columns have typewriter-face numbers.
428 %
429 % This happens because the author declared the counters \counter{figure} and
430 % \counter{table} are \emph{global} in the preamble of this document by
431 % saying;
432 % \begin{itemize}\item[]
433 % \Uidx{\!\globalcounter!}|{figure}|\\
434 % \!\globalcounter!|{table}|
435 % \end{itemize}
436 % and do nothing about \counter{footnote} and \counter{subsection} counters.
437 % By default, all the counters except for |page| are local to columns. The
438 % value of a \lcounter{} of a column is saved somewhere when you leave the
439 % column, and it is restored when you revisit the column. The initial values
440 % of the \lcounter{}s are the values they have at
441 % \!\begin!|{|\env{paracol}|}|. After you close the \env{paracol}
442 % environment, the values of the leftmost column are used for the rest of
443 % your document until you start new \env{paracol} environment. On a
444 % restart, \lcounter{}s in a column have the values they had at the last
445 % \Endparacol, except for those which have been modified outside the
446 % environment because the modifications are \emph{broadcasted} to
447 % \lcounter{}s in all columns. You will see the effect of this
448 % inter-environment counter value conservation in the footnote numbers in
449 % the right column in page~\pageref{fn:right3} and \pageref{fn:right4}.
450 %
451 % This broadcasting of a \lcounter{} value can be done explicitly in
452 % \env{paracol} environments by a command $\Uidx{\!\synccounter!}\Arg{ctr}$.
453 % This command makes $\mathit{ctr}$ in all columns have the value of that in
454 % the column in which the command appears. In addition, another command
455 % \Uidx{\!\syncallcounters!} performs this broadcasting for all \lcounter{}s.
456 %
457 % If you make a counter global by the command \!\globalcounter!, the
458 % save/restore operations are not performed to the counter and thus it is
459 % globally incremented by |\[ref]|\AB|stepcounter|
460 % 
461 % \SpecialIndex{\refstepcounter}\SpecialIndex{\stepcounter}
462 % 
463 % or commands such as \!\caption! and \!\section!. Note that the value of a
464 % \gcounter{} depends on the place where it is incremented (or set) in
465 % the \emph{source code} rather than where it appears in the output. Thus
466 % if the author put a \env{table} environment here to increment \env{table}
467 % counter, the right-column table at the bottom of page~\pageref{tab:right}
468 % would be Table~3 because its \env{table} environment does not appear yet
469 % in the source code. Note that, however, though the counter \counter{page}
470 % is global as expected, its numbering is consistent among all columns as
471 % far as you refer to the value by $\!\pageref!\Arg{label}$ and/or see the
472 % values in table of contents, etc.
473 %
474 % Another counter which the author made global in this document is
475 % \counter{section}. As explained in Section~\ref{sec:sync}, an optional
476 % \mctext{} of \cswitch{} is considered as in the leftmost column. Since
477 % \!\section! commands in this document are always given in \mctext{}s, so
478 % far, it seems unnecessary to make \counter{section} global because it is
479 % incremented correctly in the leftmost column. However, the stepping
480 % \counter{section} has a side effect to reset its descendent counter
481 % \counter{subsection} and referred to from \!\thesubsection! command. Thus
482 % if \counter{section} were local, the right-column subsections in
483 % Section~\ref{sec:env} would be numbered as ``0.1'', ``0.2'' and ``0.3''
484 % because the local value of \counter{section} would be zero. Moreover, the
485 % right-column subsections of this section would be ``0.4'', ``0.5'' and
486 % ``0.6'' because stepping \counter{section} local to the left column would
487 % not reset \counter{subsection} local to the right column.
488 %
489 % You may give a local appearance to a counter \textit{ctr} for the $i$-th
490 % column (zero origin) by a command;
491 % \begin{itemize}\item[]
492 % \Uidx{\!\definethecounter!}|{|\textit{ctr}|}{|$i$|}{|\textit{def}|}|
493 % \end{itemize}
494 % where \textit{def} is to be the body of the local definition of
495 % |\the|\textit{ctr}. For example, the preamble of this document has the
496 % following to give non-default defitions to \!\thefootnote! and
497 % \!\thesubsection! for right columns.
498 % 
499 %\begin{Verbatim}
500 % \definethecounter{footnote}{1}{%
501 % \textit{\arabic{footnote}}}
502 % \definethecounter{subsection}{1}{%
503 % \texttt{%
504 % \arabic{section}.\arabic{subsection}}}
505 %\end{Verbatim}
506 %\end{leftcolumn*}
507 %
508 % \begin{rightcolumn}
509 % \begin{table}[b]\nosv
510 % \caption{\ttfamily Another Single-Column Table}
511 % \label{tab:right}
512 % \centerline{\ttfamily \begin{tabular}[t]{|l|r|}\hline
513 % Another&example\\\hline
514 % of&single\\\hline
515 % column&table\\\hline
516 % \end{tabular}}
517 % \end{table}
518 % \subsection{\ttfamily Figures and Tables}
519 %\begin{Verbatim}
520 %\begin{leftcolumn*}[\section{%
521 % Floats, Footnotes and Counters}]
522 %\begin{table}[b]
523 %\caption{A Single-Column Table}
524 %\centerline{\begin{tabular}[t]{|l|c|r|}
525 % \hline
526 % An&example&of\\\hline
527 % single&column&table\\\hline
528 % \end{tabular}}
529 %\end{table}
530 %\subsection{Figures and Tables}
531 %As shown in this page, double-column
532 %figures\slash tables (or those spanned
533 %multiple columns if you have three or more
534 %columns) may be placed by |figure*| and
535 %\end{Verbatim}
536 % {\ttfamily |table*| environments as usual\footnote{Another example
537 % of footnote.\label{fn:right3}}. ...}
538 %
539 % \subsection{\ttfamily Footnotes and Marginal Notes}
540 %\begin{Verbatim}
541 %Footnotes are also put at the bottom of the
542 %column in which |\footnote| commands and
543 %their references reside (like
544 %this\footnote{...}), as shown in page~2 and
545 %this page. Marginal notes behave similarly
546 %like what you are seeing in the left margin
547 %of this sentense\marginpar{\raggedright
548 %An example of marginal note.} and the right
549 %marginal note in this
550 %\end{Verbatim}
551 % |page\footnote{...}. ...|
552 % \marginpar{\raggedright\ttfamily
553 % Another example of marginal note.}
554 %
555 % \begin{figure}[t]\nosv
556 % \centerline{\begin{tabular}[b]{|c|}\hline
557 % \hbox to.9\columnwidth{}\\\\\\\\
558 % \ttfamily another figure with [t] option\\
559 % \ttfamily to fill space
560 % \\\\\\\\\hline
561 % \end{tabular}}
562 % \caption{\ttfamily
563 % Another Figure with [t] Option}
564 % \end{figure}
565 %
566 % \begin{figure}[b]\nosv
567 % \centerline{\begin{tabular}[b]{|c|}\hline
568 % \hbox to.9\columnwidth{}\\
569 % \ttfamily a figure with [b] option\\
570 % \ttfamily to fill space\\
571 % \\\hline
572 % \end{tabular}}
573 % \caption{\ttfamily
574 % A Figure with [b] Option}
575 % \end{figure}
576 %
577 % \subsection{\ttfamily Local and Global Counters}
578 %\begin{Verbatim}
579 %You probably found that the numbering of
580 %figures and tables is \emph{global} while
581 %that of footnotes are \emph{local}. ...
582 %\end{leftcolumn*}
583 %\begin{rightcolumn}
584 %\end{Verbatim}
585 % \textit{source}.\\
586 % |\end{rightcolumn}|
587 %
588 % \begin{figure}[p]\nosv
589 % \centerline{\begin{tabular}[b]{|c|}\hline
590 % \hbox to.9\columnwidth{}\\\\\\\\
591 % \ttfamily a figure with [p] option\\
592 % \ttfamily to fill space
593 % \\\\\\\\\hline
594 % \end{tabular}}
595 % \caption{\ttfamily
596 % A Figure with [p] Option}
597 % \end{figure}
598 %
599 % \begin{figure}[p]\nosv
600 % \centerline{\begin{tabular}[b]{|c|}\hline
601 % \hbox to.9\columnwidth{}\\\\\\\\
602 % \ttfamily another figure with [p] option\\
603 % \ttfamily to fill space
604 % \\\\\\\\\hline
605 % \end{tabular}}
606 % \caption{\ttfamily
607 % Another Figure with [p] Option}
608 % \end{figure}
609 %
610 % \begin{figure}[p]\nosv
611 % \centerline{\begin{tabular}[b]{|c|}\hline
612 % \hbox to.9\columnwidth{}\\\\\\\\
613 % \ttfamily yet another figure with [p]\\
614 % \ttfamily option to fill space
615 % \\\\\\\\\hline
616 % \end{tabular}}
617 % \caption{\ttfamily
618 % Yet Another Figure with [p] Option}
619 % \end{figure}
620 %
621 % \begin{figure}[p]\nosv
622 % \centerline{\begin{tabular}[b]{|c|}\hline
623 % \hbox to.9\columnwidth{}\\\\\\\\
624 % \ttfamily fourth figure with [p]\\
625 % \ttfamily option to fill space
626 % \\\\\\\\\hline
627 % \end{tabular}}
628 % \caption{\ttfamily
629 % Forth Figure with [p] Option}
630 % \end{figure}
631 %
632 % \begin{figure}[t]\nosv
633 % \centerline{\begin{tabular}[b]{|c|}\hline
634 % \hbox to.9\columnwidth{}\\\\\\
635 % \ttfamily yet another figure with [t]\\
636 % \ttfamily option to fill space
637 % \\\\\\\hline
638 % \end{tabular}}
639 % \caption{\ttfamily
640 % Yet Another Figure with [t] Option}
641 % \end{figure}
642 % \end{rightcolumn}
643 % \switchcolumn*
644 % \flushpage
645 % \end{paracol}
646 %
647 %
648 %
649 % \section{Closing \texttt{paracol} Environment and Page Flushing}
650 % \label{sec:man-close}
651 % The final example shown here is this single-column text which the author put
652 % after the \env{paracol} environment above is closed. As you are seeing, a
653 % \env{paracol} environment can be finished at any vertical position in a
654 % page and can be followed by ordinary single column texts.
655 %
656 % \begin{paracol}{2}
657 % \begin{leftcolumn}
658 % The environment may also be restarted anywhere you like as shown here.
659 %
660 % The last issue is to flush a page. The ordinary \!\newpage! command works
661 % as you expect. If you say \!\newpage! in the left column in a page, the
662 % contents following it will appear in the left column in the next page. Note
663 % that this does not affect the layout of the right column.
664 %
665 % To flush all columns in a page, a command \Uidx{\!\flushpage!} is
666 % available. This command in $i$-th column is almost equivalent to;
667 % \begin{itemize}\item[]
668 % \!\switchcolumn!|[|$i$|]*[|\!\newpage!|]|
669 % \end{itemize}
670 % but more robust\footnotemark\label{fn:flush}.
671 % The ordinary page breaking command \Uidx{\!\clearpage!} may also be used
672 % to flush all columns and to start a fresh page, but it has a side effect
673 % to put all figures and tables which are not yet output.
674 % \end{leftcolumn}
675 %
676 % \begin{rightcolumn}
677 %\begin{Verbatim}
678 %\begin{paracol}{2}
679 %\begin{leftcolumn}
680 %The environment may also be restarted
681 %anywhere you like as shown here. ...
682 %\end{leftcolumn}
683 %\begin{rightcolumn}
684 %\end{Verbatim}
685 % \textit{source}\\
686 % |\end{rightcolumn}|\\
687 % |\end{paracol}|\\
688 % |Now the aurthor will do ...|
689 % \end{rightcolumn}
690 % \end{paracol}
691 %
692 % \changes{v1.1}{2012/05/11}
693 % {Add \cs{columnratio}\texttt{\char`\{0.6\char`\}} and a phrase
694 % for it.}
695 % Now the author will do |\flushpage| shortly to start a real binlingual
696 % example from the next page, after showing another example of closing
697 % \env{paracol} environments in this sentence and of restarting in the next
698 % one, in which {\em unbalanced column width} is demonstrated using
699 % \Uidx{\!\columnratio!} command shown in Section~\ref{sec:ref-colwidth}.
700 %
701 % \columnratio{0.6}
702 % \begin{paracol}{2}
703 % \begin{leftcolumn}
704 % O.K., we have restarted \env{paracol} environment and we will see the
705 % effect of \!\flushpage! now!!\footnotetext{
706 % 
707 % For example \texttt{\string\switchcolumn*} may flush a page for the
708 % \sync{}ation and thus \texttt{\string\newpage} may leave an empty page.}
709 % 
710 % \end{leftcolumn}
711 % \begin{rightcolumn}
712 %\begin{Verbatim}
713 %\columnratio{0.6}
714 %\begin{paracol}{2}
715 %\begin{leftcolumn}
716 %O.K., ...
717 %\end{leftcolumn}
718 %\end{Verbatim}
719 % |\begin{rightcolumn}| \textit{source}\\
720 % |\end{rightcolumn}|
721 % \flushpage
722 % \end{rightcolumn}
723 %
724 %
725 %
726 % \changes{v1.2-7}{2013/05/11}
727 % {Correct a few words in German and English libretti.}
728 % \newenvironment{Gverse}{\ensurevspace{2\baselineskip}\begin{leftcolumn*}
729 % \begin{myverse}}
730 % {\end{myverse}\end{leftcolumn*}}
731 % \newenvironment{Everse}{\begin{rightcolumn}\begin{myverse}}
732 % {\end{myverse}\end{rightcolumn}}
733 % \makeatletter
734 % \newenvironment{myverse}{\leftmargini0pt\partopsep0pt\verse}{\endverse}
735 %
736 % \begin{leftcolumn*}[
737 % \centerline{\Large An Die Freude/To Joy}\label{page:bfreude}\smallskip
738 % \centerline{\large Friedrich Schiller}\smallskip
739 % The following is the libretto of the fourth movement of Beethoven's Ninth
740 % Symphony, his adaptation of Schiller's ode ``An Die Freude'' (or ``To Joy'' in
741 % English). Beethoven's additions and revisions are indicated in italics.]
742 % \end{leftcolumn*}
743 % \begin{Gverse}
744 % \itshape O Freunde, nicht diese T\"one! \\
745 % Sondern la{\ss}t uns angenehmere anstimmen und freu\-denvollere
746 % \footnote{If I had been a good student in my German class, I could find
747 % the German translation of the right column footnote \ref{fn:right4} is
748 % ``Dieser Teil wurde von Beethoven hinzugef\"ugt'' by myself without
749 % the kind help from a user.}.
750 % \end{Gverse}
751 % \begin{Everse}
752 % \itshape Oh friends, no more of these sad tones!\\
753 % Let us rather raise our voices together\\
754 % In more pleasant and joyful tones
755 % \footnote{This part was added by Beethoven.\label{fn:right4}}.
756 % \end{Everse}
757 % \begin{Gverse}
758 % Freude!\\
759 % Freude, sch\"oner G\"otterfunken
760 % Tochter aus Elysium,\\
761 % Wir betreten feuertrunken,
762 % Himmlische, dein Heiligtum!\\
763 % Deine Zauber binden wieder,
764 % {\itshape Was die Mode streng geteilt;\\
765 % Alle Menschen werden Br\"uder\footnote{
766 % Original: Was der Mode Schwert geteilt;\\
767 % Bettler werden F\"urstenbr\"uder,},}
768 % Wo dein sanfter Fl\"u\-gel weilt
769 % \end{Gverse}
770 % \begin{Everse}
771 % Joy! \\
772 % Joy, thou shining spark of God,\\
773 % Daughter of Elysium,\\
774 % With fiery rapture, goddess,\\
775 % We approach thy shrine.\\
776 % Your magic reunites\\
777 % {\itshape That which stern custom has parted;\\
778 % All humans will become brothers\footnote{
779 % Original:
780 % What custom's sword has parted;\\
781 % Beggars become princes' brothers}}\\
782 % Under your protective wing.
783 % \end{Everse}
784 % \begin{Gverse}
785 % Wem der gro{\ss}e Wurf gelungen,
786 % eines Freundes Freund zu sein;\\
787 % Wer ein holdes Weib errungen,
788 % mische seinen Jubel ein!\\
789 % Ja, wer auch nur eine Seele
790 % sein nennt auf dem Erdenrund!\\
791 % Und wer's nie gekonnt, der stehle
792 % weinend sich aus diesem Bund!
793 % \end{Gverse}
794 % \begin{Everse}
795 % Let the man who has had the fortune\\
796 % To be a helper to his friend,\\
797 % And the man who has won a noble woman,\\
798 % Join in our chorus of jubilation!\\
799 % Yes, even if he holds but one soul\\
800 % As his own in all the world!\\
801 % But let the man who knows nothing of this\\
802 % Steal away alone and in sorrow.
803 % \end{Everse}
804 % \begin{Gverse}
805 % Freude trinken alle Wesen
806 % an den Br\"usten der Natur;\\
807 % Alle Guten, alle B\"osen
808 % folgen ihrer Rosenspur.\\
809 % K\"usse gab sie uns und Reben,
810 % einen Freund, gepr\"uft im Tod;\\
811 % Wollust ward dem Wurm gegeben,
812 % und der Cherub steht vor Gott.
813 % \end{Gverse}
814 % \begin{Everse}
815 % All the world's creatures drink\\
816 % From the breasts of nature;\\
817 % Both the good and the evil\\
818 % Follow her trail of roses.\\
819 % She gave us kisses and wine\\
820 % And a friend loyal unto death;\\
821 % She gave the joy of life to the lowliest,\\
822 % And to the angels who dwell with God.
823 % \end{Everse}
824 % \begin{Gverse}
825 % Froh, wie seine Sonnen fliegen
826 % durch des Himmels pr\"acht'gen Plan,\\
827 % Laufet, Br\"uder, eure Bahn,
828 % freudig, wie ein Held zum Siegen.
829 % \end{Gverse}
830 % \begin{Everse}
831 % Joyous, as his suns speed\\
832 % Through the glorious order of Heaven,\\
833 % Hasten, brothers, on your way,\\
834 % Joyful as a hero to victory.
835 % \end{Everse}
836 % \begin{Gverse}
837 % Seid umschlungen, Millionen!
838 % Diesen Ku{\ss} der ganzen Welt!\\
839 % Br\"uder, \"uber'm Sternenzelt
840 % mu{\ss} ein lieber Vater woh\-nen.
841 % \end{Gverse}
842 % \begin{Everse}
843 % Be embraced, all ye millions!\\
844 % With a kiss for all the world!\\
845 % Brothers, beyond the stars\\
846 % Surely dwells a loving Father.
847 % \end{Everse}
848 % \begin{Gverse}
849 % Ihr st\"urzt nieder, Millionen?
850 % Ahnest du den Sch\"opfer, Welt?\\
851 % Such'ihn \"uberm Sternenzelt!
852 % \"Uber Sternen mu{\ss} er wohnen.
853 % \end{Gverse}
854 % \begin{Everse}
855 % Do you kneel before him, oh millions?\\
856 % Do you sense the Creator's presence?\\
857 % Seek him beyond the stars!\\
858 % He must dwell beyond the stars.
859 % \end{Everse}
860 % \end{paracol}
861 % \label{page:efreude}
862 % \endgroup
863 \endinput
864
865  vi: spellcapcheck=[.?]\\_[])'"^I\ ]\\+ spell