Проблемы рендеринга MathJax с использованием Sphinx из-за HTML-CSS рендерера

Question

Я только что обновился до следующего:

Sphinx==1.8.5
nbconvert==5.4.1
pandoc==1.0.2

Я всегда мог рендерить математику в документах через блокнот jupyter, используя Sphinx (как это делается для seaborn).Однако после обновления математика больше не рендерится!Если я щелкну правой кнопкой мыши там, где должно быть уравнение, я могу изменить математическое средство рендеринга либо на «svg», либо на «CommonHTML», и все в порядке - он просто не рендерится с математическим средством рендеринга «HTML-CSS» по умолчанию по любой причине.Мой вопрос: как я могу изменить рендерер по умолчанию в моем конфигурационном файле?

Что я пробовал:

conf.py

...
extensions = [
    ...
    'sphinx.ext.mathjax'
    ...
]
...

mathjax_config = {
    'jax': ['input/TeX', 'output/CommonHTML']
}

Однако это неизмените рендерер по умолчанию, как я и думал.Кто-нибудь знает, как изменить рендерер по умолчанию для MathJax в Sphinx?

Вот gif:

Кроме того, это будетПохоже, что MathJax загружается из CDN с предпочтительной конфигурацией:

Answer 1

Я не уверен, как MathJax работал для вас раньше, но на основе Sphinx-документации MathJax не включен в Sphinx по умолчанию.Вы должны указать mathjax_path в conf.py, используя либо локальную версию, либо сервер, размещенный, например, с cdnjs .

Answer 2

Хотя я не смог заставить работать подход mathjax_config, я смог установить mathjax_path для конкретного выходного процессора, все еще через CDN, который работал с использованием CommonHTML.

Итак, ответ, который работает, - это отредактировать файл conf.py, добавив в него строку:

...
mathjax_path = "https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js?config=TeX-MML-AM_CHTML"
...