Cómo añadir una tabla de contenidos en C#

¿Qué código necesito para generar el índice?

:path=/static-assets/pdf/content-code-examples/how-to/table-of-contents.cs

using IronPdf;

// Instantiate Renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Configure render options
renderer.RenderingOptions = new ChromePdfRenderOptions
{
    // Enable table of content feature
    TableOfContents = TableOfContentsTypes.WithPageNumbers,
};

PdfDocument pdf = renderer.RenderHtmlFileAsPdf("tableOfContent.html");

pdf.SaveAs("tableOfContents.pdf");

Para situaciones más avanzadas, puede combinar el índice con otras opciones de presentación para crear documentos PDF completos:

using IronPdf;

// Create renderer with multiple options
ChromePdfRenderer renderer = new ChromePdfRenderer();
renderer.RenderingOptions = new ChromePdfRenderOptions
{
    // Enable table of contents with page numbers
    TableOfContents = TableOfContentsTypes.WithPageNumbers,

    // Add margins for better formatting
    MarginTop = 40,
    MarginBottom = 40,

    // Enable JavaScript for dynamic content
    EnableJavaScript = true,

    // Set paper orientation
    PaperOrientation = PdfPaperOrientation.Portrait,

    // Add first page number offset
    FirstPageNumber = 1
};

 // Convert HTML with multiple header levels
string htmlContent = @"
<h1>Introduction</h1>
<p>Welcome to our comprehensive guide...</p>

<h2>Chapter 1: Getting Started</h2>
<p>Let's begin with the basics...</p>

<h3>1.1 Prerequisites</h3>
<p>Before we start, ensure you have...</p>

<h2>Chapter 2: Advanced Topics</h2>
<p>Now let's explore more complex features...</p>
";

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("document-with-toc.pdf");

using IronPdf;

// Create renderer with multiple options
ChromePdfRenderer renderer = new ChromePdfRenderer();
renderer.RenderingOptions = new ChromePdfRenderOptions
{
    // Enable table of contents with page numbers
    TableOfContents = TableOfContentsTypes.WithPageNumbers,

    // Add margins for better formatting
    MarginTop = 40,
    MarginBottom = 40,

    // Enable JavaScript for dynamic content
    EnableJavaScript = true,

    // Set paper orientation
    PaperOrientation = PdfPaperOrientation.Portrait,

    // Add first page number offset
    FirstPageNumber = 1
};

 // Convert HTML with multiple header levels
string htmlContent = @"
<h1>Introduction</h1>
<p>Welcome to our comprehensive guide...</p>

<h2>Chapter 1: Getting Started</h2>
<p>Let's begin with the basics...</p>

<h3>1.1 Prerequisites</h3>
<p>Before we start, ensure you have...</p>

<h2>Chapter 2: Advanced Topics</h2>
<p>Now let's explore more complex features...</p>
";

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("document-with-toc.pdf");

¿Qué aspecto tiene el PDF generado?

La tabla de contenido se creará con hipervínculos a cada uno de los 'h1', 'h2', 'h3', 'h4', 'h5' y 'h6'. Se preserva la estructura jerárquica de sus encabezados, con subencabezados debidamente sangrados bajo sus secciones padre. También puede añadir números de página a su PDF para facilitar la navegación junto con el índice.

Cuando trabaje con PDFs fusionados o divididos, genere la tabla de contenidos después de que se haya completado todo el ensamblaje del documento para garantizar referencias de página precisas e hipervínculos funcionales.

¿Cómo dar estilo a diferentes niveles de encabezado?

Reemplace 'h1' con 'h2' hasta 'h6' para cambiar el estilo de cada encabezado respectivo.

 #ironpdf-toc ul li.h1 {
    font-style: italic;
    font-weight: bold;
 }

¿Cómo cambio la familia de fuentes?

Para hacer esto, podemos usar la fuente cursiva para el título y utilizar el atributo @font-face para usar la fuente personalizada 'Lemon' diseñada por Eduardo Tunni. Para ello, utilice la fuente cursiva para el título y el atributo @font-face para utilizar la fuente personalizada Lemon diseñada por Eduardo Tunni.

• Download the Lemon font

 #ironpdf-toc li .title {
    order: 1;
    font-family: cursive;
 }

 @font-face {
    font-family: 'lemon';
    src: url('Lemon-Regular.ttf')
 }

 #ironpdf-toc li .page {
    order: 3;
    font-family: 'lemon', sans-serif;
 }

¿Cómo controlo la sangría?

La sangría puede controlarse mediante el selector :root. Se puede aumentar según sea necesario, o puede no haber sangría con un valor de 0. {"w":"Se puede aumentar seg\u00fan sea necesario, o no tener sangr\u00eda con un valor de 0."}

:root {
    --indent-length: 25px;
}

¿Cómo puedo eliminar o personalizar las líneas de puntos?

Para eliminar las líneas punteadas entre el título del encabezado y el número de página, modifica la imagen de fondo del selector ::after. Cámbielo a "transparent 1px" para eliminar los puntos. Es importante especificar otros atributos también porque, en este selector, el nuevo estilo sobrescribirá completamente el estilo antiguo en lugar de solo añadirlo.

 #ironpdf-toc li::after {
    background-image: radial-gradient(circle, transparent 1px, transparent 1.5px);
    background-position: bottom;
    background-size: 1ex 4.5px;
    background-repeat: space no-repeat;
    content: "";
    flex-grow: 1;
    height: 1em;
    order: 2;
 }

Para opciones de estilo más avanzadas, cree líneas de líder personalizadas utilizando diferentes patrones:

/* Dashed line leader */
#ironpdf-toc li::after {
    background-image: linear-gradient(to right, currentcolor 50%, transparent 50%);
    background-size: 8px 1px;
    background-repeat: repeat-x;
    background-position: bottom;
}

/* Solid line leader */
#ironpdf-toc li::after {
    border-bottom: 1px solid currentcolor;
    background: none;
}

¿Listo para ver qué más puedes hacer? Consulta nuestra página de tutoriales aquí: Convertir PDFs