[Git Page] Git 블로그에 LaTex 기능 추가하기; Jekyll, Minimal Mistakes

세 줄 요약:

Jekyll & Minimal Mistakes 테마를 이용해 생성한 Git page 블로그는 기본적으로 LaTex를 활용한 수식 입력을 제공하지 않는다.
그러나 간단한 수정을 통해 해당 기능을 활성화할 수 있다.
LaTex 문법은 외우기는 귀찮으니 에디터를 사용하자.

 

Introduction

---

저는 Optical Flow, SLAM 등을 주로 포스팅하고 있습니다. 이와 같이 Computer Vision 분야를 다루다 보면 수식을 입력할 일이 많습니다. 처음에는 그냥 X1, X2 등으로 간단하게 표현할 수 있는 정도였지만, 점점 더 복잡해지며 이는 더 이상 불가능해졌습니다. 그래서 어차피 아이패드를 이용해 공부를 하며 기록한 GoodNote page들을 업로드할까 생각했지만, 개인적인 이유로 이는 스스로 허락할 수 없더군요 (이놈의 악필은...).

각설하고 저는 그래서 LaTex를 활용해 수식을 입력하기로 결심했습니다. 실제로 티스토리 블로그(여기)에서도 사용하고 있는 방법이죠. Git Page에서도 LaTex 추가는 꽤나 쉽게 되더군요. 시작하겠습니다.

 

Markdown 엔진 전환

---

우선, Markdown 엔진을 kramdown으로 전환해줍니다. 이는 _config.yml 파일에서 바꿀 수 있으며, 아래와 같이 입력해 줍니다.

 

# Conversion
markdown: kramdown
highlighter: rouge
lsi: false
excerpt_separator: "\n\n"
incremental: false

 

Script 수정

---

그다음은 스크립트를 수정할 차례입니다. 저희가 수정할 파일은 _includes/scripts.html이며, 여기서 중요한 점은 Minimal Mistakes 공식 repository에 있는 파일과 같아야 한다는 점입니다. 워낙 파생된 커스텀 테마가 많은 Minimal Mistakes 테마이기 때문에 어떤 수정이 기존에 있었는지 알 수 없으며, 이는 저희가 바꾸려는 부분과 충돌이 생길 수도 있습니다. 만약 변경이 많은 테마를 사용하고 계시다면, 일단 아래 내용을 적용시킨 후 적용이 되지 않는 경우 공식 repository를 참조해 수정 부탁 드립니다. 파일 하단에 아래와 같이 코드를 추가시키면 이제 완성입니다.

 

<!-- Add LaTex function -->
<script type="text/javascript" async
	src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/latest.js?config=TeX-MML-AM_CHTML">
</script>

<script type="text/x-mathjax-config">
   MathJax.Hub.Config({
     extensions: ["tex2jax.js"],
     jax: ["input/TeX", "output/HTML-CSS"],
     tex2jax: {
       inlineMath: [ ['$','$'], ["\\(","\\)"] ],
       displayMath: [ ['$$','$$'], ["\\[","\\]"] ],
       processEscapes: true
     },
     "HTML-CSS": { availableFonts: ["TeX"] }
   });
</script>

 

마치며..

---

오늘은 Git Page를 활용한 블로그(Jekyll & Minimal Mistakes theme)에서 LaTex를 활성화시키는 법을 알아봤습니다. 문제없이 따라오셨다면, 아래와 같이 멋진 수식들을 작성할 수 있을 겁니다. 티스토리에서도 LaTex를 사용하려면 별도의 세팅을 해주어야 하는데요. 만약 해당 내용이 궁금하시다면, 댓글이나 이메일을 남겨주세요. 지금은 포스팅이 밀려 있어 아마 한참 뒤에나 업로드하겠지만, 요청이 있다면 제일 우선순위로 찾아뵙겠습니다.

 

Git Page LaTex Enablement

 

추가로, 저는 LaTex 문법을 외우고 있지 않습니다. 대신 에디터를 사용해 멋진 식을 쉽게 만들고, LaTex 표현식을 복사해서 사용합니다. 아래는 제가 사용하는 LaTex Editor 사이트입니다.

 

Equation Editor for online mathematics - create, integrate and download

 

Reference

---

GitHub - YoungJ-Baek/YoungJ-Baek.github.io: YoungJ-Baek.github.io

 

How to add Latex to Minimal Mistakes