[Tex/LaTex] Generate a List of Appendices page for report class

appendicesappendixliststable of contents

So it seems like this question has been asked many times over, however, I have found none of the existing solutions are particularly satisfactory for my situation, as they either force other unneeded functionality, or they break existing aspects of my TeX document.

I am using the report class and I simply want to be able to add a single, separate page (i.e. starting on its own page) to list out the appendices. I want the page to have a left-justified title "List of Appendices", followed by each appendix item which has dots leading to the page number (the same look and feel of the List of Tables and List of Figures). In addition, I also want to have only the ToC item "Appendices" listed in the Table of Contents, and not each of the actual Appendix sub-items.

Here is what I have so far for creating an appendix and trying to hide the sub-items from the ToC. I really need some guidance on how to create a \listofappendices. I'm also noticing the Appendix page numbering in the rendered PDF is not alphabetic like the package documentation suggests it should be; see here.

\documentclass{report}

\usepackage{appendix}
\usepackage{hyperref}

\title{Here is my title}
\author{Name Name}
\date{October 1, 2019}

\begin{document}

\maketitle
\tableofcontents
\listoftables
\listoffigures
% what I want \listofappendices

\chapter{Introduction}
Here is some content...

\appendix
\addappheadtotoc
\addtocontents{toc}{\protect\setcounter{tocdepth}{-1}}

\chapter{First Appendix}
Here is my appendix content...

\chapter{Second Appendix}
Here is my appendix content...

\end{document}

I am not very expert when it comes to LaTeX, so any and all help is much appreciated.

Best Answer

Here is a suggestion using package scrwfile:

\documentclass{report}
\usepackage{blindtext}% only for dummy text
\usepackage{scrwfile}

\usepackage{hyperref}

\TOCclone[List of Appendices]{toc}{atoc}
\addtocontents{atoc}{\protect\value{tocdepth}=-1}
\newcommand\listofappendices{\listofatoc}

\newcommand*\savedtocdepth{}
\AtBeginDocument{%
  \edef\savedtocdepth{\the\value{tocdepth}}%
}

\let\originalappendix\appendix
\renewcommand\appendix{%
  \originalappendix
  \cleardoublepage
  \addcontentsline{toc}{chapter}{\appendixname}%
  \addtocontents{toc}{\protect\value{tocdepth}=-1}%
  \addtocontents{atoc}{\protect\value{tocdepth}=\savedtocdepth}%
}

\title{Here is my title}
\author{Name Name}
\date{October 1, 2019}

\begin{document}
\maketitle
\tableofcontents
\listoftables
\listoffigures
\listofappendices

\blinddocument

\appendix
\chapter{First Appendix}
Here is my appendix content
\chapter{Second Appendix}
Here is my appendix content
\blinddocument
\end{document}

Result:

Related Solutions

[Tex/LaTex] List of Appendices

Rooting through the cls file in the link posted above, I tried to dissect the following block, which looked rather promising:

\newcommand\listofappendices{%
    \@chapteronefalse
    \if@arabic\relax\else\renewcommand{\thepage}{\roman{page}}\fi
    \if@twocolumn
      \@restonecoltrue\onecolumn
    \else
      \@restonecolfalse
    \fi
    \chapteruaf*{\listappname
      \@mkboth{\uppercase{\listappname}}%
              {\uppercase{\listappname}}}%
    \@chapteronetrue
    %% get this in contents as a section
    \addcontentsline{toc}{section}{\listappname}
    \@starttoc{loa}%
    \if@restonecol\twocolumn\fi
    \newpage\renewcommand{\thepage}{\arabic{page}}}

Basically, I realized that this command was setting up the List of Appendices for me, all I needed was a way to automatically populate it, instead of manually adding entries to the loa file.

At the head of each Appendix:

\chapter*{This is the first appendix}
\addcontentsline{loa}{appendix}{This is the entry for the first appendix in the List of Appendices}

The \chapter* suppresses a TOC entry for the appendix, while the \addcontentsline adds the entry to the LOA file. To get the style to match, I added the following line to the end of the code block in the cls file:

\newcommand\l@appendix{\@dottedtocline{1}{1.5em}{2.3em}}

Works perfectly now, and I don't have to worry about manually creating the List of Appendices every time I build my document.

[Tex/LaTex] List of appendices without chapter titles

Here is an idea:

\newcommand{\startappendix}{%
\pagebreak%
\addcontentsline{toc}{chapter}{Appendices}%
\fancyhead[L]{{\bfseries Appendices}}%
\setcounter{section}{0}%
\renewcommand{\thesection}{\Alph{section}}%
}

\newenvironment{newappendix}[2]%
{\gdef\headername{#1}%
\phantomsection%
\refstepcounter{section}%
\addcontentsline{toc}{section}{Appendix \thesection~- #1}%
\label{app:#2}}
{\fancyhead[R]{Appendix \thesection~- \headername}
\newpage}

Add these two commands in your preamble. The first one should be used when you want to start your appendices. The second one is to use each time you want to change the name of the current appendix. The first argument is the name of the appendix and the second is what will be added the the app: prefix for the label. You can then call the appendix with the \ref{app:<your second argument>} wherever you want in your code.

Example

Here is a short example of the code and its output

\documentclass{report}
\usepackage[demo]{graphicx}
\usepackage{hyperref}
\usepackage{fancyhdr}
\pagestyle{fancy}

\newcommand{\startappendix}{%
\pagebreak%
\addcontentsline{toc}{chapter}{Appendices}%
\fancyhead[L]{{\bfseries Appendices}}%
\setcounter{section}{0}%
\renewcommand{\thesection}{\Alph{section}}%
}

\newenvironment{newappendix}[2]%
{\gdef\headername{#1}%
\phantomsection%
\refstepcounter{section}%
\addcontentsline{toc}{section}{Appendix \thesection~- #1}%
\label{app:#2}}
{\fancyhead[R]{Appendix \thesection~- \headername}
\newpage}

\begin{document}
\tableofcontents

\chapter{One}
\section{One-one}

\startappendix

\begin{newappendix}{First}{1}
\includegraphics[width=12cm,height=15cm]{test}
\end{newappendix}

\begin{newappendix}{Second}{2}
\includegraphics[width=12cm,height=15cm]{test}
\end{newappendix}

\end{document}

Table of contents

First appendix

EDIT Another way to go I found thanks to egreg for the second command:

\fancyhead[R]{Appendix \rightmark}

\newcommand{\newappendix}[2]{%
  \clearpage%
  \phantomsection%
  \refstepcounter{section}%
  \addcontentsline{toc}{section}{Appendix \thesection~- #1}%
  \markright{\thesection \ -- #1}%
  \label{app:#2}
}

Best Answer

Related Solutions

[Tex/LaTex] List of Appendices

[Tex/LaTex] List of appendices without chapter titles

Related Question