Dear mailing list. I'm pleased to announce the latest release 0.4.0 of the Sphinx extension "nbsphinx": https://nbsphinx.readthedocs.io/.
It allows you to take a bunch of Jupyter notebooks (plus some Markdown and/or reStructuredText files if you want) and turn them into static HTML pages and/or a LaTeX/PDF file. If you don't want to save all those bulky code cell outputs in your notebooks, nbsphinx can automatically execute your notebooks for you (with the help of nbconvert) and include the outputs only when building the HTML and LaTeX/PDF files. For a list of changes please see https://github.com/spatialaudio/nbsphinx/blob/master/NEWS.rst. I normally don't make this kind of announcements, but this time I do, because I want to direct your attention to the following fact: For the first time, the LaTeX/PDF output doesn't totally suck! Please have a look at the example PDF file and see for yourself: https://media.readthedocs.org/pdf/nbsphinx/0.4.0/nbsphinx.pdf#section.4 Feel free to compare it to the previous release: https://media.readthedocs.org/pdf/nbsphinx/0.3.5/nbsphinx.pdf#section.4 I would like to thank Jean-François B. (Github user @jfbu) for coming up with the dark TeX magic that was necessary to make this happen. I encourage all of you to try to use nbsphinx to convert a bunch of your Jupyter notebooks to PDF files and report any problems that might occur (https://github.com/spatialaudio/nbsphinx/issues). Speaking of which, there are still a few known problems and limitations: * SymPy equations are not left-aligned in LaTeX/PDF. We are working on this: https://github.com/sympy/sympy/pull/15625 This might also apply to other libraries that generate mathematical expressions. Please report this to the respective maintainers. * The bibliography appears in different places in HTML and LaTeX/PDF output. See the documentation for a work-around to fix this. * Equation references work only within one HTML page. In LaTeX/PDF output, they also work between notebooks. * Markdown tables look a bit boring in LaTeX/PDF output * Matplotlib plots need a bit of extra care, see documentation for details Have fun and feel free to share your positive as well as negative experiences with nbsphinx! cheers, Matthias -- You received this message because you are subscribed to the Google Groups "Project Jupyter" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/jupyter/CAFesC-dVEjsMz-MxrCdD-4zorhn%2BygrxeZd5KkHG15aTgZK8_w%40mail.gmail.com. For more options, visit https://groups.google.com/d/optout.
