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_code as the base object used to write notebooks that just contain code blocks
translate_ipynb for as the primary for producing ipynb files that has an emphasis on readability and supports markdown as much as possible
translate_html for writing ipynb files used in the production of the website and favours using html objects in the notebooks
translate_pdf for writing ipynb files used in the production of pdf files.
We should refactor the current
translate_code
andtranslate_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_code
as the base object used to write notebooks that just contain code blockstranslate_ipynb
for as the primary for producingipynb
files that has an emphasis on readability and supports markdown as much as possibletranslate_html
for writingipynb
files used in the production of the website and favours usinghtml
objects in the notebookstranslate_pdf
for writingipynb
files used in the production ofpdf
files.