Posts Jekyll Github 블로그에 MathJax 적용하기
Post
Cancel

Jekyll Github 블로그에 MathJax 적용하기

Jekyll Github 블로그에 MathJax로 수학식 표시하기 를 참고하여 적용했습니다.



✔️ 마크다운 엔진 변경

  • _config.yml 파일의 내용을 아래와 같이 수정
  • 아래 내용은 Jekyll의 default 설정에 해당됩니다. (참조)
1
2
3
4
5
6
# Conversion
markdown: kramdown
highlighter: rouge
lsi: false
excerpt_separator: "\n\n"
incremental: false



✔️ mathjax_support.html 파일 생성

  • _includes 디렉토리에 mathjax_support.html 파일 생성 후 아래 내용 입력
  • MathJax의 설정과 에러 메세지 출력을 포함하고 있습니다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
<script type="text/x-mathjax-config">
MathJax.Hub.Config({
    TeX: {
      equationNumbers: {
        autoNumber: "AMS"
      }
    },
    tex2jax: {
    inlineMath: [ ['$', '$'] ],
    displayMath: [ ['$$', '$$'] ],
    processEscapes: true,
  }
});
MathJax.Hub.Register.MessageHook("Math Processing Error",function (message) {
	  alert("Math Processing Error: "+message[1]);
	});
MathJax.Hub.Register.MessageHook("TeX Jax - parse error",function (message) {
	  alert("Math Processing Error: "+message[1]);
	});
</script>
<script type="text/javascript" async
  src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-MML-AM_CHTML">
</script>



✔️ _layouts/default.html 파일의 head.html 부분에 아래 내용 삽입

  • 아래 if 문으로 use_math 가 적용된다면, mathjax_support.html 을 포함합니다. 결국 MathJax 를 사용한다는 뜻이 됩니다.
1
2
3
4
/* mathjax 추가 */
{% if page.use_math %}
  {% include mathjax_support.html %}
{% endif %}



✔️ YAML front-matter 설정

  • 수학식을 표시할 포스트의 front-matter에 use_math: true 적용
1
2
3
4
5
6
7
---
title: "Jekyll Github 블로그에 MathJax 적용하기"
date: 2020-03-08 12:14:00 +0800
categories: [Blogging, Configuration]
tags: [Jekyll, MathJax]
use_math: true
---






✔️ 7/29 변경사항

Due to the shutting-down problem, you should change MathJax script. See below for details.

1
2
3
4
5
6
7
8
<script type="text/x-mathjax-config">
  MathJax.Hub.Config({tex2jax: {inlineMath: [['$','$'], ['\\(','\\)']]}});
</script>


<script type="text/javascript" async
  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/MathJax.js?config=TeX-MML-AM_CHTML">
</script>
Updated Jul 29, 2020 2020-07-29T10:34:14+09:00
This post is licensed under CC BY 4.0