Comment afficher les équations mathématiques dans le démarquage général de github (pas le blog de github)
Après mes recherches, j'ai découvert que mathjax pouvait le faire. Mais quand écrire quelques exemples dans mon fichier de démarquage, il ne peut pas montrer les équations correctes:
J'ai ajouté ceci dans la tête du fichier de démarque:
<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=default"></script>
Et tapez l'instruction mathjax:
(E = mc ^ 2) ， $$ x_ {1,2} =\frac {-b\pm\sqrt {b ^ 2-4ac}} {2b}. $$
Mais github ne montre rien pour les symboles mathématiques! aidez-moi s'il vous plaît, merci! Dites-moi comment afficher les symboles mathématiques dans le github markdown général.
Mais github ne montre rien pour les symboles mathématiques! aidez-moi s'il vous plaît, merci!
L'analyse de démarquage GitHub est effectuée par la bibliothèque SunDown (ex libUpSkirt).
La devise de la bibliothèque est "Conformité aux normes, rapide} _ secure _ bibliothèque de traitement du démarquage en C". Le mot important étant "sécurisé", considérant votre question :).
En effet, autoriser l'exécution de javascript serait un peu en dehors du contrat standard MarkDown de texte en HTML.
De plus, tout ce qui ressemble à une balise HTML est échappé ou effacé.
Dites-moi comment afficher les symboles mathématiques dans le markdown github général.
Votre meilleur choix serait de trouver un site Web similaire à - yuml.me qui puisse générer des images à la volée à partir de l'analyse de la chaîne de requête URL fournie.
Mettre à jour
J'ai trouvé certains sites proposant un tel service aux utilisateurs: codedogs.com (ne semble plus être compatible avec l'intégration) ou iTex2Img ..__ Vous voudrez peut-être les essayer. Bien entendu, d'autres peuvent exister et certains Google-fu vous aideront à les trouver.
compte tenu de la syntaxe de démarquage suivante
il affichera l'image suivante
Remarque: pour que l'image soit correctement affichée, vous devez vous assurer que la partie chaîne de la chaîne de requête de l'URL est codée pour cent. Vous pouvez facilement trouver des outils en ligne pour vous aider dans cette tâche, tels que www.url-encode-decode.com
Markdown prend en charge le HTML incorporé. Le HTML en ligne peut être utilisé pour des équations en ligne simples et rapides et, avec un outil externe, un rendu plus complexe.
En ligne simple et rapide
Pour les éléments en ligne simples et rapides, utilisez l'esperluette HTML les codes d'entité . Un exemple combinant cette idée avec le texte en indice dans Markdown est: hθ(x) = θo x + θ1x, dont le code suit.
h<sub>θ</sub>(x) = θ<sub>o</sub> x + θ<sub>1</sub>x
Des esquisses HTML et commerciales pour les symboles mathématiques courants peuvent être trouvées ici . Codes pour les lettres grecques ici .
Bien que cette approche ait des limites, elle fonctionne dans pratiquement toutes les démarques et ne nécessite aucune bibliothèque externe.
Rendu en ligne complexe évolutif avec LaTeX et Codecogs
Si vos besoins sont plus grands, utilisez un moteur de rendu externe LaTeX tel que CodeCogs. Créez une équation avec Editeur CodeCogs . Choisissez svg pour le rendu et HTML pour le code d'intégration. Svg rend bien sur redimensionner. HTML permet à LaTeX d'être facilement lu lorsque vous regardez la source. Copiez le code incorporé au bas de la page et collez-le dans votre démarque.
<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}" />
Ceci combine cette réponse et cette réponse .
GitHub ne prend en charge que parfois l’utilisation de la syntaxe HTML brute ci-dessus pour LaTeX lisible pour moi. Si ce qui précède ne fonctionne pas pour vous, vous pouvez également choisir le rendu URL Encoded et utiliser cette sortie pour créer manuellement un lien du type:
Cela incorpore manuellement LaTex dans le texte de l'image alternative et utilise une URL codée pour le rendu sur GitHub.
Rendu multi-lignes
Si vous avez besoin d'un rendu multiligne, consultez cette réponse .
Une autre solution consiste à utiliser les blocs-notes Jupyter et à utiliser le mode de démarquage dans les cellules pour rendre les équations.
Les choses de base semblent fonctionner parfaitement, comme les équations centrées
\begin{equation}
...
\end{equation}
ou équations en ligne
$ \sum_{\forall i}{x_i^{2}} $
Cependant, une des fonctions que je voulais vraiment ne pas rendre du tout dans github était \mbox{}, ce qui était décevant. Mais dans l’ensemble, c’est le moyen le plus efficace de rendre des équations sur github.
Si vous vouliez seulement montrer des mathématiques dans le navigateur, essayez l’extension Chrome GitHub avec MathJax . C'est assez pratique.
Bien que GitHub n'interprète pas les formules MathJax, vous pouvez générer automatiquement un nouveau document Markdown avec les formules remplacées par des images.
Je vous suggère de regarder l'application GitHub TeXify :
GitHub App qui cherche dans vos pushs les fichiers avec l'extension * .tex.md et restitue ses expressions TeX sous forme d'images SVG
Comment ça marche (depuis le répertoire source ):
Chaque fois que vous poussez, TeXify s'exécutera et recherchera les fichiers * .tex.md dans votre dernier commit. Readme2tex utilise des expressions LaTeX délimitées par des signes dollar, le convertit en images SVG standard, puis enregistre la sortie dans un fichier d'extension .md sera traité et le résultat sera enregistré sous le nom README.md). Après cela, le fichier de sortie et les nouvelles images SVG sont ensuite validés et transférés dans votre référentiel.
En ce qui concerne la conversion tex → image, l'outil LaTeXiT produit une sortie de qualité bien supérieure. Je pense que c’est standard dans la plupart des distributions TeX, mais vous pouvez certainement le trouver en ligne si vous ne l’avez pas déjà. Tout ce que vous avez à faire est de le placer dans TeX, de faire glisser l'image sur votre bureau, puis de le faire glisser de votre bureau vers un site d'hébergement d'images (j'utilise imgur).