jekyll - new - ¿Cómo soportar látex en github-pages?

jekyll web pages

Question

Uso jekyll para escribir post y mostrarlo en github-pages. Mi archivo fuente está escrito con markdown.

¿Cómo puedo insertar una fórmula en el archivo de rebajas?

No quiero guardar la fórmula en una imagen y cargar la imagen en un archivo de rebajas. De hecho, quiero escribir directamente la fórmula de látex en el archivo de rebajas.

Answer 1

Dado que los recursos en línea han cambiado con respecto a esta pregunta, aquí hay una actualización sobre el soporte de LateX con GitHub Pages.

Tenga en cuenta que lo más cercano al procesamiento de látex sin exportar como imágenes y admitirlo de forma nativa en su sitio Jekyll sería utilizar MathJax.

MathJax se recomienda en Jekyllrb docs para soporte matemático, con Kramdown, también lo convierte de LaTeX a PNG, más detalles al respecto aquí en la documentación de Kramdown.

Opción 1: escriba su ecuación en MathURL e MathURL .

Podría escribir la ecuación con MathURL, luego generar una URL que apunte permanentemente a la ecuación y mostrarla en una etiqueta <iframe> . Sin embargo, esto dejará de funcionar si MathURL se desconecta.

Opción 2: Implementar jsMath

jsMath permitirá casi la sintaxis de LateX y será compatible con tu blog si lo has configurado correctamente, existe una extensa documentación sobre esto .

Opción 3: Mathjax (de lejos la más fácil en mi opinión)

Muchos sitios han mencionado que Mathjax se considera un sucesor de jsMath y es mucho más fácil de implementar con Jekyll. MathJax también es utilizado por mathics.stackexchange.com también!

• Paso 1 : haga que su sitio cargue la secuencia de comandos en los sitios donde desea mostrar las matemáticas. (Generalmente se hace en el encabezado)

• Opcional: compruebe su analizador de _config.yml en _config.yml . En este ejemplo se sugiere kramdown o kramdown . Algunos analizadores como el discount interferirán con la sintaxis, pero tengo una solución a continuación.

• Paso 2 : Escribe tus ecuaciones.

Citando este tutorial de Gaston Sanchez:

MathJax no tiene exactamente el mismo comportamiento que LaTeX. Por defecto, el preprocesador tex2jax define los delimitadores matemáticos LaTeX, que son / (... /) para las matemáticas en línea, y / [... /] para las ecuaciones mostradas. También define los delimitadores $$ ... $$ de TeX para las ecuaciones mostradas, pero no define $ ... $ como delimitadores matemáticos en línea.

Lea la documentation en la sintaxis para más detalles.

• Nota: Usar la etiqueta de líquido sin raw para asegurar que los analizadores Markdown no interfieran con la sintaxis de MathJax.
• Si bien puede evitar las barras invertidas (por ejemplo, //[ /frac{1}{n^{2}} //] ) para asegurarse de que se analizan correctamente, como lo describe el tutorial de Chistopher Poole , esto no siempre es intuitivo y parece complicado. Una solución más simple sería utilizar la etiqueta líquida sin procesar para garantizar que el procesador Markdown ignore el texto y se emita directamente como html estático. Esto se hace con {% raw %} y también {% endraw %}

Aquí hay un ejemplo de código:

 {% raw %}
  $$a^2 + b^2 = c^2$$ --> note that all equations between these tags will not need escaping! 
 {% endraw %}

Por último, también asegúrese de que las fuentes admitan la visualización de LateX, ya que algunos tienen problemas como que el tamaño de la fuente es demasiado pequeño. Alternativamente, aquí hay algunos métodos adicionales, como Google Charts y MathML, que se analizan en el sitio hermano de Latex StackExchange.

Answer 2

Si usaste Jekyll en tus páginas de GitHub, puedes agregar

  <script type="text/x-mathjax-config">
    MathJax.Hub.Config({
      tex2jax: {
        skipTags: [''script'', ''noscript'', ''style'', ''textarea'', ''pre''],
        inlineMath: [[''$'',''$'']]
      }
    });
  </script>
  <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML" type="text/javascript"></script> 

en el archivo _includes/head.html , y luego su sitio de GitHub Pages admitirá MathJax