Comment montrer les équations mathématiques en général (pas le blog de github)

Après mon enquête, j’ai trouvé que mathjax pouvait le faire. Mais lorsque vous écrivez un exemple dans mon fichier de démarquage, il ne peut pas afficher les équations correctes:

J’ai ajouté ceci dans la tête du fichier markdown:

 

Et tapez la déclaration 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 en mode github général.

Mais github ne montre rien pour les symboles mathématiques! aidez-moi s’il vous plaît, merci!

L’parsing syntaxique GitHub est effectuée par la bibliothèque SunDown (ex libUpSkirt).

La devise de la bibliothèque est Bibliothèque de traitement de démarques sécurisée , rapide et conforme aux normes en C” . Le mot important étant “sécurisé”, compte tenu de votre question :).

En effet, autoriser l’exécution de javascript serait un peu en dehors du contrat standard text-to-HTML de MarkDown.

De plus, tout ce qui ressemble à une balise HTML est échappé ou supprimé.

Dites-moi comment afficher les symboles mathématiques en mode github général.

Votre meilleur pari serait de trouver un site Web similaire à yuml.me qui puisse générer des images à la volée en analysant la chaîne de requête URL fournie.

Mettre à jour

J’ai trouvé certains sites fournissant aux utilisateurs un tel service: codedogs.com ( ne semble plus prendre en charge l’intégration ) ou iTex2Img . Vous voudrez peut-être les essayer. Bien sûr, d’autres peuvent exister et certains Google-fu vous aideront à les trouver.

compte tenu de la syntaxe de démarquage suivante

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

il affichera l’image suivante

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

Remarque : Pour que l’image soit correctement affichée, vous devez vous assurer que la partie chaîne de requête de l’URL est codée en pourcentage . Vous pouvez facilement trouver des outils en ligne pour vous aider dans cette tâche, tels que http://www.url-encode-decode.com

Markdown prend en charge le HTML en ligne. Le HTML en ligne peut être utilisé pour les équations en ligne rapides et simples et, avec les outils externes, pour un rendu plus complexe.

Simple et rapide Inline

Pour les éléments en ligne simples et rapides, utilisez les codes d’entité et d’ esperformance HTML. Un exemple qui combine cette idée avec un texte en indice dans le démarquage est: h θ (x) = θ o x + θ 1 x dont le code suit.

  hθ(x) = θo x + θ1x 

Vous trouverez ici les codes d’entité d’esperluette HTML pour les symboles mathématiques courants. Codes pour les lettres grecques ici .

Bien que cette approche comporte des limitations, elle fonctionne dans pratiquement toutes les démarques et ne nécessite aucune bibliothèque externe.

Rendu en ligne évolutif complexe avec LaTeX et Codecogs

Si vos besoins sont plus importants, utilisez un moteur de rendu LaTeX externe tel que CodeCogs. Créez une équation avec l’ éditeur CodeCogs . Choisissez svg pour le rendu et HTML pour le code d’intégration. Svg rend bien sur le redimensionnement. HTML permet de lire facilement LaTeX lorsque vous consultez la source. Copiez le code d’intégration depuis le bas de la page et collez-le dans votre balise.

  

Cela combine cette réponse et cette réponse .

GitHub supporte seulement parfois la syntaxe html ci-dessus pour lire LaTeX lisible. Si ce qui précède ne fonctionne pas pour vous, une autre option consiste à choisir le rendu encodé par URL et à utiliser cette sortie pour créer manuellement un lien tel que:

\ 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) 

Cela incorpore manuellement LaTex dans le texte de l’image alt et utilise une URL codée pour le rendu sur GitHub.

Rendu multiligne

Si vous avez besoin d’un rendu multiligne, consultez cette réponse .

Un autre travail consiste à utiliser des blocs-notes jupyter et à utiliser le mode de démarquage dans les cellules pour rendre les équations.

Les éléments 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, l’une des fonctions que je voulais vraiment n’était pas du tout dans github, c’était \mbox{} , ce qui était une déception. Mais dans l’ensemble, cela a été le moyen le plus efficace de rendre des équations sur github.

Si vous vouliez simplement afficher des maths dans le navigateur pour vous-même, vous pouvez essayer l’extension Chrome GitHub avec MathJax . C’est très 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 :

Application GitHub qui recherche dans vos push les fichiers avec l’extension * .tex.md et affiche ses expressions TeX en images SVG

Comment ça marche (à partir du référentiel source ):

Chaque fois que vous appuyez sur TeXify, vous exécuterez et rechercherez les fichiers * .tex.md lors de votre dernier commit. Pour chacun de ceux-ci, readme2tex sera exécuté, ce qui prendra les expressions LaTeX entre les signes dollar, les convertira en images SVG simples, puis enregistrera la sortie dans un fichier d’extension .md (cela signifie qu’un fichier nommé README.tex.md sera traité et la sortie sera enregistrée sous README.md). Après cela, le fichier de sortie et les nouvelles images SVG sont ensuite validées et renvoyées à votre repository.

En ce qui concerne la conversion d’image en tex, l’outil LaTeXiT produit une sortie de qualité bien supérieure. Je crois que c’est la norme dans la plupart des dissortingbutions 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 le TeX, de faire glisser l’image sur votre bureau, puis de faire glisser votre bureau vers un site d’hébergement d’images (j’utilise imgur).

J’ai utilisé ce qui suit dans le fichier de tête de marque

  

Puis tapé l'instruction mathjax suivante
$$ x_ {1,2} = \ frac {-b \ pm \ sqrt {b ^ 2-4ac}} {2b}. $$
Ça a fonctionné pour moi