使用目录将IPython笔记本编写为HTML或PDF

Question

我正在尝试从我的IPython笔记本创建报告。我使用toc扩展名为我的nb创建一个toc。我已经将笔记本转换为html，但是toc未显示，并且未链接到文档的其余部分。有什么方法可以转换为指定的fromat之一，并仍然保持可链接（甚至不可链接）的TOC？

Answer 1

假设您使用 IPython 1.x，您可以使用以下选项将目录包含在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 *))