Genere un índice PDF a partir de marcadores

Proporcione los marcadores en el orden del documento, con el título, la página de destino —contada desde uno— y un nivel de anidación opcional. El generador conserva la jerarquía mediante sangrías, añade líneas de puntos legibles y devuelve tanto las entradas estructuradas como el texto listo para usar. Los esquemas vacíos se rechazan para detectar cualquier fallo previo.

Prepare el esquema de marcadores

Comience con el esquema ya extraído del PDF. Cada entrada necesita un título y un número de página contado desde uno, y debe aparecer en el mismo orden en que el lector la encontrará. Añada un nivel cuando el marcador dependa de un capítulo u otra entrada principal: el nivel cero representa un destino principal, el uno aplica una sangría y los niveles superiores aumentan esa sangría. El generador no inspecciona ni modifica los bytes del PDF, no deduce marcadores a partir del texto ni cambia su orden. Así, el resultado es predecible y los problemas de los datos quedan visibles. Los espacios repetidos y los saltos dentro de los títulos se normalizan automáticamente. Los títulos deben contener texto visible, las páginas deben ser enteros positivos y los niveles deben respetar el intervalo documentado. Un esquema vacío produce un error de entrada y no una página en blanco.

Comprenda la página generada

El resultado incluye un encabezado, una lista normalizada de entradas, el total de entradas y un campo de página con el texto renderizado. Cada línea comienza con la sangría correspondiente al nivel del marcador, continúa con el título limpio y termina con el número de página. Una línea de puntos rellena el espacio para facilitar la lectura. El formateador usa un ancho objetivo estable, pero nunca recorta un título largo solo para mantener la alineación; conserva el texto completo y coloca un separador mínimo. De este modo protege los nombres significativos de los capítulos y ofrece resultados deterministas tanto en el navegador como en la API. Las entradas estructuradas repiten el título, la página, el nivel y la línea final, por lo que usted puede usar el texto suministrado o aplicar después su propia tipografía. El encabezado predeterminado es “Índice”, pero puede sustituirlo por otra etiqueta no vacía de una sola línea.

Intégrelo en un flujo de trabajo PDF

Utilice el texto de página devuelto como fuente para la etapa que crea o inserta una página física en el PDF. Esta capacidad se centra deliberadamente en renderizar el esquema: no recalcula destinos tras insertar páginas, no elige fuentes, no pagina índices extensos ni modifica el archivo original. Si la inserción de una página cambia los destinos, ajuste los valores antes de generar el índice definitivo o hágalo durante el montaje. Separar estas responsabilidades evita el habitual desfase de una página causado por añadir preliminares después de registrar los marcadores. Para una publicación repetible, extraiga o mantenga el esquema, valide las páginas de destino, genere el índice y envíe el resultado a la etapa de composición. La misma lógica determinista funciona sin red ni estado almacenado, por lo que resulta adecuada para comprobaciones en el navegador, procesos de compilación, portales documentales y pruebas de regresión.