summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/paracol/ppts.dtx
blob: 311a1efda13faf4af74d89965205aea5fd2c233c (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
% \marginparpush5pt \@mparswitchtrue
% \section{Two-Sided Typesetting and Parallel-Paging}
% \label{sec:ppts}
% \changes{v1.3-2}{2013/09/17}
%	{Add the section ``Two-Sided Typesetting and Parallel-Paging''.}
% \changes{v1.3-4}{2013/09/17}
%	{Add the section ``Two-Sided Typesetting and Parallel-Paging''.}
% \changes{v1.3-5}{2013/09/17}
%	{Add the section ``Two-Sided Typesetting and Parallel-Paging''.}
% 
% This and the next section are typeset with \Uidx{\!\twosided!} enabling
% features |p|, |c| and |m| and also |b| for a part of the next section.
% The effect of |p| feature can be seen by the left side, or in other word
% inside, margin of this odd-numbered page is narrower than that of the
% previous pages because the author reduced the effective left side margin
% being $\!\oddsidemargin!+1\,|in|$ by 75\,\%\footnote{
% 
% This document itself does not have |twoside| option in its
% \!\documentclass! but the inconsistency between the option and
% \!\twosided! is not visible because \!\pagestyle! is |plain|.}.
% 
% This setting makes the right side or outside margin of this page enlarged
% by 125\,\% as well as the left side and outside margin of the next
% even-numbered page.
% 
% Next, we see the effects of |c| and |m| features by the \env{paracol}
% environment below for which \Uidx{\!\columnratio!}|{0.6}| and
% \Uidx{\!\marginparthreshold!}|{0}| are declared to make the \emph{inside}
% columns (left ones in odd-numbered pages) are wider than the
% \emph{outside} ones and all marginal notes go to outside (right in
% odd-numbered pages) margins.
% 
% \columnratio{0.6}\marginparthreshold{0}
% 
% \par\Hrule
% \begin{paracol}{2}
% \switchcolumn
% \footnotetext*{Since the author is temporarily disabling the warning from
% marginal note placement mechanism of \LaTeX, pushing down the second
% marginal note from column-1 is silently performed when you process this
% document.}
% \switchcolumn
% This line\Marginpar{First marginal note from column-0.} of the first
% paragraph of the inside column-0 has a marginal note.  Now the author puts
% a few dummy lines to keep a space below the marginal note.\\
% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\par
% 
% This line\Marginpar{Second marginal note from column-0.} of the second
% paragraph of the inside column-0 also has a marginal note.  Now the author
% puts a few dummy lines again but this time to go down to the bottom of the
% page.\\
% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
% \Dotfill\\ \Dotfill\\ \Dotfill\par
% 
% This is the third paragraph of the inside column-0 having a page break in
% it.  Since shortly we will be in an even-numbered page
% \pageref{page:ppts2} (now), this wider column\Marginpar{Third marginal
% note from column-0} is now right one keeping it
% inside, while the marginal note given in the first line of this page goes
% to left and outside.  Now we will have a \!\switchcolumn! below this
% paragraph to go to the column-1 and back to the previous page
% \pageref{sec:ppts}.\label{page:ppts2}
% \switchcolumn
% \it
% This is the first paragraph in the narrower, italicized and outside
% column-1.  In this paragraph, we shortly have a marginal note, italicized
% too, which goes to the outside margin shared by all marginal notes from
% both columns.\Marginpar{\it First marginal note from column-1.}  The
% marginal note given here is placed its natural position and its first line
% is aligned to the first line of the second sentence of this paragraph by
% exploitation of the space between two marginal notes from the column-0,
% though we already have had three notes from the column.
% 
% Now\Marginpar{\it Second marginal note from column-1.} the author puts
% another marginal note whose first line would be aligned to that of this
% paragraph, but it is pushed down below the second marginal note from the
% column-0 because two notes conflict with each other over the
% space\footnotemark*[+0].  Note that since the note from this column is given
% \emph{after} that from the column-0 was given, the conflict is solved
% pushing the note from this column down rather than that from the
% column-0.  Now the author puts a few dummy lines to go to the second last
% line of this page.\\
% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
% \Dotfill\par
% 
% This is the third paragraph of the outside column-1, which becomes left
% shortly by the page break.\Marginpar{\it Third marginal note from
% column-1.}  The third marginal note is given in the first line of this
% page, but it is pushed down again due to the conflict with the note from
% the column-0.
% \end{paracol}
% \Hrule
% 
% Note that the position of the last marginal note in the \env{paracol}
% \Marginpar{Marginal note given after \env{paracol} environment is closed.}
% environment which we just have closed affects the marginal note placement
% in \postenv.  For example, the marginal note given in the first line of
% this paragraph is pushed down.
% 
% From the next page, we will see a few examples of \parapag{}ing.
% 
% 
% 
% \newpage
% \subsection{Example of Paired Parallel-Paging}
% \label{sec:ppts-paired}
% 
% Shortly we will start a \env{paracol} environment by \beginparacol|[2]{4}|
% having four columns but two for each of left and right \paired{}
% \parapag{}es.  Since the author declares \!\columnratio!|{0.6}[0.5]|, the
% columns in left pages are made unbalanced while those in right pages are
% balanced.
% 
% \columnratio{0.6}[0.5]
% \par\Hrule
% \begin{paracol}[2]{4}
% This is the first paragraph of the leftmost column-0,
% \Marginpar{Marginal note from column-0.}
% whose first line has a marginal note placed in the right margin because
% the setting of \!\marginparthreshold! being 0 is still effective and we
% are in the odd-numbered page \pageref{sec:ppts-paired}.  Now we
% have a \!\switchcolumn! to the next column-1.
% 
% \switchcolumn
% \begin{Hfuzz}{1.1pt}\it
% This is the first paragraph of the second and right column-1 in the left
% \parapag{}e.  We shortly give an italicized mar\-gin\-al note carefully, so
% that it does not conflict with the marginal note from the column-0.
% \Marginpar{\it Marginal note from column-1.}
% That is, now the author puts the note.  Now we
% have a \!\switchcolumn! to the next column-2.
% \end{Hfuzz}
% \footnotetext*{This footnote is put in the left \parapag{}e together with
% another footnote below given in the column-2 in the right \parapag{}e.
% \label{fn:ppts-paired1}}
% 
% \switchcolumn
% \begingroup\sf
% This is the first paragraph of the column-2 being the left column of the
% right \parapag{}e.  Though we are in a page different from that column-0
% and 1 reside in, this page is still numbered \pageref{sec:ppts-paired}
% because the left and right page is \paired.  Therefore, the left margin of
% this page is narrower than the right margin because the page number is
% odd.
% 
% \footnotetext*{This footnote is \emph{not} put in the right \parapag{}e
% though it is given in the column-2 in the right \parapag{}e and thus its
% reference is in the column, of course.\label{fn:ppts-paired2}}
% 
% You have to notice
% \Marginpar{\sf Marginal note from column-2.}
% the first paragraph does not start from the page top
% but above it we have some space of exactly same size as the \preenv{}
% shown in the left \parapag{}e.  Therefore, the top of the first paragraphs
% in all columns are aligned.  The marginal note given in the first line of
% this paragraph goes to the right margin of this page because of the
% \!\marginparthreshold! setting and the parity of this page.  Now we have a
% \!\switchcolumn! to the next column-3.
% \par\endgroup
% \begin{figure*}\nosv
% \def\arraystretch{0.8}
% \centerline{\begin{tabular}[b]{|c|}\hline
%     \hbox to.9\textwidth{}\\
%     \sf page-wise figure given in column-2\\
%     \\\hline
%     \end{tabular}}
% \caption{A Page-Wise Figure}
% \end{figure*}
% 
% \switchcolumn
% \begingroup\sl
% This is the first paragraph
% \Marginpar{\sl Marginal note from column-3.}
% in the last rightmost column-3 whose width is equal to that of the column-2.
% The marginal note given in the first line goes to right and does not
% conflict with that from the column-2.  We are now going back to the
% column-0 by a {\rm\!\switchcolumn!|*|} with a \mctext.
% \endgroup
% 
% \switchcolumn*[\subsection*{A Spanning Text: though this is wider than the
% page width, this text does not span the boundary between the left and
% right parallel-pages.}]
% 
% We have come back to this column-0.  The space above the \mctext{} is due
% to the \sync{}ation because two paragraphs in the column-2 are
% significantly taller in total than the paragraphs in other columns.  As
% the spanning text itself says, it cannot extend to the right \parapag{}e.
% The author puts dummy lines to go to the page bottom.\\
% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\par
% 
% Now we will have a page break shortly.  You could be surprised by seeing
% this column is not in the left \parapag{}e after the break but in the
% right one.  This is because the feature |c| is enabled to swap not only
% columns in a page but also the left and right \paired{} \parapag{}es when
% they are even-numbered.  The other feature |p| makes the left outside
% margins of this right and the previous left pages wider than the right
% inside margins.\label{page:ppts-paired2}
% 
% \switchcolumn
% \begingroup\it
% We have restarted this column-1.  This paragraph has a
% footnote\footnotemark*[-1] as shown below.\\
% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
% \Dotfill\\ \Dotfill\par
% 
% After the page break below, this column also goes to the right page
% together with the column-0
% \Marginpar{\it Another marginal note from column-1.}
% and is placed outside (left) in the page, as well as the marginal note
% in this right page but in the outside margin.
% \par\endgroup
% 
% \switchcolumn
% \begingroup\sf
% We have a few other materials not shown in right \parapag{}es.  The space
% above this paragraph is for the \mctext{} placed in the left \parapag{}e.
% The \Scfnote{} given here\footnotemark{} is also not in this page but in
% the left.  Finally, the author has put a page-wise figure spanning columns
% just before \!\switchcolumn! by which we left this column, but it will be
% in the right page \pageref{page:ppts-paired2} together with column-0 and
% 1.\\
% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
% \Dotfill\\ \Dotfill\\ \Dotfill\par
% 
% Though the footnote numbered \ref{fn:ppts-paired2} goes to the left page,
% its space and that of \ref{fn:ppts-paired1} make this and the next columns
% shorter in the previous page.  Similarly, we have a space above for the
% page-wise figure shown in the right page.
% \par\endgroup
% 
% \switchcolumn
% \begingroup\sl
% As expected, this line is aligned to the first line of the paragraph in
% the column-2 as well as those in column-0 and 1.  It is also consistent
% the first lines including that of this paragraph are not indented because
% the \mctext{} is given by {\rm\!\subsection!|*|} which makes first
% paragraphs unindented.\\
% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\par
%
% After the page break we will have shortly, this column becomes the
% leftmost in the left \parapag{}e, as you are seeing now,
% \Marginpar{\sl Another marginal note from column-3.}
% but still outermost as well as the marginal note in the outside left
% margin.
% \endgroup
% \end{paracol}
% \Hrule
% 
% Now you are seeing yet another material placed only in the page in which
% the column-0 resides and thus being the right page now, i.e., this
% paragraph and the next one in the \postenv.  You might be disappointed by
% the fact the \emph{outside} pages, i.e., left in this page
% \pageref{page:ppts-paired2} and right in the previous page
% \pageref{sec:ppts-paired}, cannot have \pwstuff{} but it is what the
% author can do now for the version 1.3 and thus you have to wait some
% future versions in which the author could devise a mechanism to exploit
% the corresponding space in the pages\footnote{
% 
% You might complain the immaturity of \parapag{}ing and might claim that it
% should be included in \Paracol{} after the author implements the
% mechanism.  In fact the author himself is frustrated current features of
% \parapag{}ing but he dared to release the version 1.3 knowing that there
% are people who happily typeset their \parapag{}ed documents with the
% current limited features.}.
% 
% In addition, you might think it is weird that the |c| feature of
% \!\twosided! swaps columns \emph{and} paired pages.  However this swapping
% is a natural consequence of the combination of \cswap{} and \paired{}
% \parapag{}ing.  Therefore, you can simply disable the |c| feature (maybe
% together with other features) to have more intuitive results.
% 
% In the next Section~\ref{sec:ppts-npaired}, you will see another kind of
% \parapag{}ing namely \npaired{} one.  Before that, we need a blank page to
% let the \npaired{} \parapag{}ing start from an even-numbered page so that
% a left and right page pair comprises a double spread.  A short remark on
% the blank next page is that it does not have a right counterpart
% \parapag{}e because the page is outside \env{paracol} environments and does
% not have any portion from the environments\footnote{
% 
% To illustrate this fact, the author dares to put a real blank page rather
% than stepping the \counter{page} counter.}.
% 
% \newpage\vspace*{\fill}\centerline{(intentionally blanked page)}\vfill
% 
% 
% 
% \newpage
% \subsection{Example of Non-Paired Parallel-Paging}
% \label{sec:ppts-npaired}
% 
% This and following three pages are to show an example of \npaired{}
% \parapag{}ing, in which the author keeps the setting of \!\twosided!,
% \!\columnratio! and \!\marginparthreshold! unchanged.
% The arguments of \beginparacol{} for column population are also unchanged
% to have $2+2$ configuration, but the first argument is followed by |*| for
% \npaired{} typesetting.  That is, the environment below starts by
% \beginparacol|[2]*{4}|.  The contents of the environment is also almost
% same as the previous Section~\ref{sec:ppts-paired}, while
% \Emph{bold-faced} words show the difference from the \paired{}
% typesetting.
% 
% \columnratio{0.6}[0.5]
% \par\Hrule
% \begin{paracol}[2]*{4}
% This is the first paragraph of the leftmost column-0,
% \Marginpar{Marginal note from column-0.}
% whose first line has a marginal note placed in the \Emph{left} margin
% because the setting of \!\marginparthreshold! being 0 is still effective
% and we are in the \Emph{even}-numbered page
% \Emph{\pageref{sec:ppts-npaired}}.  Now we have a \!\switchcolumn! to the
% next column-1.
% 
% \switchcolumn
% \begingroup\it
% This is the first paragraph of the second and right column-1 in the left
% \parapag{}e.  We shortly give an italicized mar\-gin\-al note carefully, so
% that it does not conflict with the marginal note from the column-0.
% \Marginpar{\it Marginal note from column-1.}
% That is, now the author puts the note.  Now we
% have a \!\switchcolumn! to the next column-2.
% \par\endgroup
% \footnotetext*{This footnote is put in the left \parapag{}e together with
% another footnote below given in the column-2 in the right \parapag{}e.
% \label{fn:ppts-npaired1}}
% 
% \switchcolumn
% \begingroup\sf\label{page:ppts-npaired1r}
% This is the first paragraph of the column-2 being the left column of the
% right \parapag{}e.  \Emph{Since we are in the page next to} that column-0
% and 1 reside in, this page is numbered \Emph{\pageref{page:ppts-npaired1r}}
% because the left and right page is \Emph{\npaired}.  Therefore, the left
% margin of this page is narrower than the right margin because the page
% number is odd.
% 
% \footnotetext*{This footnote is \emph{not} put in the right \parapag{}e
% though it is given in the column-2 in the right \parapag{}e and thus its
% reference is in the column, of course.\label{fn:ppts-npaired2}}
% 
% You have to notice
% \Marginpar{\sf Marginal note from column-2.}
% the first paragraph does not start from the page top
% but above it we have some space of exactly same size as the \preenv{}
% shown in the left \parapag{}e.  Therefore, the top of the first paragraphs
% in all columns are aligned.  The marginal note given in the first line of
% this paragraph goes to the right margin of this page because of the
% \!\marginparthreshold! setting and the parity of this page.  Now we have a
% \!\switchcolumn! to the next column-3.
% \par\endgroup
% \begin{figure*}\nosv
% \def\arraystretch{0.8}
% \centerline{\begin{tabular}[b]{|c|}\hline
%     \hbox to.9\textwidth{}\\
%     \sf page-wise figure given in column-2\\
%     \\\hline
%     \end{tabular}}
% \caption{A Page-Wise Figure}
% \end{figure*}
% 
% \switchcolumn
% \begingroup\sl
% This is the first paragraph
% \Marginpar{\sl Marginal note from column-3.}
% in the last rightmost column-3 whose width is equal to that of the column-2.
% The marginal note given in the first line goes to right and does not
% conflict with that from the column-2.  We are now going back to the
% column-0 by a {\rm\!\switchcolumn!|*|} with a \mctext.
% \endgroup
% 
% \switchcolumn*[\subsection*{A Spanning Text: though this is wider than the
% page width, this text does not span the boundary between the left and
% right parallel-pages.}]
% 
% We have come back to this column-0.  The space above the \mctext{} is due
% to the \sync{}ation because two paragraphs in the column-2 are
% significantly taller in total than the paragraphs in other columns.  As
% the spanning text itself says, it cannot extend to the right \parapag{}e.
% The author puts dummy lines to go to the page bottom.\\
% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
% \Dotfill\\ \Dotfill\par
% 
% Now we will have a page break shortly.  You \Emph{will not} be surprised
% by seeing this column \Emph{is still in the left \parapag{}e after the
% break.}  This is because the feature |c| is \Emph{not effective in
% \npaired{} \parapag{}ing.}  The other feature |p| \Emph{consistently makes
% the left outside margins of this and the previous page in which this
% column resides} wider than the right inside margins.
% \label{page:ppts-npaired2}
% 
% \switchcolumn
% \begingroup\it
% We have restarted this column-1.  This paragraph has a
% footnote\footnotemark*[-1] as shown below.\\
% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\par
% 
% After the page break below, this column also \Emph{stays in the left page}
% together with the column-0
% \Marginpar{\it Another marginal note from column-1.}
% and is placed \Emph{inside (right)} in the page, as well as the marginal
% note in this \Emph{left} page \Emph{still} in the outside margin.
% \par\endgroup
% 
% \switchcolumn
% \begingroup\sf
% We have a few other materials not shown in right \parapag{}es.  The space
% above this paragraph is for the \mctext{} placed in the left \parapag{}e.
% The \Scfnote{} given here\footnotemark{} is also not in this page but in
% the left.  Finally, the author has put a page-wise figure spanning columns
% just before \!\switchcolumn! by which we left this column, but it will be
% in the \Emph{left} page \Emph{\pageref{page:ppts-npaired2}} together with
% column-0 and 1.\\
% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\par
% 
% Though the footnote numbered \Emph{\ref{fn:ppts-npaired2}} goes to the
% left page, its space and that of \Emph{\ref{fn:ppts-npaired1}} make this
% and the next columns shorter in the previous page.  Similarly, we have a
% space above for the page-wise figure shown in the \Emph{left} page.
% \par\endgroup
% 
% \switchcolumn
% \begingroup\sl
% As expected, this line is aligned to the first line of the paragraph in
% the column-2 as well as those in column-0 and 1.  It is also consistent
% the first lines including that of this paragraph are not indented because
% the \mctext{} is given by {\rm\!\subsection!|*|} which makes first
% paragraphs unindented.\\
% \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\ \Dotfill\\
% \Dotfill\\ \Dotfill\par
%
% After the page break we will have shortly, this column \Emph{is kept being
% the rightmost in the right \parapag{}e}, as you are seeing now,
% \Marginpar{\sl Another marginal note from column-3.}
% \Emph{and} still outermost as well as the marginal note in the outside
% \Emph{right} margin.
% \endgroup
% \end{paracol}
% \Hrule
% 
% As the \postenv{} in Section~\ref{sec:ppts-paired} is, this paragraph
% being the \postenv{} of the \npaired{} \parapag{}es appears only in the
% \parapag{}e in which the column-0 belongs to, and thus in the left
% \parapag{}e in this case.
% \endinput