summaryrefslogtreecommitdiff
path: root/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-tocbibind.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-doc/doc/english/FAQ-en/html/FAQ-tocbibind.html')
-rw-r--r--Master/texmf-doc/doc/english/FAQ-en/html/FAQ-tocbibind.html47
1 files changed, 47 insertions, 0 deletions
diff --git a/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-tocbibind.html b/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-tocbibind.html
new file mode 100644
index 00000000000..07e29769786
--- /dev/null
+++ b/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-tocbibind.html
@@ -0,0 +1,47 @@
+<head>
+<title>UK TeX FAQ -- question label tocbibind</title>
+</head><body>
+<h3>Bibliography, index, etc., in TOC</h3>
+<p>The standard LaTeX classes (and many others) use <code>\</code><code>section*</code> or
+<code>\</code><code>chapter*</code> for auto-generated parts of the document (the tables of
+contents, lists of figures and tables, the bibliography and the index). As a
+result, these items aren't numbered (which most people don't mind),
+and (more importantly) they don't appear in the table of contents.
+<p>The correct solution (as always) is to have a class of your own that
+formats your document according to your requirements. The macro to do
+the job (<code>\</code><code>addcontentsline</code>) is fairly simple, but there is always
+an issue of ensuring that the contents entry quotes the correct page.
+Supposing that our the document is chapter-based (class <i>report</i>
+or <i>book</i>, for example), the text:
+<blockquote>
+<pre>
+\bibliography{frooble}
+\addcontentsline{toc}{chapter}{Bibliography}
+</pre>
+</blockquote>
+will produce the <em>wrong</em> answer if the bibliography is more than
+one page long. Instead, one should say:
+<blockquote>
+<pre>
+\cleardoublepage
+\addcontentsline{toc}{chapter}{Bibliography}
+\bibliography{frooble}
+</pre>
+</blockquote>
+(Note that <code>\</code><code>cleardoublepage</code> does the right thing, even if your
+document is single-sided - in that case, it's a synonym for
+<code>\</code><code>clearpage</code>). Ensuring that the entry refers to the right place is
+trickier still in a <code>\</code><code>section</code>-based class.
+<p>The common solution, therefore, is to use the <i>tocbibind</i>
+package, which provides many facilities to control the way these
+entries appear in the table of contents.
+<p>Classes of the <i>KOMA-script</i> bundle provide this functionality
+as a set of class options; the <i>memoir</i> class includes
+<i>tocbibind</i> itself.
+<dl>
+<dt><tt><i>KOMA script bundle</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/koma-script.zip">macros/latex/contrib/koma-script</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/koma-script.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/koma-script/">browse</a>)
+<dt><tt><i>memoir.cls</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/memoir.zip">macros/latex/contrib/memoir</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/memoir.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/memoir/">browse</a>)
+<dt><tt><i>tocbibind.sty</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/tocbibind.zip">macros/latex/contrib/tocbibind</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/tocbibind.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/tocbibind/">browse</a>)
+</dl>
+<p><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tocbibind">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tocbibind</a>
+</body>