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: Improve readability of LaTeX (tex) for author customization #1497

Open
2 tasks
mmcky opened this issue Oct 11, 2021 · 0 comments
Open
2 tasks

ENH: Improve readability of LaTeX (tex) for author customization #1497

mmcky opened this issue Oct 11, 2021 · 0 comments
Labels
enhancement New feature or request

Comments

@mmcky
Copy link
Contributor

mmcky commented Oct 11, 2021

Description / Summary

The current latex/pdflatex functionality of jupyter-book enables building pdf files via LaTeX compilation for books. However some authors would like to have more control over the LaTeX process and it would be helpful to have a more readable intermediate tex file.

Value / benefit

Enables author's more control over the compilation phase when building latex -> pdf

Implementation details

We currently make use of sphinx-jupyterbook-latex to alter the sphinx abstract syntax tree using transforms and post-transforms to enable building via the default sphinx LaTeX writer. This is coordinated with other packages like sphinx-multitoc-numbering to enable support for part/chapter structures provided by jupyter-book

This is a good strategy as we get improvements from sphinx development, in addition to not having to maintain our own LaTeX builder/writer in sphinx. It would nice to retain this approach (if possible).

I think for the majority of use cases - focusing on myst:md to pdf is the best approach (to build a tool that doesn't require any interaction with tex) but it would be nice to enable a --readable option to the latex builder

jb build <project> --builder=latex --readable

Tasks to complete

  • enable turning pygments syntax highlighting off and use minted with direct placement of code in LaTeX (tex) file
  • simply the use of \sphinx macros
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

1 participant