summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ftncapt.html
blob: 44686d0708a7656447d2f2d89dca87c3905b54ed (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
<head>
<title>UK TeX FAQ -- question label ftncapt</title>
</head><body>
<h3>Footnotes in captions</h3>
<p/>Footnotes in captions are especially tricky: they present problems of
their own, on top of the problems one experiences with
<a href="FAQ-ftnsect.html">footnotes in section titles</a> (footnotes migrating to
to the list of figures or tables, or 
<a href="FAQ-extrabrace.html">apparently random errors</a> because
<code>\</code><code>footnote</code> is a fragile command), and with 
<a href="FAQ-footintab.html">footnotes in tables</a> (typically, the footnote
simply disappears).  Fortunately, the requirement for footnotes in
captions is extremely rare: if you are experiencing problems, it is
worth reviewing what you are trying to say by placing this footnote:
other options are to place text at the bottom of the float, or to
place a footnote at the point where you refer to the float.
<p/>Note that the <i>threeparttable</i> scheme (see, again, 
<a href="FAQ-footintab.html">footnotes in tables</a>) also applies
to notes in captions, and may very well be preferable to whatever you
were thinking of.
<p/>If you <em>are</em> going to proceed:
<ul>
<li> use an optional argument in your <code>\</code><code>caption</code> command, that
  doesn&rsquo;t have the footnote in it; this prevents the footnote
  appearing in the &ldquo;List of &hellip;&rdquo;, and
<li> put your whole float in a <code>minipage</code> so as to keep
  the footnotes with the float.
</ul>
so we have:
<blockquote>
<pre>
\begin{figure}
  \begin{minipage}{\textwidth}
    ...
    \caption[Caption for LOF]%
      {Real caption\footnote{blah}}
  \end{minipage}
\end{figure}
</pre>
</blockquote><p>
However, <em>as well as</em> all of the above, one <em>also</em> has to
deal with the tendency of the <code>\</code><code>caption</code> command to produce the
footnote&rsquo;s text twice.  For this last problem, there is no tidy
solution this author is aware of.
<p/>If you&rsquo;re suffering the problem, a well-constructed <code>\</code><code>caption</code>
command in a <code>minipage</code> environment within a float (as
in the example above) can produce <em>two</em> copies of the footnote
body &ldquo;blah&rdquo;. (In fact, the effect only occurs with captions that are
long enough to require two lines to be typeset, and so wouldn&rsquo;t appear
with such a short caption as that in the example above.)
<p/>The documentation of the <i>ccaption</i> package describes a really
rather awful work-around for this problem.
<dl>
<dt><tt><i>ccaption.sty</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/ccaption.zip">macros/latex/contrib/ccaption</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/ccaption/">browse the directory</a>)
<dt><tt><i>threeparttable.sty</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/misc/threeparttable.sty">macros/latex/contrib/misc/threeparttable.sty</a>
</dl>
<p/><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=ftncapt">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=ftncapt</a>
</body>