PDF TOC Generator
El Documentize PDF TOC Generator para .NET es un poderoso plugin diseñado para mejorar la organización y navegación de documentos PDF mediante la generación dinámica de una Tabla de Contenidos (TOC). Este plugin simplifica el proceso de agregar TOCs a tus PDFs, haciendo que los documentos sean más fáciles de navegar y gestionar.
Cómo generar un TOC para un PDF
Para crear una Tabla de Contenidos en un archivo PDF, sigue estos pasos:
- Crea una instancia de
TocOptions
para configurar las opciones de generación del TOC. - Establece un Título utilizando la propiedad
Title
. - Diseña los Encabezados del TOC utilizando el método
Headings.Add
. - Agrega el archivo PDF de entrada utilizando el método
AddInput
. - Especifica el archivo PDF de salida con el TOC utilizando el método
AddOutput
. - Llama al método
Process
para generar el TOC.
1// Crea un objeto TocOptions para establecer instrucciones
2var options = new TocOptions();
3// Establece el Título
4options.Title = "Mi Tabla de Contenidos";
5// Diseña los Encabezados
6options.Headings.Add(new TocHeading("Introducción", 2));
7options.Headings.Add(new TocHeading("Capítulo I", 3));
8options.Headings.Add(new TocHeading("Capítulo II", 4));
9options.Headings.Add(new TocHeading("Capítulo III", 5));
10// Agrega la ruta del archivo de entrada
11options.AddInput(new FileDataSource("ruta_a_tu_archivo_pdf.pdf"));
12// Establece la ruta del archivo de salida
13options.AddOutput(new FileDataSource("ruta_a_archivo_pdf_resultante.pdf"));
14// Realiza el proceso
15TocGenerator.Process(options);
Generar marcadores en un TOC para un PDF
Puedes usar la propiedad ‘GenerateBookmarks’ para la generación de marcadores.
1// Crea un objeto TocOptions para establecer instrucciones
2var options = new TocOptions();
3// Establece el Título
4options.Title = "Mi Tabla de Contenidos";
5// Genera enlaces en los marcadores
6options.GenerateBookmarks = true;
7// Diseña los Encabezados
8options.Headings.Add(new TocHeading("Introducción", 2, false, 1));
9options.Headings.Add(new TocHeading("Capítulo I", 3, true, 1));
10options.Headings.Add(new TocHeading("Capítulo II", 4, true, 1));
11options.Headings.Add(new TocHeading("Ejemplo A", 4, true, 2));
12options.Headings.Add(new TocHeading("Ejemplo B", 4, true, 2));
13options.Headings.Add(new TocHeading("Ejemplo C", 4, true, 2));
14options.Headings.Add(new TocHeading("Ejemplo D", 4, true, 2));
15options.Headings.Add(new TocHeading("Capítulo III", 5, true, 1));
16// Agrega la ruta del archivo de entrada
17options.AddInput(new FileDataSource("ruta_a_tu_archivo_pdf.pdf"));
18// Establece la ruta del archivo de salida
19options.AddOutput(new FileDataSource("ruta_a_archivo_pdf_resultante.pdf"));
20// Realiza el proceso
21TocGenerator.Process(options);
Personalizando el Encabezado del TOC
Puedes personalizar el Encabezado de la Tabla de Contenidos modificando la clase TocHeading
. Por ejemplo, puedes usar ‘GenerateNumbering’ o hacerlo manualmente.
La propiedad ‘PageNumber’ se utiliza para enlaces en las páginas. También puedes utilizar la propiedad Level.
1var heading = new TocHeading();
2heading.Text = "Intro";
3heading.PageNumber = 5;
4heading.GenerateNumbering = true;
5heading.Level = 2;
6
7var tocOptions = new TocOptions();
8options.Headings.Add(heading);
9// Agrega archivos de entrada y salida
10tocOptions.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));
11tocOptions.AddOutput(new FileDataSource(@"C:\Samples\output_with_toc.pdf"));
12
13// Genera el TOC con opciones personalizadas
14TocGenerator.Process(tocOptions);
Cómo obtener el resultado como Stream
1// Crea un objeto TocOptions para establecer instrucciones
2var options = new TocOptions();
3// Establece el Título
4options.Title = "Mi Tabla de Contenidos";
5// Diseña los Encabezados
6options.Headings.Add(new TocHeading("Introducción", 2, false, 1));
7// Agrega la ruta del archivo de entrada
8options.AddInput(new FileDataSource("ruta_a_tu_archivo_pdf.pdf"));
9// Establece el stream de salida
10var outputStream = new MemoryStream();
11options.AddOutput(new StreamDataSource(outputStream));
12options.CloseOutputStreams = false;
13// Realiza el proceso
14TocGenerator.Process(options);
Características Clave:
- Generación de TOC Dinámico: Crea un TOC para cualquier archivo PDF con entradas generadas automáticamente basadas en encabezados o marcadores.
- Procesamiento por lotes: Genera TOCs para múltiples documentos PDF a la vez.
- Personalización: Controla la apariencia y estructura del TOC, incluidos estilos, formato y niveles de profundidad.
- Flujo de trabajo eficiente: Minimiza el tiempo dedicado a crear TOCs manualmente, especialmente para documentos grandes o complejos.