ipython - 使用目录将 IPython 笔记本写入 HTML 或 PDF

Question

我正在尝试从我的 IPython 笔记本创建报告。我使用 toc 扩展为我的 nb 创建一个目录。我已经将笔记本转换为 html，但没有显示目录，也没有链接到文档的其余部分。有什么方法可以转换为指定的 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

然后根据这个答案转换为pdf

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