jupyter-book icon indicating copy to clipboard operation
jupyter-book copied to clipboard

Make it possible / document how to create your own Latex templates

Open choldgraf opened this issue 3 years ago • 2 comments

Context

In order to use Jupyter Book as part of publishing workflows, many communities need content to be formatted in community-specific Latex files before going to press. We currently offer basic customization of PDF via Latex as documented here, but this wasn't clear enough (or w/ enough functionality) to support more complex needs for specific Latex structures.

For inspiration we might look at similar packages in the RStudio ecosystem, such as the rticles latex templates package.

cc @ttimbers @lheagy and @chendaniely who originally mentioned this

Proposal

We should have the minimal level of Latex configurability to allow a community to be able to re-format the Latex output of a Jupyter Book for use with their community. This doesn't necessarily have to be in Jupyter Book itself, maybe it could rely on exterior tools or services, but we should at least have a documented path forward for people that want to write Jupyter Books and then pipe them through a publishing pipeline that is restrictive about the Latex format that it needs.

Tasks and updates

No response

choldgraf avatar Jun 27 '22 12:06 choldgraf

cc @mmcky and @AakashGfude on this one as well, who might have run into this issue with the quantecon books?

choldgraf avatar Jun 27 '22 12:06 choldgraf

Hi @choldgraf . Thanks for bringing this up. We need to formulate what features we need to be able to customize. We dont have a lot at present agree. We should work on this in sphinx-jupyterbook-latex i reckon. https://github.com/executablebooks/sphinx-jupyterbook-latex

AakashGfude avatar Jun 29 '22 02:06 AakashGfude