QuantEcon / sphinxcontrib-jupyter

A Sphinx Extension for Generating Jupyter Notebooks
BSD 3-Clause "New" or "Revised" License
76 stars 23 forks source link

ENH: PDF Document Structure and Options #218

Closed mmcky closed 4 years ago

mmcky commented 5 years ago

We will need to split the typical tex document into some basic elements to easily specify build options.

  1. \documentclass[] should all be options font size, document type (article, book) etc.
  2. preamble should be supplied by specifying jupyter_pdf_template = <path> and use a template approach which is more flexible for future edits
  3. \maketitle needs to be an option jupyter_pdf_title=True/False
  4. logo needs to be an option jupyter_pdf_logo = <path> and assumed to be centred under the title
  5. body of the tex should be determined solely by translator when writing source ipynb notebooks.

where these adjustments get made needs to be tested. (a) rst to ipynb stage or (b) ipynb to rst stage. For example, preamble probably shouldn't get written to the notebook (as the notebook is the document) but should be added in stage (b).