Правильное место для размещения пользовательских шаблонов 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, чтобы он знал, где искать стандартные шаблоны.