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