feat(listof): add better support for List of ...

jdujava · jdujava · commit 3d8222ac32f3 · 2025-01-06T22:04:21.000+01:00
Signed-off-by: Jonas Dujava &lt;jonas.dujava@gmail.com&gt;
diff --git a/chapters/Features.tex b/chapters/Features.tex
@@ -286,7 +286,7 @@ \subsection{Structure Environments}%
     PRs welcome.
 \end{Note}
 
-\subsection{References, Links}%
+\subsection{References and Links}%
 \label{sub:References Links}
 \fileTeXtured{preamble/hacks/custom-reference-boxes.tex}
 
@@ -309,16 +309,20 @@ \subsection{References, Links}%
     This behavior is adapted in \TeXtured{} with the macro of the same name \custommacro{\Cref}.
 \end{remark}
 
-\subsection{Table of Contents, Index}%
+\subsection{Table of Contents and Outline/Index}%
 \label{sub:Table of Contents and Index}
 \fileTeXtured{preamble/layout/toc.tex}
 
 Clear and elegant Table of Contents, which includes all of the important parts --- also (unnumbered) subsections, but in a more compact style.
 
-Similarly, automatically populate the Index (digital Table of Contents in PDF viewer).
+Similarly, automatically populate the PDF Outline/Index (digital Table of Contents in PDF viewer).
 It is very handy for navigating longer documents, and includes also other important pages other than just initial pages of main chapters: Title Page, Contents, Introduction, References, and so on.
 \begin{remark}
-    I use \texttt{Zathura} as my PDF viewer, with the Index just one \macro{Tab} away, allowing me to quickly jump to the desired part of the document.
+    I use \texttt{Zathura} as my PDF viewer, with the Outline/Index just one \macro{Tab} away, allowing me to quickly jump to the desired part of the document.
+\end{remark}
+
+\begin{remark}[List of Figures, Tables, \ldots{}]
+    If you want/need to include a List of Figures, List of Tables, and so on, you can easily do so by uncommenting the relevant lines in the \custommacro{\contentsandlists} macro.
 \end{remark}
 
 
@@ -498,11 +502,6 @@ \subsection{Footnotes}%
           \end{itemize}
 \end{itemize}
 
-\subsection{List of Figures, List of ...}%
-\label{sub:List of Figures List of ...}
-
-Don't really see the point, but one is free to include it.
-
 \subsection{Index, Glossary}%
 \label{sub:Index Glossary}
 
diff --git a/preamble/layout/toc.tex b/preamble/layout/toc.tex
@@ -1,10 +1,20 @@
 %% Table of Contents
 % \addtocontents{toc}{\vspace{-0.9em}}  % change space after "Contents" title in TOC
-\NewDocumentCommand{\contents}{}{
+\NewDocumentCommand{\contentsandlists}{}{
     {\hypersetup{hidelinks}
         \tableofcontents
-        % \listoftheorems[title=List of Definitions and Theorems, onlynamed, swapnumber]
+
+        %% Add list of structure environments
+        %%  -> see `thmtools` package for more customization
+        % \DeclareExpandableDocumentCommand{\listtheoremname}{}{List of Definitions, Remarks, \ldots}
+        % \cleardoublepage\phantomsection
+        % \currentpdfbookmark{\listtheoremname}{loe} % add PDF Index/Outline entry
+        % \listoftheorems[onlynamed, swapnumber]
+
+        %% Add list of figures and tables
+        %%  -> see `tocbibind` package (or maybe also `titletoc`)
         % \listoffigures
+        % \listoftables
     }
 }
 
diff --git a/thesis.tex b/thesis.tex
@@ -50,7 +50,7 @@
 % \include{frontmatter/dedication}
 % \include{frontmatter/information}
 
-\contents
+\contentsandlists
 
 \include{chapters/Introduction}
 \include{chapters/QuickSummary}
