You can create entries in the table of contents (TOC) when importing a PDF. Here is an example:
\documentclass{article}
\usepackage{pdfpages}
\begin{document}
\tableofcontents
\includepdf[pages=-,addtotoc={
1,section,1,First Section Entry,p1,
1,subsection,1,Subsection Entry,p2,
2,section,1,Second Section Entry,p3}]
{publishing-logo+layout.pdf}
\end{document}
Parameters for each TOC entry are:
- Page number relative to the first page of the included document. Caveat: with
pages={3-10}, the smallest possible number would be 3.
- Level for the TOC entry
- Depth of section (1 for section, 2 for subsection, etc.)
- TOC entry
- Label for the entry
You can create two entries for a single page on different levels (like section and subsection). In the example, the first two entries go to the same page. A label (like p2) can be used to refer to a page that is part of the included PDF.
Unfortunately error messages from pdfpages are not helpful when the above list contains errors. I encountered the following error, which was hard to spot:
- With
pages={3-10} the first entry in an addtotoc record must be 3 or larger. It was 1 in my case but the error message wasn't pointing to it.
\includepdf[pages=1-10, angle=90, pagecommand={}]{requirements/Requirements.pdf}
Add pagecommand={} as one of your options.
Best Answer
If the
pageslist contains{}, then packagepdfpagesinserts an empty page, e.g.:Or