| 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 |