使用Table of Content将IPython笔记本编写为HTML或PDF

Question

我正试图从我的IPython笔记本创建报告。我正在使用toc扩展为我的nb创建一个toc。 我已经将笔记本转换为html，但是toc没有显示，也没有链接到doc的其余部分。有没有办法转换为指定的fromat之一，仍然保持可链接（甚至不可链接）的TOC？

Answer 1

假设您使用IPython 1.x，您可以使用以下选项将toc包含在 pdf

中

• 使用latex_book模板
  （ipython nbconvert --to=latex --template=latex_book --post=pdf file.ipynb）

• 扩展latex_article（默认）模板
  在工作目录中创建一个包含以下内容的文件（例如toc_latex.tplx）：

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

  将其用作模板，如
  ipython nbconvert --to=latex --template=toc_latex --post=pdf file.ipynb

如果您使用IPython 2.x

• 使用latex_report模板
  （ipython nbconvert --to=latex --template=latex_report --post=pdf file.ipynb）

• 自定义模板可能类似于

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

Answer 2

我使用了没有nb扩展名的方法来将ToC写入pdf（通过Latex）。我认为导出为HTML时不起作用。

我在笔记本顶部添加了该单元格：

%%latex
\tableofcontents

然后根据this answer

转换为pdf

jupyter nbconvert --to pdf --TemplateExporter.exclude_input=True my_notebook.ipynb