sphinxcontrib-jupyter
sphinxcontrib-jupyter copied to clipboard
ENH: Refactor writer/translators into specific targets ipynb, html, pdf
We should refactor the current translate_code and translate_all into specific end target writers to improve this code base. It is currently confusing to have all the states included in a single writer depending on a wide set of options.
I propose:
translate_codeas the base object used to write notebooks that just contain code blockstranslate_ipynbfor as the primary for producingipynbfiles that has an emphasis on readability and supports markdown as much as possibletranslate_htmlfor writingipynbfiles used in the production of the website and favours usinghtmlobjects in the notebookstranslate_pdffor writingipynbfiles used in the production ofpdffiles.
More detailed discussion of this is
https://github.com/QuantEcon/sphinxcontrib-jupyter/wiki/Extension-Refactor-and-Redesign-(November-2019)