(Véase también Insertar páginas desde un PDF, que se centra más en insertar una o dos páginas específicas, con la opción de que las páginas añadidas se escalen, roten, etc. y aparezcan con un encabezado continuo.)
Supongamos que desea que PTXprint inserte todas las páginas de un PDF antes del inicio de un libro específico o al final de un libro específico.
Qué hacer:
-
En la pestaña avanzada, marque “Apply Customised Settings” (Aplicar ajustes personalizados) y luego edítela.
-
En una línea en otro caso vacía de ese archivo, escriba algo como lo siguiente:
\setbookhook{start}{MAT}{\includepdf{../../../figures/FileName.pdf}}
O, para que el archivo esté después del final del libro de Apocalipsis, esto:
\setbookhook{end}{REV}{\pb \includepdf{../../../figures/FileName.pdf}}
- Haga clic en Print (Imprimir) para asegurarse de que sea correcto.
Ahora, algunas explicaciones.
En varios puntos durante el procesamiento del USFM, PTXprint verifica si el usuario ha solicitado que ocurra algo inusual. Podría pensar en esas verificaciones como una gran cuadrícula de ganchos en una pared, donde casi todos están vacíos. Pero, alguien podría poner una lista de instrucciones en uno de ellos. Si hay una lista de instrucciones en el gancho, entonces esas instrucciones se añaden a la lista de cosas que TeX debe hacer antes de hacer cualquier otra cosa.
El inicio y el final de los libros es uno de los lugares donde se verifica la cuadrícula de ganchos, y el comando \setbookhook coloca su lista de instrucciones en el gancho especificado (descartando cualquier otra cosa que ya pudiera estar allí). Otro lugar donde se verifican los ganchos es el inicio de un versículo (\setcvhook).
\setbookhook{start}{MAT}{\includepdf{filename.pdf}} le indica al código que al inicio del libro con \id MAT, debe procesar la instrucción \includepdf{filename.pdf}.
En el ejemplo anterior, la instrucción es incluir ../../../figures/FileName.pdf.
Estoy usando la barra diagonal de estilo unix entre directorios porque (a) estoy escribiendo esto en linux, (b) los programas de Windows pueden, creo, normalmente manejar rutas de estilo unix, y (c) tendría que usar \\ para que la barra invertida pasara, y entonces no funcionaría en linux ni en computadoras Apple.
../../.. significa tres directorios por encima de 'dónde estamos ahora', con 'ahora' siendo desde donde se ejecuta TeX - para la configuración Default, eso es .../PROJECT/local/ptxprint/Default y por lo tanto lo anterior está buscando el PDF en .../PROJECT/figures y al usar una ruta relativa en lugar de una absoluta, debería funcionar en la computadora de todos.
Otras cosas a tener en cuenta
- El
\pb usado con la versión {end} anterior fuerza un salto de página antes de que se añadan las páginas. Sin él, el PDF podría añadirse antes de la última página del libro.
- Aunque esto no añade números de página a las páginas, sí cuenta páginas.
- Si obtiene la ruta y el nombre del archivo correctos, recibirá un mensaje en el archivo de registro que dice
includepdf ../../../figures/test.pdf pages=2
Si comete un error y no hay archivo allí, dirá pages=0 ¡Esa es su única advertencia!
- También hay un libro especial
final (p. ej. \setbookhook{end}{final}{...}) que es el último libro del trabajo.
- Aunque solo hay un 'gancho' en un punto particular, se pueden usar múltiples ganchos. p. ej.:
- Hay varias diferencias en cómo se maneja la entrada en archivos
.tex y archivos .sfm (o USFM). \includepdf es una instrucción de TeX, no de USFM, y por lo tanto no se puede usar fácilmente en archivos USFM, como periféricos o material preliminar.
\includepdf es un comando inmediato que salta cualquier cola. Mientras que la mayoría de las entradas añaden material a las listas de texto y párrafos de TeX para ser dispuestos en una página en algún momento, \includepdf emite las páginas del PDF en cuanto se encuentra. - de ahí la necesidad del comando de salto de página en el ejemplo del final de Apocalipsis. Por el lado positivo, ya que ignora la cola, no debería alterar la disposición de ningún párrafo en el que se encuentre.
