Writing an IPython notebook to HTML or PDF with Table Of Content

Question

Im trying to create a report from my IPython notebook. Im using the toc extension to create a toc for my nb. I already converted the notebook to html, but the toc is not shown and is not linking to the rest of the doc. Is there any way to convert to one of the specified fromat and still keep a link-able (or even non-link-able) TOC?

Answer 1

Assuming you use IPython 1.x you have the following options to include the toc in the pdf

• use the latex_book template
  (ipython nbconvert --to=latex --template=latex_book --post=pdf file.ipynb)

• extend the latex_article (default) template
  Create a file with the following content (e.g. toc_latex.tplx) in the working dir:

  ((*- extends 'latex_article.tplx' -*))
  ((* block toc *))\tableofcontents((* endblock toc *))
  

  Use it as a template like
  ipython nbconvert --to=latex --template=toc_latex --post=pdf file.ipynb

If you use IPython 2.x

• use the latex_report template
  (ipython nbconvert --to=latex --template=latex_report --post=pdf file.ipynb)

• the custom template could be something like

  ((*- extends 'latex_article.tplx' -*))
  ((* block abstract *))\tableofcontents((* endblock abstract *))