Esquemas y Marcadores

from ironpdf import *

# Create a new PDF or edit an existing document.
pdf = PdfDocument.FromFile("existing.pdf")

# Add bookmark
pdf.Bookmarks.AddBookMarkAtEnd("Author's Note", 2)
pdf.Bookmarks.AddBookMarkAtEnd("Table of Contents", 3)

# Store new bookmark in a variable to add nested bookmarks to
summaryBookmark = pdf.Bookmarks.AddBookMarkAtEnd("Summary", 17)

# Add a sub-bookmark within the summary
conclusionBookmark = summaryBookmark.Children.AddBookMarkAtStart("Conclusion", 18)

# Add another bookmark to end of highest-level bookmark list
pdf.Bookmarks.AddBookMarkAtEnd("References", 20)

pdf.SaveAs("existing.pdf")

Esquemas y Marcadores

IronPDF for Python puede añadir un esquema de marcadores navegables a documentos PDF, creando un panel de tabla de contenidos que los lectores pueden usar para saltar directamente a cualquier sección, incluidas las subsecciones anidadas.

Empezando

Cargue o cree un PdfDocument, luego use la colección pdf.Bookmarks para añadir entradas de marcadores. Llame a AddBookMarkAtEnd para añadir entradas a la lista de marcadores, o a AddBookMarkAtStart en una colección hija para anidar sub-marcadores bajo un padre.

Entender el código

pdf.Bookmarks.AddBookMarkAtEnd(title, pageIndex): Añade un nuevo marcador al final de la lista de marcadores de nivel superior. pageIndex es el índice de página basado en cero a la que el marcador se enlaza. Devuelve el nuevo objeto de marcador.
bookmark.Children.AddBookMarkAtStart(title, pageIndex): Añade un marcador hijo bajo un marcador existente, creando una jerarquía anidada. Devuelve el objeto de marcador hijo.
pdf.Bookmarks.AddBookMarkAtEnd("References", 20): Añade otro marcador después de todas las entradas existentes.
SaveAs(path): Guarda el documento con todos los marcadores incrustados en el esquema del PDF.

Jerarquía de Marcadores

Los marcadores PDF soportan múltiples niveles de anidamiento. Cada marcador devuelto por AddBookMarkAtEnd o AddBookMarkAtStart tiene su propia colección .Children, lo que le permite construir árboles de profundidad arbitraria.

Indexación de páginas

Los índices de página de marcadores están basados en cero. La página 1 del documento es el índice 0, la página 18 es el índice 17, y así sucesivamente.