ubuntu-packaging-guide-team team mailing list archive

[Dmitry Shachnev <mitya57@xxxxxxxxx>]

Dmitry Shachnev has proposed merging lp:~mitya57/ubuntu-packaging-guide/lp1095513 into lp:ubuntu-packaging-guide.

Commit message:
Add a work-around for the blank pages in PDF bug (LP: #1095513).

Requested reviews:
  Ubuntu Packaging Guide Team (ubuntu-packaging-guide-team)
Related bugs:
  Bug #1095513 in Ubuntu Packaging Guide: "pdf builds have blank pages"
  https://bugs.launchpad.net/ubuntu-packaging-guide/+bug/1095513

For more details, see:
https://code.launchpad.net/~mitya57/ubuntu-packaging-guide/lp1095513/+merge/145061

I've added a hack that adds "oneside,openany" to the LaTeX documentclass. Since there is no *direct* way to add options there, I've added those to the latex_font_size property.

The idea is taken from http://stackoverflow.com/questions/5422997/sphinx-docs-remove-blank-pages-from-generated-pdfs.

The person who asked that question says that after this workaround, the PDF file "only [had] the odd-numbered pages of my document", so I want other to verify that this is not the case for them (and also that this works with different languages and Sphinx versions.
-- 
https://code.launchpad.net/~mitya57/ubuntu-packaging-guide/lp1095513/+merge/145061
Your team Ubuntu Packaging Guide Team is requested to review the proposed merge of lp:~mitya57/ubuntu-packaging-guide/lp1095513 into lp:ubuntu-packaging-guide.

=== modified file 'conf.py'
--- conf.py	2012-05-09 01:46:14 +0000
+++ conf.py	2013-01-26 11:57:23 +0000
@@ -185,7 +185,7 @@
 #latex_paper_size = 'letter'
 
 # The font size ('10pt', '11pt' or '12pt').
-#latex_font_size = '10pt'
+latex_font_size = '10pt,oneside,openany'
 
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title, author, documentclass [howto/manual]).

=== modified file 'debian/changelog'
--- debian/changelog	2013-01-03 02:50:08 +0000
+++ debian/changelog	2013-01-26 11:57:23 +0000
@@ -3,6 +3,7 @@
   [ Dmitry Shachnev ]
   * Makefile: fix wrong links to some resources in singlehtml builds.
   * auto-pkg-test.rst: Updated links for raring.
+  * Add a work-around for the blank pages in PDF bug (LP: #1095513).
 
   [ Daniel Holbach ]
   * Document where to find a list of required autopkgtests and where