Nach der Untersuchung habe ich festgestellt, dass Mathjax dies kann. Wenn ich jedoch ein Beispiel in meine Markdown-Datei schreibe, werden die richtigen Gleichungen nicht angezeigt:
Ich habe dies im Kopf der Markdown-Datei hinzugefügt:
<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=default"></script>
Und geben Sie die mathjax-Anweisung ein:
(E = mc ^ 2) , $$ x_ {1,2} = \ frac {-b \ pm \ sqrt {b ^ 2-4ac}} {2b}. $$
Aber Github zeigt nichts für die mathematischen Symbole! Bitte helfen Sie mir, danke! Sagen Sie mir, wie man mathematische Symbole auf Github-Markdown-Seiten anzeigt.
Antworten:
Das Analysieren von GitHub-Markdowns wird von der SunDown- Bibliothek (ex libUpSkirt) durchgeführt.
Das Motto der Bibliothek lautet "Standardkonforme, schnelle und sichere Markdown-Verarbeitungsbibliothek in C" . Das wichtige Wort ist dort "sicher", wenn man Ihre Frage berücksichtigt :).
In der Tat würde die Ausführung von Javascript etwas vom MarkDown-Standardvertrag für Text-zu-HTML abweichen.
Darüber hinaus wird alles, was wie ein HTML-Tag aussieht, entweder maskiert oder entfernt.
Am besten finden Sie eine Website ähnlich wie yuml.me , auf der Sie Bilder analysieren können, indem Sie den bereitgestellten URL-Querystring analysieren.
Aktualisieren
Ich habe einige Websites gefunden, die Benutzern einen solchen Service anbieten : codedogs.com ( scheint das Einbetten nicht mehr zu unterstützen ) oder iTex2Img . Vielleicht möchten Sie sie ausprobieren. Natürlich können andere existieren und einige Google-Fu helfen Ihnen, sie zu finden.
gegeben die folgende Markdown-Syntax
Das folgende Bild wird angezeigt
Gleichung http://www.sciweavers.org/tex2img.php?eq=1%2Bsin%28mc%5E2%29&bc=White&fc=Black&im=jpg&fs=12&ff=arev&edit=
Hinweis : Damit das Bild richtig angezeigt wird, müssen Sie sicherstellen, dass der Querystring-Teil der URL prozentual codiert ist . Sie können leicht Online-Tools finden, die Ihnen bei dieser Aufgabe helfen, z. B. www.url-encode-decode.com
quelle
Markdown unterstützt Inline-HTML. Inline-HTML kann sowohl für schnelle als auch für einfache Inline-Gleichungen und mit einem externen Tool für komplexeres Rendern verwendet werden.
Schnelle und einfache Inline
Verwenden Sie für schnelle und einfache Inline-Elemente HTML-kaufmännische Und- Entitätscodes . Ein Beispiel, das diese Idee mit tiefgestelltem Text in Abschriften kombiniert, ist: h & thgr ; (x) = & thgr ; o x + & thgr; 1 x, dessen Code folgt.
HTML-kaufmännische Und-Entitätscodes für gängige mathematische Symbole finden Sie hier . Codes für griechische Buchstaben hier .
Obwohl dieser Ansatz Einschränkungen aufweist, funktioniert er in praktisch allen Abschriften und erfordert keine externen Bibliotheken.
Komplexes skalierbares Inline-Rendering mit LaTeX und Codecogs
Wenn Ihre Anforderungen höher sind, verwenden Sie einen externen LaTeX-Renderer wie CodeCogs. Erstellen Sie eine Gleichung mit dem CodeCogs-Editor . Wählen Sie zum Rendern svg und für den Einbettungscode HTML. Svg lässt sich beim Ändern der Größe gut rendern. Mit HTML kann LaTeX leicht gelesen werden, wenn Sie sich die Quelle ansehen. Kopieren Sie den Einbettungscode vom unteren Rand der Seite und fügen Sie ihn in Ihren Markdown ein.
Dies kombiniert diese Antwort und diese Antwort .
Die GitHub- Unterstützung funktionierte nur gelegentlich mit der oben genannten rohen HTML-Syntax für lesbares LaTeX für mich. Wenn dies für Sie nicht funktioniert, können Sie stattdessen auch URL-codiertes Rendering auswählen und diese Ausgabe verwenden, um manuell einen Link wie folgt zu erstellen:
Dadurch wird LaTex manuell in den Alternativbildtext integriert und eine codierte URL zum Rendern auf GitHub verwendet.
Mehrzeiliges Rendern
Wenn Sie mehrzeiliges Rendern benötigen, lesen Sie diese Antwort .
quelle
.md
und die Gleichungen waren im Wesentlichen mehrzeiliger Latexcode .Wenn Sie nur selbst Mathematik im Browser anzeigen möchten, können Sie die Chrome-Erweiterung GitHub mit MathJax ausprobieren . Es ist sehr praktisch.
quelle
Eine andere Lösung besteht darin, Jupyter-Notizbücher zu verwenden und den Markdown-Modus in Zellen zum Rendern von Gleichungen zu verwenden.
Grundlegende Dinge scheinen perfekt zu funktionieren, wie zentrierte Gleichungen
oder Inline-Gleichungen
Obwohl eine der Funktionen, die ich wirklich wollte, in Github überhaupt nicht gerendert wurde
\mbox{}
, war das ein Mist. Alles in allem war dies jedoch die erfolgreichste Methode, um Gleichungen auf Github zu rendern.quelle
readme.md
GitHub übertragen?readme.md
. Sie können jedoch immer nurfile.ipynb
Github anziehen und Github macht es gut.Lassen Sie mich jetzt den Fortschritt der Unterstützung für das Rendern mathematischer Formeln von Quellcode-Repository-Hosts zusammenfassen.
GitHub & Bitbucket
GitHub und Bitbucket unterstützen das Rendern mathematischer Formeln immer noch nicht , unabhängig davon, ob es sich um Standardbegrenzer oder andere handelt.
GitHub hat in den letzten Jahren kaum wesentliche Fortschritte gemacht.
GitLab
GitLab wird bereits unterstützt, ist jedoch nicht die häufigste Methode. Es verwendet ein eigenes Trennzeichen.
Wer unterstützt die universellen Begrenzer?
Ein von Hugo verwendeter Markdown-Parser
Andere Möglichkeiten zum Rendern
Verwenden Sie die Web-API, um gemäß einem Hack zum Rendern von LaTeX-Formeln in GitHub-Markdown zu rendern. Sie können sogar ein Jupiter-Notizbuch schreiben.
readme2tex
quelle
Während GitHub die MathJax-Formeln nicht interpretiert, können Sie automatisch ein neues Markdown-Dokument generieren, wobei die Formeln durch Bilder ersetzt werden.
Ich schlage vor, Sie schauen sich die GitHub-App TeXify an :
So funktioniert es (aus dem Quell-Repository ):
quelle
Es gibt eine gute Lösung für Ihr Problem - verwenden Sie das TeXify- Github-Plugin (von Tom Hale erwähnt - aber ich habe seine Antwort unter dem unten angegebenen Link entwickelt) - weitere Details zu diesem Github-Plugin und eine Erklärung, warum dies ein guter Ansatz ist, finden Sie in dieser Antwort .
quelle
Ich verwende den unten genannten Prozess, um Gleichungen in Markdown umzuwandeln. Das funktioniert sehr gut für mich. Es ist sehr einfach!!
Angenommen, ich möchte die Matrixmultiplikationsgleichung darstellen
Schritt 1:
Das Skript für Ihre Formeln erhalten Sie hier - https://csrgxtu.github.io/2015/03/20/Writing-Mathematic-Fomulars-in-Markdown/
Mein Beispiel: Ich wollte
Z(i,j)=X(i,k) * Y(k, j); k=1 to n
in Summationsformeln darstellen. Unter Bezugnahme auf die Website war das erforderliche Skript =>Z_i_j=\sum_{k=1}^{10} X_i_k * Y_k_j
Schritt 2:
Verwenden Sie den URL-Encoder - https://www.urlencoder.org/ , um das Skript in eine gültige URL zu konvertieren.
Mein Beispiel:
Schritt 3:
Verwenden Sie diese Website, um das Bild zu generieren, indem Sie die Ausgabe aus Schritt 2 in den Anforderungsparameter "eq" kopieren -
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=
- Mein Beispiel:
http://www.sciweavers.org/tex2img.php?eq=Z_i_j=\sum_{k = 1} ^ {10}% 20X_i_k% 20 *% 20Y_k_j & bc = Weiß & fc = Schwarz & im = jpg & fs = 12 & ff = arev & edit =
Schritt 4:
Referenzbild mit Markdown-Syntax -
![alt text](enter url here)
- Kopieren Sie dieses Bild in Ihren Markdown und los geht's:
![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=)
Bild unten ist die Ausgabe von Markdown. Hurra!!
quelle
In Bezug auf die Tex → Bildkonvertierung erzeugt das Tool LaTeXiT eine Ausgabe mit viel höherer Qualität. Ich glaube, es ist Standard in den meisten TeX-Distributionen, aber Sie können es sicherlich online finden, wenn Sie es noch nicht haben. Alles, was Sie tun müssen, ist, es in die TeX zu legen, das Bild auf Ihren Desktop zu ziehen und dann von Ihrem Desktop auf eine Bildhosting-Site zu ziehen (ich verwende imgur).
quelle
Ich habe Folgendes im Kopf der Mark-Down-Datei verwendet
Geben Sie dann die folgende mathjax-Anweisung ein:
$$ x_ {1,2} = \ frac {-b \ pm \ sqrt {b ^ 2-4ac}} {2b}. $$
Es hat bei mir funktioniert
quelle