Уравнение нумерации в ноутбуках Jupyter

Дело в том, что в официальной документации Jupyter - мотивирующие примеры стоит

Нумерация и ссылки на уравнения будут доступны в будущей версии ноутбука Jupyter.

Я знаю, что в этой теме много дискуссий. Есть некоторые люди, которые утверждают, что решили эту проблему с некоторыми обходными решениями.

Но для обычного пользователя трудно понять обходные пути, или как грязные/полезные хаки на самом деле.

Итак, мои вопросы:

  • Что означает "доступный в будущей версии"? Означает ли это что-то вроде "нового месяца/года" или что-то вроде "вероятно, никогда, потому что это слишком невозможно"?

  • Если какой-либо из обходных решений, предоставляемых в Интернете, безопасен для потребления человеком? Я имею в виду, это достойно? Поскольку для создания обучающих программ можно использовать Sphinx или что-то еще, это будет больше работы, но будет ли больше работы по внедрению некоторых хаков, установке плагинов и т.д.?

Примечание. Для кого-то это может показаться вопросом, требующим ответа на основе мнения, но я уверен, что это не так. Любые советы могут помочь мне (или другим пользователям) принять хорошее/плохое решение.

Ответ 1

Я считаю, что практически всю информацию, относящуюся к этому вопросу, можно найти в этой длинной ветке Github.

Разговор там продолжается (в данный момент) 3,5 года и все еще активен. Важные моменты:

  • Вы можете очень просто включить нумерацию, выполнив ячейку со следующим содержимым:

    %%javascript
    MathJax.Hub.Config({
        TeX: { equationNumbers: { autoNumber: "AMS" } }
    });
    
  • Существует расширение для нумерации уравнений.

  • Разработчик minrk предположил, что это расширение является правильным подходом и может быть объединено с master (но функциональность будет отключена по умолчанию).

Чтобы установить расширение через pip:

pip install jupyter_contrib_nbextensions

Чтобы установить расширения через Anaconda:

conda install -c conda-forge jupyter_contrib_nbextensions 

После использования одного из способов установки, указанных выше, включите расширение:

jupyter contrib nbextension install --user
jupyter nbextension enable equation-numbering/main

Ответ 2

Перейдите в редактор Jupyter Notebook (я сейчас использую Anaconda), меню "Правка", последний пункт "nbextensions config". Откроется страница, где вы можете увидеть список расширений, одним из которых является "Автоматическая нумерация уравнений". Включите его и перезапустите ноутбук. Вы увидите, что в верхней части вашего ноутбука появляется кнопка для сброса нумерации уравнений. Вам нужно будет нажимать эту кнопку время от времени.