summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-epigraph.html
blob: eec51dad4d0f567e540ed32a2169dcdca76e4ea1 (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
<head>
<title>UK TeX FAQ -- question label epigraph</title>
</head><body>
<h3>Typesetting epigraphs</h3>
<p/>Epigraphs are those neat quotations that authors put at the start of
chapters (or even at the end of chapters: Knuth puts things at the
ends of chapters of the TeXbook).
<p/>Typesetting them is a bit of a fiddle, but not impossible to do for
yourself.  Fortunately, there are two packages that do the job, to
some extent; there are also facilities in the two &ldquo;big&rdquo; classes
(<i>memoir</i> and <i>koma-script</i>.
<p/>The <i>epigraph</i> package defines an <code>\</code><code>epigraph</code> command, for
creating a single 
epigraph (as at the top of a chapter):
<blockquote>
<pre>
\chapter{The Social Life of Rabbits}
\epigraph{Oh!  My ears and whiskers!}%
         {Lewis Carroll}
</pre>
</blockquote><p>
and an epigraphs environment, for entering more than one epigraph
consecutively, in a sort of list introduced by <code>\</code><code>qitem</code> commands:
<blockquote>
<pre>
\begin{epigraphs}
\qitem{What I tell you three times is true}%
      {Lewis Carroll}
\qitem{Oh listen do, I'm telling you!}%
      {A.A. Milne}
\end{epigraphs}
</pre>
</blockquote><p>
The <code>\</code><code>epigraphhead</code> command enables you to place your epigraph
<em>above</em> a chapter header:
<blockquote>
<pre>
\setlength{\unitlength}{1pt}
...
\chapter{The Social Life of Rabbits}
\epigraphhead[&lt;distance&gt;]{%
  \epigraph{Oh!  My ears and whiskers!}%
           {Lewis Carroll}%
}
</pre>
</blockquote><p>
The &lt;<i>distance</i>&gt; says how far above the chapter heading the
epigraph is to go; it&rsquo;s expressed in terms of the <code>\</code><code>unitlength</code>
that&rsquo;s used in the <code>picture</code> environment; the package&rsquo;s
author recommends <code>70pt</code>.
<p/>The package also offers various tricks for adjusting the layout of
chapter header (necessary if you&rsquo;ve found a hugely long quotation for
an <code>\</code><code>epigraphhead</code>), for patching the bibliography, for patching
<code>\</code><code>part</code> pages, and so on.  (Some of these suggested patches lead you
through writing your own package...)
<p/>The <i>quotchap</i> package redefines chapter headings (in a
moderately striking way), and provides an environment
<code>savequotes</code> in which you can provide one (or more)
quotations to use as epigraphs.  The facilities seem not as flexible
as those of <i>epigraph</i>, but it&rsquo;s probably easier to use.
<p/>The <i>memoir</i> class offers all the facilities of the
<i>epigraph</i> package.  The <i>Koma-script</i> classes have
commands <code>\</code><code>setchapterpreamble</code> and <code>\</code><code>dictum</code> to provide these
facilities.
<dl>
<dt><tt><i>epigraph.sty</i></tt><dd><a href="http://www.tex.ac.uk/www.tex.ac.uk  tex-archive/macros/latex/contrib/epigraph.zip">macros/latex/contrib/epigraph</a> (or <a href="http://www.tex.ac.uk/www.tex.ac.uk  tex-archive/macros/latex/contrib/epigraph/">browse the directory</a>)
<dt><tt><i>KOMA script bundle</i></tt><dd><a href="http://www.tex.ac.uk/www.tex.ac.uk  tex-archive/macros/latex/contrib/koma-script.zip">macros/latex/contrib/koma-script</a> (or <a href="http://www.tex.ac.uk/www.tex.ac.uk  tex-archive/macros/latex/contrib/koma-script/">browse the directory</a>)
<dt><tt><i>memoir.cls</i></tt><dd><a href="http://www.tex.ac.uk/www.tex.ac.uk  tex-archive/macros/latex/contrib/memoir.zip">macros/latex/contrib/memoir</a> (or <a href="http://www.tex.ac.uk/www.tex.ac.uk  tex-archive/macros/latex/contrib/memoir/">browse the directory</a>)
<dt><tt><i>quotchap.sty</i></tt><dd><a href="http://www.tex.ac.uk/www.tex.ac.uk  tex-archive/macros/latex/contrib/quotchap.zip">macros/latex/contrib/quotchap</a> (or <a href="http://www.tex.ac.uk/www.tex.ac.uk  tex-archive/macros/latex/contrib/quotchap/">browse the directory</a>)
</dl>
<p/>
<p/>







<p/>















<p/><p/><p/><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=epigraph">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=epigraph</a>
</body>