summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/paracol/README
blob: 23bb01426843b6708a63aabe636dcc0d14bf3137 (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
paracol (v1.22): a multi-column package to typeset columns in "parallel".
===
Copyright (C) 2005-2013
  Hiroshi Nakashima <h.nakashima@DOMAIN;  DOMAIN=media.kyoto-u.ac.jp>
  (Kyoto Univerisity)
This package can be redistributed and/or modified under the terms
of the LaTeX Project Public License distributed from CTAN
archives in directory macros/latex/base/lppl.txt; either
version 1 of the License, or any later version.
===

[Contents]

- README ............ this document
- paracol.ins ....... for docstrip
- paracol.dtx ....... main dtx for manual and implementation document
- man.dtx ........... source of Section 1 to 6 of user's manual
- ref.dtx ........... source of Section 7 of user's manual
- scfnote.dtx ....... source of Section 8 of user's manual
- impl.dtx .......... source of implementation document
- paracol-man.pdf ... PDF of user's manual

[How to "make"]

  % tex paracol.ins     # you'll have paracol.sty and paracol-man.tex

# to have user's manual (its PDF is included in the distribution)
  % latex paracol-man
  % latex paracol-man   # you need do it twice to make index correct.
  % makeindex -s gind.ist -o paracol-man.ind paracol-man.idx
  % latex paracol-man

# to have implementation document
  % latex paracol.dtx
  % latex paracol.dtx   # you need do it twice to make index correct.
  % makeindex -s gind.ist -o paracol.ind paracol.idx
  % makeindex -s gglo.ist -o paracol.gls paracol.glo
  % latex paracol.dtx

Note that if you want LaTeXing paracol-man.tex and/or paracol.dtx,
you need newvbtm.sty being also available in CTAN.

[Features]

+ "paracol" environment in which you may "switch" and "synchronize columns
  by \switchcolumn(*).

+ "column", "nthcolumn", "leftcolumn" and "rightcolumn" environments used in
  "paracol" to enclose texts to appear in a column.

+ Counters are "local" to each column in default but you may make some of
  them global to all columns by \globalcounter{<ctr>}.

+ \definethecounter{<ctr>}{<col>}{<rep>} to give <ctr> its <rep>resentaion
  specific to <col>-th column.

+ \addcontentsonly{<file>}{<col>} to allow contents output for <file> only
  from <col> (new for v1.00).

+ \columnratio{<r_0>,<r_1>,...} to control the width of each column rather
  than splitting columns evenly (new for v1.1).

- \columncolor[<mode>]{<color>}[<col>] to give the default <color> (with
  <mode>) to the column <col> (*NEW* for v1.2).

- \singlecolumnfootnotes and \mergedfootnotes to gather footnotes in all
  columns and typeset them single-columned (*NEW* for v1.2).

- \swapcolumninevenpages to reverse the printing order of columns in even
  numberred pages (*NEW* for v1.2).

- A few bugs fixed in v1.21 and v1.22.

Enjoy!

Hiroshi Nakashima <h.nakashima@DOMAIN;  DOMAIN=media.kyoto-u.ac.jp>