[Tex/LaTex] How to add leaders to Table of Contents without tocloft

table of contentstitletoctoclofttocstyle

I'm using a third-party non-standard document class which is based on book. Class be damned, I want to add dot leaders for chapters, sections and subsections in the Table of Contents. If I include tocloft, it changes the layout of the Table of Contents in undesirable ways. It also seems that the tocstyle package is for switching high-level styles, etc.

So I would like to add dot leaders without radically changing the layout of the ToC. Does anyone know how this might be acheived?

I also looked into the titletoc package which doesn't change the original ToC layout. However, the only way I could find to add a leader would be to use the following:

 \titlecontents{<section>}[<left>]{<above>}{<before with label>}{<before without label>}{<filler and page>}[<after>]

I could just insert leader into the filler option, but I would have to redefine the entire style of the ToC to achieve this.

I'm embarrassed to say I've been at this about an hour (LaTeX humbles you sometimes I guess). All answers I've found through Google just say to use tocloft. Wondering if anyone has a better idea?

Best Answer

book defines the ToC-related sectioning commands as follows:

\newcommand*\l@chapter[2]{%
  \ifnum \c@tocdepth >\m@ne
    \addpenalty{-\@highpenalty}%
    \vskip 1.0em \@plus\p@
    \setlength\@tempdima{1.5em}%
    \begingroup
      \parindent \z@ \rightskip \@pnumwidth
      \parfillskip -\@pnumwidth
      \leavevmode \bfseries
      \advance\leftskip\@tempdima
      \hskip -\leftskip
      #1\nobreak\hfil \nobreak\hb@xt@\@pnumwidth{\hss #2}\par
      \penalty\@highpenalty
    \endgroup
  \fi}
\newcommand*\l@section{\@dottedtocline{1}{1.5em}{2.3em}}
\newcommand*\l@subsection{\@dottedtocline{2}{3.8em}{3.2em}}
\newcommand*\l@subsubsection{\@dottedtocline{3}{7.0em}{4.1em}}
\newcommand*\l@paragraph{\@dottedtocline{4}{10em}{5em}}
\newcommand*\l@subparagraph{\@dottedtocline{5}{12em}{6em}}

The above boils down to adding a dotted ToC line for \section, \subsection, \subsubsection, \paragraph and \subparagraph (if allowed in the ToC; set via tocdepth). It doesn't for \chapter though. However, the definition of \@dottedtocline can be worked into \l@chapter. Here's the definition, taken from latex.ltx:

\def\@dottedtocline#1#2#3#4#5{%
  \ifnum #1>\c@tocdepth \else
    \vskip \z@ \@plus.2\p@
    {\leftskip #2\relax \rightskip \@tocrmarg \parfillskip -\rightskip
     \parindent #2\relax\@afterindenttrue
     \interlinepenalty\@M
     \leavevmode
     \@tempdima #3\relax
     \advance\leftskip \@tempdima \null\nobreak\hskip -\leftskip
     {#4}\nobreak
     \leaders\hbox{$\m@th
        \mkern \@dotsep mu\hbox{.}\mkern \@dotsep
        mu$}\hfill
     \nobreak
     \hb@xt@\@pnumwidth{\hfil\normalfont \normalcolor #5}%
     \par}%
  \fi}

which leads to the following choice for \l@chapter:

\renewcommand*\l@chapter[2]{%
  \ifnum \c@tocdepth >\m@ne
    \addpenalty{-\@highpenalty}%
    \vskip 1.0em \@plus\p@
    \setlength\@tempdima{1.5em}%
    \begingroup
      \parindent \z@ \rightskip \@pnumwidth
      \parfillskip -\@pnumwidth
      \leavevmode \bfseries
      \advance\leftskip\@tempdima
      \hskip -\leftskip
      #1\nobreak
      \xleaders\hbox{$\m@th
        \mkern \@dotsep mu\hbox{.}\mkern \@dotsep
        mu$}\hfill%
      \nobreak\hb@xt@\@pnumwidth{\hss #2}\par
      \penalty\@highpenalty
    \endgroup
  \fi}

Here's a complete MWE:

enter image description here

\documentclass{book}

\makeatletter
\renewcommand*\l@chapter[2]{%
  \ifnum \c@tocdepth >\m@ne
    \addpenalty{-\@highpenalty}%
    \vskip 1.0em \@plus\p@
    \setlength\@tempdima{1.5em}%
    \begingroup
      \parindent \z@ \rightskip \@pnumwidth
      \parfillskip -\@pnumwidth
      \leavevmode \bfseries
      \advance\leftskip\@tempdima
      \hskip -\leftskip
      #1\nobreak
      \xleaders\hbox{$\m@th
        \mkern \@dotsep mu\hbox{.}\mkern \@dotsep
        mu$}\hfill%
      \nobreak\hb@xt@\@pnumwidth{\hss #2}\par
      \penalty\@highpenalty
    \endgroup
  \fi}
\renewcommand*\l@section{\@dottedtocline{1}{1.5em}{2.3em}}
\renewcommand*\l@subsection{\@dottedtocline{2}{3.8em}{3.2em}}
\renewcommand*\l@subsubsection{\@dottedtocline{3}{7.0em}{4.1em}}
\renewcommand*\l@paragraph{\@dottedtocline{4}{10em}{5em}}
\renewcommand*\l@subparagraph{\@dottedtocline{5}{12em}{6em}}
\makeatother

\begin{document}
\tableofcontents
\chapter{First chapter}
\section{First section}
\subsubsection{A subsubsection}
\section{Second section}
\section{Last section}
\chapter{Second chapter}
\section{First section}
\section{Second section}
\section{Last section}
\chapter{Last chapter}
\section{First section}
\section{Second section}
\section{Last section}
\end{document}

I've used \xleaders instead of \leaders, but this may be a personal preference. See a discussion on the difference at Want to fill line with repeating string.

Related Solutions

[Tex/LaTex] Customization of chapter entries in Table of Contents

The tocloft package indeed provides lots of handy macros to shape nearly every aspect of the appearance of the table of contents (and of the lists of figures and tables too).

Once the tocloft package is loaded in the preamble

\usepackage{tocloft}

you'd issue the command

\renewcommand{\cftchapleader}{\cftdotfill{\cftdotsep}}

to enable dot leaders for chapter-level entries in the ToC.

To get normal-weight (non-bold) chapter-level entries and page numbers, you'd issue the commands

\renewcommand{\cftchapfont}{\mdseries}
\renewcommand{\cftchappagefont}{\mdseries}

Additional comment: Without the tocloft package, LaTeX will start the ToC on an odd-numbered page. With the tocloft package loaded, the default is to start the ToC on the next available page, regardless of whether it's odd-numbered (aka "recto") or even-numbered ("verso"). If you want to restore the basic-LaTeX method, be sure to specify the option titles when loading the package:

\usepackage[titles]{tocloft}

A side-effect of this setup, though, is that you could no longer use the package's macros (cf. subsection 2.2 of the user guide) to influence the appearance of the headers of the ToC, the LoF, and the LoT.

[Tex/LaTex] Cover pages for References, Appendix; fit them nicely in TOC

Since you are already using the package appendix, there is a very simple way.

First of all, let's define a new environment that behaves like appendices, but inserts a page for references (with uppercase letters and normal size font):

\newenvironment{references}{%
\renewcommand{\appendixtocname}{\bibname}%
\renewcommand{\appendixpagename}{\MakeUppercase{\normalsize\bibname}}%
\appendices}{%
\endappendices}

When you call your bibliography, you have to encase it inside the references environment:

\begin{references}
\bibliography{test}
\end{references}

Of course, you have to tell tocbibind that you don't want an entry for the bibliography in the ToC, otherwise you would have two entries:

\usepackage[nottoc,notbib]{tocbibind}

MWE:

\documentclass[oneside]{book}

\usepackage{titlesec}
\usepackage[nottoc,notbib]{tocbibind}
\usepackage{blindtext}

\usepackage[toc,page]{appendix}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%  For TOCLOFT
%
\usepackage{tocloft}

\makeatletter
\renewcommand{\@tocrmarg}{2.75em}
\makeatother

% Change format and legend of title of page

%  "Table of Contents", centered and in all caps.
\setlength{\cftbeforetoctitleskip}{0.5in}
\setlength{\cftaftertoctitleskip}{0.2in}

\renewcommand{\contentsname}{Table of Contents}
\renewcommand{\cfttoctitlefont}{\hfill\MakeUppercase}
\renewcommand{\cftaftertoctitle}{\hfill}


% "listofTables", centered and all in caps.
\renewcommand{\cftlottitlefont}{\hfill\MakeUppercase}
\renewcommand{\cftafterlottitle}{\hfill}
%\renewcommand{\cftafterlottitle}{%
%     \hfill \\[\baselineskip]\mbox{}Table\hfill Page}


%  "List of Figures", centered and all in caps.
\setlength{\cftbeforeloftitleskip}{0.5in}
\setlength{\cftafterloftitleskip}{0.2in}

\renewcommand{\cftloftitlefont}{\hfill\MakeUppercase}
\renewcommand{\cftafterloftitle}{\hfill}
%\renewcommand{\cftafterloftitle}{\hfill\\[\baselineskip]\mbox{}Figure\hfill Page}


%\renewcommand{\cftafterloftitle}{\hfill}

% Change typesetting of chapter lines in TOC:%%%%%%%%%%%%%%%%%

%  Create lead of dots for chapters
\renewcommand{\cftchapleader}{\cftdotfill{\cftdotsep}}


\setlength{\cftbeforechapskip}{0em}
\renewcommand{\cftchapfont}{\scshape}
%\renewcommand{\cftchapleader}{\bfseries\cftdotfill{\cftchapdotsep}}
% Formats chapter page number as normal -- otherwise it woudl be bold.
\renewcommand{\cftchappagefont}{\normalfont}

%  Get the Roman number for chapters to align...
%  This comes from tocloft manual page 11.
\setlength{\cftchapnumwidth}{3em}
\newlength{\mylen}
\settowidth{\mylen}{\cftchappresnum\cftchapaftersnum} % extra space
\addtolength{\cftchapnumwidth}{\mylen} % add the extra space
\setlength{\mylen}{1.5em}
\renewcommand{\cftchappresnum}{\hfill}
% add a dot there
\renewcommand{\cftchapaftersnum}{.\hspace*{\mylen}}
\addtolength{\cftchapnumwidth}{\mylen}

% Change typesetting of section in TOC:%%%%%%%%%%%%%%%%%%%
\renewcommand{\cftsecfont}{\scshape}
\setlength{\cftsecindent}{6em}



% Typesetting for subsections. %%%%%%%%%%%%%%%%%%%%%%

\setlength{\cftsubsecindent}{7.5em}


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%    For bibliography, nifty chunk from an example by Gonzalo Medina.

\usepackage{apacite}
\usepackage{natbib}

\usepackage{filecontents}

\begin{filecontents}{test.bib}
@article{author99,
title = {A fine title},
year = {1899},
author = {An Author and Another Bauthor and Yeta Cauthor},
journal = {Madness}
}
@article{author05,
title = {The best title},
year = {1905},
author = {An Author and More Dauthors and Whois Thisauthor and Heis Thatauthor},
journal = {Insanity}
}
\end{filecontents}

\bibliographystyle{apacite}

\newenvironment{references}{%
\renewcommand{\appendixtocname}{\bibname}%
\renewcommand{\appendixpagename}{\MakeUppercase{\normalsize\bibname}}%
\appendices}{%
\endappendices}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%   Document

\begin{document}

\tableofcontents

\blinddocument

The time has come for all good men to come to the aid of their country test
 \citep{author05}.  According to \citet{author05}, the time has come for all good men to come to the aid of their country.

\chapter{that}

\begin{references}
\bibliography{test}
\end{references}

\begin{appendices}
\blinddocument
\end{appendices}
\end{document}

Output (ToC):

enter image description here

Output (References):

enter image description here

Best Answer

Related Solutions

[Tex/LaTex] Customization of chapter entries in Table of Contents

[Tex/LaTex] Cover pages for References, Appendix; fit them nicely in TOC

Related Question