Después de investigar, descubrí que Mathjax puede hacer esto. Pero cuando escribo algún ejemplo en mi archivo de descuento, no muestra las ecuaciones correctas:
He agregado esto en el encabezado del archivo de descuento:
<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=default"></script>
Y escriba la declaración mathjax:
(E = mc ^ 2), $$ x_ {1,2} = \ frac {-b \ pm \ sqrt {b ^ 2-4ac}} {2b}. $$
¡Pero Github no muestra nada para los símbolos matemáticos! Por favor ayudame, gracias! Dime cómo mostrar símbolos matemáticos en las páginas de descuento de github.
Respuestas:
El análisis de rebajas de GitHub lo realiza la biblioteca SunDown (ex libUpSkirt).
El lema de la biblioteca es " Biblioteca de procesamiento de rebajas rápida, segura y que cumple con los estándares en C" . La palabra importante es "seguro", teniendo en cuenta su pregunta :).
De hecho, permitir que se ejecute JavaScript estaría un poco fuera del contrato estándar de texto a HTML de MarkDown.
Además, todo lo que parece una etiqueta HTML se escapa o se elimina.
Su mejor opción sería encontrar un sitio web similar a yuml.me que pueda generar imágenes sobre la marcha al analizar la cadena de consulta URL proporcionada.
Actualizar
He encontrado algunos sitios que ofrecen a los usuarios dicho servicio: codedogs.com ( ya no parece admitir la integración ) o iTex2Img . Es posible que desee probarlos. Por supuesto, pueden existir otros y algunos Google-fu te ayudarán a encontrarlos.
dada la siguiente sintaxis de rebaja
mostrará la siguiente imagen
ecuación http://www.sciweavers.org/tex2img.php?eq=1%2Bsin%28mc%5E2%29&bc=White&fc=Black&im=jpg&fs=12&ff=arev&edit=
Nota : para que la imagen se muestre correctamente, deberá asegurarse de que la parte de la cadena de consulta de la url esté codificada en porcentaje . Puede encontrar fácilmente herramientas en línea para ayudarlo con esa tarea, como www.url-encode-decode.com
fuente
Markdown admite HTML en línea. El HTML en línea se puede usar para ecuaciones en línea rápidas y simples y, con una herramienta externa, para una representación más compleja.
Inline rápido y simple
Para elementos en línea rápidos y simples, utilice códigos de entidad y ampersand HTML . Un ejemplo que combina esta idea con el texto del subíndice en markdown es: h θ (x) = θ o x + θ 1 x, cuyo código sigue.
Aquí se pueden encontrar códigos de entidad y símbolos HTML para símbolos matemáticos comunes . Códigos para letras griegas aquí .
Si bien este enfoque tiene limitaciones, funciona en prácticamente todas las rebajas y no requiere ninguna biblioteca externa.
Representación en línea escalable compleja con LaTeX y Codecogs
Si sus necesidades son mayores, use un procesador externo de LaTeX como CodeCogs. Crea una ecuación con el editor de CodeCogs . Elija svg para renderizar y HTML para el código de inserción. Svg rinde bien en cambiar el tamaño. HTML permite que LaTeX se lea fácilmente cuando se está mirando la fuente. Copie el código de inserción desde la parte inferior de la página y péguelo en su descuento.
Esto combina esta respuesta y esta respuesta .
El soporte de GitHub solo a veces funcionó utilizando la sintaxis html sin procesar anterior para LaTeX legible para mí. Si lo anterior no funciona para usted, otra opción es elegir la representación codificada en URL y usar esa salida para crear manualmente un enlace como:
Esto incorpora manualmente LaTex en el texto de la imagen alternativa y usa una URL codificada para renderizar en GitHub.
Renderizado multilínea
Si necesita una representación de varias líneas, consulte esta respuesta .
fuente
.md
y las ecuaciones eran esencialmente código de látex multilínea.Si solo desea mostrar las matemáticas en el navegador, puede probar la extensión de Chrome GitHub con MathJax . Es muy conveniente
fuente
Otra solución alternativa es usar cuadernos jupyter y usar el modo de reducción en las celdas para representar ecuaciones.
Las cosas básicas parecen funcionar perfectamente, como las ecuaciones centradas
o ecuaciones en línea
Aunque, una de las funciones que realmente quería no se mostraba en github era
\mbox{}
, que era un fastidio. Pero, en general, esta ha sido la forma más exitosa de representar ecuaciones en github.fuente
readme.md
GitHub?readme.md
. Sin embargo, siempre puedes ponertefile.ipynb
github y github lo hace bien.Ahora es 2020, permítanme resumir el progreso de la fórmula matemática que brinda soporte a los hosts del repositorio de código fuente.
GitHub y Bitbucket
GitHub y Bitbucket aún no admiten la representación de fórmulas matemáticas, ya sean los delimitadores predeterminados u otros.
GitHub apenas ha hecho ningún progreso sustancial en los últimos años.
GitLab
GitLab ya es compatible, pero no es la forma más común. Utiliza su propio delimitador.
¿Quién apoya a los delimitadores universales?
Un analizador Markdown usado por Hugo
Otras formas de renderizar
Utilice la API web para renderizar de acuerdo con un truco para mostrar fórmulas LaTeX en GitHub Markdown , incluso puede escribir Jupyter Notebook.
readme2tex
fuente
Si bien GitHub no interpretará las fórmulas MathJax, puede generar automáticamente un nuevo documento Markdown con las fórmulas reemplazadas por imágenes.
Le sugiero que mire la aplicación GitHub TeXify :
Cómo funciona (desde el repositorio de origen ):
fuente
Hay una buena solución para su problema: use el complemento github de TeXify (mencionado por la respuesta de Tom Hale , pero desarrollé su respuesta en el siguiente enlace): más detalles sobre este complemento github y explicación de por qué este es un buen enfoque que puede encontrar en esa respuesta .
fuente
Utilizo el proceso mencionado a continuación para convertir ecuaciones a rebajas. Este trabajo es muy bueno para mi. ¡¡Es muy simple!!
Digamos que quiero representar la ecuación de multiplicación de matrices.
Paso 1:
Obtenga el script para sus fórmulas desde aquí: https://csrgxtu.github.io/2015/03/20/Writing-Mathematic-Fomulars-in-Markdown/
Mi ejemplo: quería representar
Z(i,j)=X(i,k) * Y(k, j); k=1 to n
en una suma de fórmulas.Haciendo referencia al sitio web, el script necesario era =>
Z_i_j=\sum_{k=1}^{10} X_i_k * Y_k_j
Paso 2:
Use el codificador de URL: https://www.urlencoder.org/ para convertir el script en una URL válida.
Mi ejemplo:
Paso 3:
Utilice este sitio web para generar la imagen copiando y pegando la salida del Paso 2 en el parámetro de solicitud "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=
- Mi ejemplo:
http://www.sciweavers.org/tex2img.php?eq=Z_i_j=\sum_{k = 1} ^ {10}% 20X_i_k% 20 *% 20Y_k_j & bc = Blanco & fc = Negro & im = jpg & fs = 12 & ff = arev & edit =
Paso 4:
Imagen de referencia usando la sintaxis de rebajas
![alt text](enter url here)
- Copie esto en su rebaja y estará listo:
![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=)
La imagen a continuación es la salida del descuento. ¡¡Viva!!
fuente
Con respecto a la conversión de imágenes tex →, la herramienta LaTeXiT produce resultados de mucha mayor calidad. Creo que es estándar en la mayoría de las distribuciones de TeX, pero ciertamente puede encontrarlo en línea si aún no lo tiene. Todo lo que necesita hacer es ponerlo en el TeX, arrastrar la imagen a su escritorio, luego arrastre desde su escritorio a un sitio de alojamiento de imágenes (uso imgur).
fuente
Usé lo siguiente en el encabezado del archivo Mark Down
Luego escribí la siguiente declaración matemática
$$ x_ {1,2} = \ frac {-b \ pm \ sqrt {b ^ 2-4ac}} {2b}. $$
Funcionó para mí
fuente