放置自定义 nbconvert 模板的正确位置

Question

我制作了一个自定义 nbconvert 模板，并希望它可以从我启动nbconvert实用程序的任何文件夹中访问。我应该把我的模板放在哪里？

我在官方文档中找不到任何内容。我已经尝试了 jupyter 配置的常用位置，例如/usr/share/jupyter, ~/.local/share/jupyter, ~/.jupyter，但无济于事。

到目前为止，我发现的唯一地方是 python 包所在的文件夹：

$ pip show nbconvert | grep Location | cut -d" " -f2
/usr/lib/python3.6/site-packages

如果我nbconvert/templates/html在那里创建目录并将我的模板放入其中，则nbconvert --to html --template <my_template_name> ...工作正常。但这是一个丑陋的黑客，每次更新 nbconvert 时我都需要重新做。

似乎我可以为 nbconvert 提供环境变量，但我更愿意避免使用此选项。

Answer 1

您需要nbconvert通过创建文件jupyter_nbconvert_config.py并将其存储在~/.jupyter.

我将其用于 LaTeX——我的文件如下所示：

import os
c = get_config()

c.LatexExporter.template_path = ['.', os.path.expanduser('~/.jupyter/templates')]
c.LatexExporter.template_file = 'custom_latex.tplx'

假设您的模板扩展了现有模板，则需要'.'在设置时包含在内template_path，以便它知道在哪里查找标准模板。