Gitlab Pages mathjax

Я использую Gitlab Pages для размещения документации, созданной с помощью Sphinx.

Возможно ли сделать математику с помощью MathJax, используя Gitlab Pages? Из моего тестирования, уравнения не отображаются. Нужно ли устанавливать MathJax вместе с doc, чтобы это работало? Сгенерированная документация правильно отображается на локальном компьютере.

Источник

1 ответ

Решение

Нет. От: https://docs.gitlab.com/ee/user/project/pages/getting_started_part_one.html

GitLab Pages поддерживает только статические веб-сайты. Это означает, что ваши выходные файлы должны быть только HTML, CSS и JavaScript.

Вы можете визуализировать статический сайт с помощью процесса на локальном компьютере и передать результат в свой репозиторий или с непрерывной интеграцией с помощью GitLab CI. Вот запись в блоге, где GitLab использует Nanoc вместо Sphinx, но вы можете заменить его в своем CI.

Источник

Я использую не Sphinx, а другой генератор статических сайтов для страниц gitlab. Рендеринг с помощью mathjax у меня отлично работает. Мне не пришлось делать ничего особенного, просто в моем <head> элемент:

<script type="text/javascript" id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js">
</script>
Источник
Другие вопросы по тегам