librelist archives

« back to archive

Problem generating Flask docs with papersize letterpaper PDF

Problem generating Flask docs with papersize letterpaper PDF

From:
Martin Betz
Date:
2014-05-01 @ 10:56
Hi,

I'm trying to build Flasks documentation as PDF in papersize letterpaper.
And I fail miserably. Can you please help me.

I've cloned the official repository from Github, cd'ed into docs and looked
at the make files. As I'm on OS X, I thought MAKEFILE was the one to watch
at.

First, I tried to change the variable in line 7 to `letter`. And built. But
its output was A4 still. I passed it to the commandline, such as `make
latexpdf PAPER=letter`, but no change whatsoever.

Then I thought that `-D latex_paper_size=letter` might be `-D
latex_paper_size=letterpaper` as this was the setting's name I recalled
from LaTeX.

All with no success. All PDFs that get build are A4.

Hence I suspected `make.bat` would interfere. I renamed MAKEFILE to
M8kef1le. And `make pdflatex` failed.

So I must certainly do something wrong within the MAKEFILE.

But what?

Thanks!
Martin

Re: Problem generating Flask docs with papersize letterpaper PDF

From:
Martin Betz
Date:
2014-05-01 @ 11:12
This problem might be connected with lines 200-205 in conf.py:

latex_elements = {
    'fontpkg':      r'\usepackage{mathpazo}',
    'papersize':    'a4paper',
    'pointsize':    '12pt',
    'preamble':     r'\usepackage{flaskstyle}'
}

Maybe the hard coded `a4paper` is the problem.

When I manually rename it to `letterpaper`, the PDF has the right size.


P.S. Sorry that I forgot to add [flask] and/or [docs] in the subject line.


2014-05-01 12:56 GMT+02:00 Martin Betz <martinmichaelbetz@gmail.com>:

> Hi,
>
> I'm trying to build Flasks documentation as PDF in papersize letterpaper.
> And I fail miserably. Can you please help me.
>
> I've cloned the official repository from Github, cd'ed into docs and
> looked at the make files. As I'm on OS X, I thought MAKEFILE was the one to
> watch at.
>
> First, I tried to change the variable in line 7 to `letter`. And built.
> But its output was A4 still. I passed it to the commandline, such as `make
> latexpdf PAPER=letter`, but no change whatsoever.
>
> Then I thought that `-D latex_paper_size=letter` might be `-D
> latex_paper_size=letterpaper` as this was the setting's name I recalled
> from LaTeX.
>
> All with no success. All PDFs that get build are A4.
>
> Hence I suspected `make.bat` would interfere. I renamed MAKEFILE to
> M8kef1le. And `make pdflatex` failed.
>
> So I must certainly do something wrong within the MAKEFILE.
>
> But what?
>
> Thanks!
> Martin
>