From 37d7972cb9899004af349b26708a57fe0e89d468 Mon Sep 17 00:00:00 2001 From: "Karl O. Pinc" Date: Tue, 9 May 2023 21:27:15 -0500 Subject: [PATCH] Add support for different pdf paper size output --- Makefile | 4 ++-- doc/conf.py | 14 ++++++++++++-- 2 files changed, 14 insertions(+), 4 deletions(-) diff --git a/Makefile b/Makefile index 3c5d8f0..bf26079 100644 --- a/Makefile +++ b/Makefile @@ -313,9 +313,9 @@ $(PDF_TARGET): $(SPHINX_PDF_TARGET) # It is unclear whether it's a good idea to run latexmk ourselves # or whether we should try to use the sphinx auto-generated Makefile # to do it, and try to keep the auto-generated Makefile under revision control. -# This seems simplest. +# Running it ourselves seems simplest. $(SPHINX_PDF_TARGET): latex_rst $(PNG_FILES) $(LATEX_EPILOG) - $(SPHINXBUILD) -t latex_epilog -b latex \ + $(SPHINXBUILD) -t a4paper -t latex_epilog -b latex \ $(LATEX_SRCDIR) $(SPHINX_BUILT_LATEX) cd $(SPHINX_BUILT_LATEX) \ && latexmk -pdf -dvi- -ps- $(patsubst %.pdf,%.tex,$(PDF_TARGET)) diff --git a/doc/conf.py b/doc/conf.py index 9d7fd2c..26a20aa 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -48,6 +48,9 @@ if tags.has('latex_epilog'): with open(pathlib.Path('sphinx-doc', epilog_file), 'r') as epilog: rst_epilog = epilog.read() +# Set the today substitution to UTC time. +today = ' '.join([time.strftime('%Y-%m-%d %H:%M:%S', time.gmtime()), 'UTC']) + # -- Options for HTML output ------------------------------------------------- # Do not put '.html' on the end of links @@ -74,5 +77,12 @@ html_copy_source = False # so a file named "default.css" will overwrite the builtin "default.css". html_static_path = ['_static'] -# Set the today substitution to UTC time. -today = ' '.join([time.strftime('%Y-%m-%d %H:%M:%S', time.gmtime()), 'UTC']) +# -- Options for LaTeX output ------------------------------------------------- + +paper = 'letterpaper' +if tags.has('a4paper'): + paper = 'a4paper' +if tags.has('letterpaper'): + paper = 'letterpaper' +latex_elements = {'papersize': paper, + } -- 2.34.1