Как показать математические уравнения в целом github markdown (не блог github)

После моего расследования я обнаружил, что mathjax может это сделать. Но при написании некоторого примера в моем файле уценки он не может отображать правильные уравнения:

Я добавил это в начало файла уценки:

<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=default"></script>

И введите инструкцию mathjax:

(E = mc ^ 2), $$ x_ {1,2} =\frac {-b\pm\sqrt {b ^ 2-4ac}} {2b}. $$

Но github ничего не показывает для математических символов! пожалуйста, помогите мне, спасибо! Расскажите мне, как показывать математические символы в целом по упадку github.

Ответ 1

Но github ничего не показывает для математических символов! пожалуйста, помогите мне, спасибо!

Разбор синтаксиса GitHub выполняется библиотекой SunDown (ex libUpSkirt).

Девизом библиотеки является "Стандартная совместимость, быстрая, безопасная библиотека обработки разметки в C". Важное слово "безопасно" там, учитывая ваш вопрос:).

В действительности, позволяя javascript, который будет выполняться, будет немного отличаться от стандартного контракта TextDocument MarkDown.

Кроме того, все, что выглядит как тег HTML, либо экранировано, либо лишено.

Расскажите, как показывать математические символы в общем уклоне github.

Лучше всего найти веб-сайт, похожий на yuml.me, который может генерировать on- летать изображения, анализируя предоставленную URL-цепочку.

Update

Я нашел несколько сайтов, предоставляющих пользователям такую услугу: codedogs.com (больше не поддерживается вложение) или iTex2Img. Вы можете попробовать их. Конечно, другие могут существовать, и некоторые Google-fu помогут вам найти их.

учитывая следующий синтаксис разметки

![equation](http://www.sciweavers.org/tex2img.php?eq=1%2Bsin%28mc%5E2%29&bc=White&fc=Black&im=jpg&fs=12&ff=arev&edit=)

отобразится следующее изображение

уравнение http://www.sciweavers.org/tex2img.php?eq=1%2Bsin%28mc%5E2%29&bc=White&fc=Black&im=jpg&fs=12&ff=arev&edit=

Примечание. Чтобы изображение было правильно отображено, вам нужно убедиться, что часть запроса строки URL процентов. Вы можете легко найти онлайн-инструменты, которые помогут вам в решении этой задачи, например www.url-encode-decode.com

Ответ 2

Markdown поддерживает встроенный HTML. Встроенный HTML может использоваться как для быстрых, так и для простых встроенных уравнений, а также с помощью внешнего инструмента и более сложного рендеринга.

Быстрый и простой встроенный

Для быстрых и простых встроенных элементов используйте амперсанд HTML и коды объектов. Пример, который сочетает в себе эту идею с индексом текста в уценки составляет: ч _θ (х) = θ _о х + θ ₁ х, код, для которого следует.

    h<sub>&theta;</sub>(x) = &theta;<sub>o</sub> x + &theta;<sub>1</sub>x

HTML амперсанд и коды сущностей для общих математических символов можно найти здесь. Коды для греческих букв здесь.

Хотя этот подход имеет ограничения, он работает практически во всех уценках и не требует каких-либо внешних библиотек.

Сложный масштабируемый встроенный рендеринг с LaTeX и Codecogs

Если ваши потребности больше, используйте внешний рендерер LaTeX, такой как CodeCogs. Создайте уравнение с помощью редактора CodeCogs. Выберите svg для рендеринга и HTML для встраивания кода. SVG оказывает хорошо на изменение размера. HTML позволяет легко читать LaTeX, когда вы смотрите на источник. Скопируйте код для вставки из нижней части страницы и вставьте его в уценку.

<img src="https://latex.codecogs.com/svg.latex?\Large&space;x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}" title="\Large x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}" />

$svg.latex?%5CLarge&space;x=%5Cfrac%7B-b%5Cpm%5Csqrt%7Bb%5E2-4ac%7D%7D%7B2a%7D$

Это объединяет этот ответ и этот ответ.

Поддержка GitHub только иногда работала с использованием вышеупомянутого необработанного синтаксиса html для читаемого LaTeX для меня. Если вышеупомянутое не работает для вас, другой вариант - вместо этого выбрать URL-кодированный рендеринг и использовать этот вывод для создания вручную ссылки, например:

$\Large x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$

![\Large x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}](https://latex.codecogs.com/svg.latex?x%3D%5Cfrac%7B-b%5Cpm%5Csqrt%7Bb%5E2-4ac%7D%7D%7B2a%7D)

Это вручную включает LaTex в текст альтернативного изображения и использует закодированный URL для рендеринга на GitHub.

Многострочный рендеринг

Если вам нужен многострочный рендеринг, проверьте этот ответ.

Ответ 3

Еще одна проблема - использовать jupyter notebooks и использовать режим уценки в ячейках для рендеринга уравнений.

Базовый материал, кажется, работает отлично, как центрированные уравнения

\begin{equation}
...
\end{equation}

или встроенные уравнения

$ \sum_{\forall i}{x_i^{2}} $

Хотя, одна из функций, которые я действительно хотела, вообще не отображалась в github, была \mbox{}, которая была обломкой. Но, во всем этом это был самый успешный способ рендеринга уравнений на github.

Ответ 4

Если вы просто хотите показать математику в браузере для себя, вы можете попробовать расширение Chrome GitHub с MathJax. Это довольно удобно.

Ответ 5

Хотя GitHub не будет интерпретировать формулы MathJax, вы можете автоматически создать новый документ Markdown с заменой формул изображениями.

Я предлагаю вам взглянуть на приложение GitHub TeXify:

Приложение GitHub, которое ищет в ваших файлах файлы с расширением *.tex.md и отображает их выражения TeX как изображения SVG.

Как это работает (из исходного репозитория):

Всякий раз, когда вы нажимаете, TeXify будет запускаться и искать файлы *.tex.md в вашем последнем коммите. Для каждого из них он запустит readme2tex, который примет выражения LaTeX, заключенные между знаками доллара, преобразует его в простые изображения SVG, а затем сохранит вывод в файл расширения .md (это означает, что файл с именем README.tex.md будет обработан и вывод будет сохранен как README.md). После этого выходной файл и новые изображения SVG затем фиксируются и возвращаются в репозиторий.

Ответ 6

Что касается преобразования tex → изображения, инструмент LaTeXiT производит намного более качественный выход. Я считаю, что он стандартный в большинстве дистрибутивов TeX, но вы можете найти его онлайн, если у вас его еще нет. Все, что вам нужно сделать, это поместить его в TeX, перетащить изображение на рабочий стол, а затем перетащить с рабочего стола на сайт для размещения изображений (я использую imgur).

Ответ 7

Есть хорошее решение для вашей проблемы - используйте плагин TeXify github (упомянутый в ответе Тома Хейла - но я разработал его ответ в приведенной ниже ссылке) - более подробную информацию об этом плагине github и объяснение, почему это хороший подход, вы можете найти в этом ответе.

Ответ 8

Я использовал следующее в заголовке файла вниз

<script type="text/javascript" async
src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js? 
config=TeX-MML-AM_CHTML"
</script>

Затем набрал следующее выражение mathjax
$$ x_ {1,2} =\frac {-b\pm\sqrt {b ^ 2-4ac}} {2b}. $$
У меня сработало