2011-03-24 19 views
32

De manera predeterminada, la documentación de Sphinx genera un PDF formateado para la impresión dúplex. Así que hay una página en blanco entre la página de título y el TOC, el TOC y la introducción, la introducción y la primera sección, etc.Documentos de Sphinx: ¿Eliminar páginas en blanco de los archivos PDF generados?

Mis usuarios siempre van a ver el PDF en línea. Entonces me gustaría eliminar estas páginas en blanco.

Esto parece ser un problema molesto en Sphinx. See this email thread.

This user sugiere dos soluciones, pero ninguna funciona para mí. Curiosamente, la primera solución:

latex_elements = { 
    'classoptions': ',oneside', 
} 

me ! Package babel Error: You haven't specified a language option.

da la segunda opción:

latex_font_size = '10pt,oneside' 

carreras, pero produce un PDF que sólo tiene las páginas impares de mi documento. Ay.

¿Alguien sabe cómo producir un PDF sin estas páginas en blanco?

+1

Dado que los usuarios van a leer esto exclusivamente en línea, ¿no sería más amigable para tener una salida Sphinx, por ejemplo, HTML, y guardarles la agonía de la visualización en PDF en línea? –

+0

@ Brent.Longborough, esto simplemente no es realista. HTML no se creó para el diseño de página, pero hoy en día la mayoría de las personas trata de usarlo para ... diseño de página, incluso en línea. Con resultados modestos. Prefiero un PDF atractivo, incluso en línea, a un montón de HTML. Especialmente lo que sale de Sphinx, a menos que lo personalices con tu propio CSS. Considero HTML como un truco (en su mayoría) de trabajo. Busque Display Postscript en algún momento, si no está familiarizado con él, imagínese una web con eso, sería increíble. –

+0

@AmigableClarkKant: Estoy de acuerdo en que el HTML no es tan bueno, pero el PDF ni siquiera se redistribuye correctamente para cambiar el tamaño de la ventana o el escalado de texto, que, creo, son requisitos clave para la lectura en línea. –

Respuesta

46

poner esto en su archivo de configuración source/conf.py en las "Opciones para el látex de salida" sección:

latex_elements = { 
    'classoptions': ',openany,oneside' 
} 
+28

Es incluso mejor con el parámetro 'openany', elimina incluso la página en blanco después de la tabla de contenido. Ejemplo: 'latex_elements = { 'classoptions': 'openany, oneside', 'Babel': '\\ usepackage [polaco] {babel}' }' – flegmatyk

+7

Excelente, gran punta! Todavía no estoy listo para hacer el cambio para pulir ...;) –

+0

gracias! funcionó para mí – Antigluk

Cuestiones relacionadas