Como adicionar um sumário em C

Que código preciso para gerar o sumário?

: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");

Imports IronPdf

' Instantiate Renderer
Private renderer As New ChromePdfRenderer()

' Configure render options
renderer.RenderingOptions = New ChromePdfRenderOptions With {.TableOfContents = TableOfContentsTypes.WithPageNumbers}

Dim pdf As PdfDocument = renderer.RenderHtmlFileAsPdf("tableOfContent.html")

pdf.SaveAs("tableOfContents.pdf")

Para cenários mais avançados, você pode combinar o sumário com outras opções de renderização para criar documentos PDF abrangentes:

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");

Imports IronPdf

' Create renderer with multiple options
Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions = New ChromePdfRenderOptions With {
    ' 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
Dim htmlContent As String = "
<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>
"

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

Qual é a aparência do PDF gerado?

O sumário será criado com hiperlinks para cada um dos itens 'h1', 'h2', 'h3', 'h4', 'h5' e 'h6'. A estrutura hierárquica dos seus cabeçalhos é preservada, com os subtítulos devidamente recuados em relação às suas seções principais. Você também pode adicionar números de página ao seu PDF para auxiliar na navegação, juntamente com o sumário.

Ao trabalhar com PDFs mesclados ou divididos , gere o sumário após a conclusão de toda a montagem do documento para garantir referências de página precisas e hiperlinks funcionais.

Como estilizar diferentes níveis de cabeçalho?

Use o seletor '#ironpdf-toc ul li.h1' para aplicar um estilo diferente ao cabeçalho H1 no sumário. Substitua 'h1' por 'h2' até 'h6' para alterar o estilo de cada cabeçalho respectivo.

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

Como faço para alterar a família da fonte?

Com os seletores '#ironpdf-toc li .title' e '#ironpdf-toc li .page', é possível sobrescrever a família de fontes do sumário. Para isso, use a fonte cursiva para o título e utilize o atributo @font-face para usar a fonte personalizada ' Lemon ', criada 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;
 }

Como controlar o recuo?

O recuo pode ser controlado usando o seletor :root. Esse valor determina o recuo de cada nível de cabeçalho (h1, h2, ...) no sumário. Pode ser aumentado conforme necessário, ou pode não haver recuo algum, com um valor de 0.

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

Como faço para remover ou personalizar as linhas pontilhadas?

Para remover as linhas pontilhadas entre o título do cabeçalho e o número da página, modifique a propriedade background-image do seletor ::after. No estilo original, o segundo parâmetro é "currentcolor 1px". Altere para "transparente 1px" para remover os pontos. É importante especificar também outros atributos, pois, neste seletor, o novo estilo substituirá completamente o estilo antigo, em vez de apenas complementá-lo.

 #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 opções de estilo mais avançadas, crie linhas de chamada personalizadas usando diferentes padrões:

/* 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;
}

Pronto para ver o que mais você pode fazer? Confira nossa página de tutoriais aqui: Converter PDFs