Як показати рівняння математики в цілому відмітка Github (не блог github)


150

Після дослідження я виявив, що математика може це зробити. Але коли я записую приклад у свій файл розмітки, він не показує правильних рівнянь:

Я додав це в голову файлу розмітки:

<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.


2
Це не вирішує проблему для звичайних користувачів, але ця відповідь передбачає сценарій браузера , який може по крайней мере , дозволить вам побачити рівняння: stackoverflow.com/q/11255900/180892
Jeromy Anglim

gitlab використовує KaTeX
Foad

Відповіді:


143

Але github нічого не показує для математичних символів! допоможіть мені, дякую!

Аналіз розмітки GitHub виконується бібліотекою SunDown (ex libUpSkirt).

Девіз бібліотеки - " Бібліотека, що підтримує стандарти, швидка, безпечна бібліотека для обробки відміток на С" . Важливе слово - "безпечно" там, враховуючи ваше питання :).

Дійсно, дозволяти виконувати javascript було б трохи від стандартного контракту з текстовим HTML-текстом MarkDown.

Більше того, все те, що схоже на тег HTML, або усувається, або викреслюється.

Розкажіть, як показувати математичні символи в цілому націнки на github.

Найкраще було б знайти веб-сайт, схожий на yuml.me, який може генерувати зображення на льоту, аналізуючи наданий рядок запитів URL-адреси.

Оновлення

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

з урахуванням наступного синтаксису розмітки

![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


6
@nultoken, дякую за корисну відповідь. Я використовував веб-сайт iTex2Img, про який ви згадували вище, і я додав до своєї документації дві формули. У мене виникла проблема, що коли я відкриваю сторінку документації на GitHub, обидві формули відображаються однаково, хоча вони насправді різні. Чи знаєте ви, чому це відбувається?
Сем

3
mathurl.com - також примітний веб-сайт, якщо вам доведеться генерувати зображення.
Мартін Тома

2
Схоже, це не працює на github. Зображення не відображається. Хтось знає, чому?
OganM

1
@OganM Синтаксис змінився. Посилання було виправлено та протестовано також у GitHub
nulltoken

1
Сайт iTex2Img, здається, не працює для мене постійно. Здається, зображення не відображається на Github.
тембрам

91

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

Швидкий і простий вбудований

Для швидкого та простого вбудованого використання використовуйте HTML- коди та коди сутності . Прикладом, який поєднує цю ідею з текстом підрозділу під час розмітки, є: h θ (x) = θ o x + θ 1 x, код для якого випливає далі.

    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}" />

Це поєднує цю відповідь і цю відповідь .

Підтримка GitHub працювала лише іноді, використовуючи вищевказаний синтаксис html для читаного для мене LaTeX. Якщо вищезгадане не працює для вас, іншим варіантом є натомість вибрати рендерированное URL-кодування та використовувати цей вихід для вручну створити посилання на зразок:

\ Великий 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 в текст alt зображення і використовує закодовану URL-адресу для візуалізації в GitHub.

Багатолінійна візуалізація

Якщо вам потрібно багаторядкове візуалізація, ознайомтеся з цією відповіддю .


1
це чудово працювало. Мені довелося перетворити зошит юпітера (.ipynb) в, .mdа рівняння були по суті багатолінійним латексним кодом.
Марк Максмайстер

12

Якщо ви просто хотіли показати математику в браузері для себе, ви можете спробувати розширення Chrome GitHub з MathJax . Це досить зручно.


1
при спробі встановити
Homero Esmeraldo

10

Ще однією проблемою є використання зошитів з юпітером та використання режиму розмітки в клітинках для відображення рівнянь.

Здається, базовий матеріал ідеально працює, як по центру з рівняннями

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

або вбудовані рівняння

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

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


3
Дякую за цю відповідь, але є ця проблема: мені вдалося використати зошит юпітера в режимі розмітки, і рівняння видається нормальним. Однак, тепер, як ви можете перенести цю надписку на юпітер readme.mdна GitHub?
DavidC.

1
Рівняння не відображаються безпосередньо у файлах Markdown. Рівняння, як правило, повинні бути зображеннями, щоб бути на readme.md. Однак ви завжди можете просто покласти file.ipynbна github, і github це робить добре.
гексил

8

Зараз 2020 рік, дозвольте підвести підсумки прогресу математичної формули, що надає підтримку хостів сховища вихідного коду.

GitHub & Bitbucket

GitHub і Bitbucket все ще не підтримують візуалізацію математичних формул, будь то роздільники за замовчуванням чи інші.

Cloud Bitbucket / BCLOUD-11192 - Додати підтримку LaTeX у документах MarkDown (BB-12552)

GitHub / markup - Візуалізація математичних рівнянь

GitHub / розмітка - Підтримка латексу

Форум спільноти GitHub - [ЗАПИТАННЯ ОСОБЛИВОСТІ] LaTeX Math in Markdown

talk.commonmark.org - Чи може бути додана математична формула до розмітки

За останні роки GitHub майже не досяг значного прогресу.

GitLab

GitLab вже підтримується, але це не найпоширеніший спосіб. Тут використовується власний роздільник.

This math is inline $`a^2+b^2=c^2`$.

This is on a separate line

```math
a^2+b^2=c^2
```

GitLab Flavoured Markdown - Math

Хто підтримує універсальні роздільники?

Аналізатор Маркдауна, використовуваний Гюго

Інші способи візуалізації


6

Поки GitHub не інтерпретує формули MathJax, ви можете автоматично генерувати новий документ Markdown, формули замінені зображеннями.

Пропоную переглянути додаток GitHub TeXify :

Додаток GitHub, який шукає файли з розширенням * .tex.md і надає виразів TeX у вигляді SVG-зображень

Як це працює (із сховища джерел ):

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


2

Існує хороше рішення для вашої проблеми - використовуйте плагін TeXify github (згаданий Томом Хейлом відповідь, - але я розробив його відповідь за даним посиланням нижче) - детальніше про цей плагін Github та пояснення, чому це хороший підхід, ви можете знайти в цій відповіді .


2

Я використовую наведений нижче процес для перетворення рівнянь у розмітку. Це дуже добре працює для мене. Це дуже просто !!

Скажімо, я хочу представити рівняння множення матриць

Крок 1:

Отримайте сценарій для своїх формул тут - https://csrgxtu.github.io/2015/03/20/Writing-Mathematic-Fomulars-in-Markdown/

Мій приклад: Я хотів представити Z(i,j)=X(i,k) * Y(k, j); k=1 to nформули підсумовування. Посилаючись на веб-сайт, потрібен сценарій =>

введіть тут опис зображення

Z_i_j=\sum_{k=1}^{10} X_i_k * Y_k_j

Крок 2:

Використовуйте кодер URL - https://www.urlencoder.org/, щоб перетворити скрипт у дійсний URL

Мій приклад:

введіть тут опис зображення

Крок 3:

Використовуйте цей веб-сайт для створення зображення, вставляючи копію результатів із кроку 2 в параметр запиту "eq" - http://www.sciweavers.org/tex2img.php?eq=<b><i>paste-output-here</i></b>&bc=White&fc=Black&im=jpg&fs=12&ff=arev&edit=

- Мій приклад:
http://www.sciweavers.org/tex2img.php?eq=Z_i_j=\sum_{k = 1} ^ {10}% 20X_i_k% 20 *% 20Y_k_j & bc = Білий & fc = Чорний & im = jpg & fs = 12 & ff = arev & edit =

введіть тут опис зображення

Крок 4:

Референтне зображення за допомогою синтаксису розмітки - ![alt text](enter url here)

- Скопіюйте це у своєму розмітці, і ви готові:

![Z(i,j)=X(i,k) * Y(k, j); k=1 to n](http://www.sciweavers.org/tex2img.php?eq=Z_i_j%3D%5Csum_%7Bi%3D1%7D%5E%7B10%7D%20X_i_k%20%2A%20Y_k_j&bc=White&fc=Black&im=jpg&fs=12&ff=arev&edit=)

Зображення нижче - це результат розмітки. Ура !!


введіть тут опис зображення


хто читає це, "Typora" - це мій новий улюблений додаток для відмітки .. просто кажу
Dexter

0

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


Слід зазначити, що, здається, LaTeXiT працює лише під MacOS (хоча це прямо не вказано на веб-сайті).
cuacu.–

0

Я використовував наступне в заголовку файлу розмітки

<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}. $$
Це працювало для мене

Використовуючи наш веб-сайт, ви визнаєте, що прочитали та зрозуміли наші Політику щодо файлів cookie та Політику конфіденційності.
Licensed under cc by-sa 3.0 with attribution required.