Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

ENH: Use LaTeX template to build more concise page-level pdf files using --individualpdf option #904

mmcky opened this issue Aug 25, 2020 · 2 comments
enhancement New feature or request


Copy link

mmcky commented Aug 25, 2020

Is your feature request related to a problem? Please describe.

#687 adds the capacity to auto-build each document for a project as an individual pdf file.However currently the resultant pdf is like a mini book format (using the default latex writer included in sphinx). We will need to work on more concise page layouts hopefully using LaTeX templates as being worked on in #586 to be more like this example

Describe the solution you'd like

Develop a default LaTeX template which could be used to produce a more concise pdf files.

Describe alternatives you've considered

Write a custom sphinx.translator but hopefully this can be avoided.

Additional context

One use case for the jb build <folder> --builder=pdflatex --individualpages command is to build pdf via latex to support pdf downloads for html sites.

@mmcky mmcky added the enhancement New feature or request label Aug 25, 2020
Copy link

emdupre commented Aug 25, 2020

This sounds really great ! Out of curiosity, does this interact with building PDFs for single-page books ?

Copy link
Member Author

mmcky commented Aug 26, 2020

hey @emdupre - this is a good point. Which template to use for:

Case 1:

jb build <file> --builder=pdflatex

and Case 2:

jb build <file> --builder=pdflatex --individualpages

I think consistency is probably the best approach where:

  1. Case 1 build using a project type LaTeX theme (book)
  2. Case 2 build using a single page style LaTeX theme (singlepage)

Alternative: would be if a <file> is specified to use the singlepage LaTeX theme. My concern with Case 2 above is the --individualpages flag is not really built with <file> in mind.

We will revisit this once LaTeX templates are available

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
enhancement New feature or request
None yet

No branches or pull requests

2 participants