Пользовательский цвет для вывода LaTeX в пакете документации Sphinx

Question

Я пытаюсь настроить цвет встроенной формулы LaTeX при использовании пакета документации Sphinx и вывода html.

Подробности:

У меня есть файл с именем func.rst, которыйвключает следующую строку:

Let :math:`x_{1}` be a binary variable.

, которая успешно отображается в LaTeX в документации, которую я создал с помощью Sphinx.

(у меня 'sphinx.ext.imgmath' указано в extensions в conf.py)

Моя цель - сделать x_{1} окрашенным в красный цвет.

То, что я пробовал:

1. Добавление цвета в формулу:

   Let :math:`\color{red}x_{1}` be a binary variable.
   

   и определение

   latex_elements['preamble'] = '\usepackage{xcolor}'
   

   в файле conf.py.

2. Tryingопределить все математические результаты глобально с помощью:

   latex_elements['preamble'] = r'''
   \usepackage{xcolor}
   \everymath{\color{red}}
   \everydisplay{\color{red}}
   '''
   

Излишне говорить, что обе (и многие другие, менее многообещающие идеи) потерпели неудачу.

Answer 1

Для полноты картины я добавляю сюда полное решение.(СПАСИБО jfbu!)

1. В conf.py Я определил extensions = ['sphinx.ext.imgmath', <some_more_unrelated_stuff>]

2. Также в conf.py Я определил

   imgmath_latex_preamble=r'\usepackage{xcolor}'
   

   (РЕДАКТИРОВАТЬ: в отличие от того, что я ранее написал, нет необходимости дополнительно определять imgmath_latex="/usr/local/texlive/2017/bin/x86_64-darwin/latex" еще раз спасибо jfbu)

3. В файле .rst, где яу меня латексное выражение, у меня

   Let :math:`\color{red}x_{1}` be a binary variable.
   

4. В терминале я запускаю

   make clean html
   

   («сделать чистым» - лучший друг сфинкса)

И это работает!Wohoo!

Answer 2

Копирование моего ответа на перекрестный вопрос в tex.sx :

Поскольку вы, похоже, нацеливаетесь на HTML с математикой, отображаемой в виде изображений PNG (илиSVG), текущее значение конфигурации для настройки не latex_elements, но imgmath_latex_preamble.

С тех пор я проверял, и он работает.