search

spatialaudio / nbsphinx

:ledger: Sphinx source parser for Jupyter notebooks
https://nbsphinx.readthedocs.io/
MIT License
449 stars 128 forks source link

DOC: add example for including nbsphinx docs in another LaTeX file #719

Closed mgeier closed 10 months ago

mgeier commented 1 year ago

This is an example for how to include Sphinx-generated content in a hand-written LaTeX file.

Rendered instructions: https://github.com/spatialaudio/nbsphinx/blob/7515477cfb0d029443cdae477b9aeef9f11a566c/include-in-latex/README.md

The resulting PDF file is here: https://output.circle-artifacts.com/output/job/538c4602-dd06-4181-adca-86293c169914/artifacts/0/my-latex-document.pdf

mgeier commented 1 year ago

I have asked for feedback on the mailing list (https://groups.google.com/g/sphinx-users/c/yys9wg2OnkQ), but there hasn't been any response yet.

mgeier commented 1 year ago

Latest version of PDF file, now with syntax highlighting: https://output.circle-artifacts.com/output/job/b50b8c06-562b-49e3-8e1b-64e38fcd8da0/artifacts/0/my-latex-document.pdf

mgeier commented 1 year ago

Latest PDF: https://output.circle-artifacts.com/output/job/5cad65eb-3d43-4f75-a0a5-4fbab6c0d2c6/artifacts/0/my-latex-document.pdf

mgeier commented 1 year ago

@jfbu Could you please have a quick look at the LaTeX stuff if you have some time?

AFAICT, this works quite well as it is, but maybe you have some ideas to make it simpler/better/more consistent/...?

BTW, this is the latest PDF: https://output.circle-artifacts.com/output/job/a68beaf5-d661-487c-abf9-fc7a9183117e/artifacts/0/my-latex-document.pdf