5

我制作了一个自定义 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> ...可以正常工作。但这是一个丑陋的 hack，每次更新 nbconvert 时我都需要重新做。

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

4

4 回答 4

3

您需要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以便它知道在哪里查找标准模板。

于 2018-07-06T13:51:36.097 回答
2

从文档。

保存自定义模板以便 nbconvert 可以全局访问它们的推荐位置是您的 jupyter 数据目录：

  • 分享/jupyter

    • 转换
      • 模板
        • html
        • 乳胶

交替

from jupyter_core.paths import jupyter_path
print(jupyter_path('nbconvert','templates'))
于 2019-11-18T03:24:20.807 回答
1

nbconvert我在安装到自定义位置时遇到了这个问题：

pip install --target=/foooooo/baaaaar nbconvert

你只需要设置一个JUPYTER_PATH环境变量。

JUPYTER_PATH=/foooooo/baaaaar/share/jupyter
于 2020-11-27T11:41:28.123 回答
0

作为编辑的替代方法，jupyter_nbconvert_config.py您还可以编辑jupyter_nbconvert_config.json. 首先断言它~/.jupyter在配置路径中，带有jupyter --path. 然后插入jupyter_nbconvert_config.json模板目录。我添加了一个子文件夹custome_templates到我的：

{
  "Exporter": {
    "template_path": [
      ".", 
      "/home/moutsopoulosg/miniconda/envs/myenv/lib/python2.7/site-packages/jupyter_contrib_nbextensions/templates",
      "/home/moutsopoulosg/.jupyter/custom_templates"
    ], 
    ...
  },
  "version": 1
}

然后nbconvert --template mytemplate Untitiled.ipynb拿起我的模板。

于 2020-06-30T13:17:15.570 回答