Github Pages blog Jekyll’s minimal-mistake theme 에서 문자 및 수식 표현불가 해결 방법

2 minute read

드디어 미루어뒀던 블로그 개혁을 마쳤다. 우선 괄호가 표시 안되는 문제를 고치고 수식 표시도 때때로 안되는 문제를 수정했다. 그 외에 _config.yml 에서 내 정보와 인사말 등을 수정했다.

괄호 표시 안됨 문제

나는 그전까지 (괄호) 혹은 {중괄호} 나 [대괄호] 를 쓰면 리모트 & 푸시를 한 뒤 정상적으로 표시가 안되는 문제가 있었다. 사실 괄호 말고도 여러 문자가 표시가 잘 안됐었다.

backslash로 escape 하는 방법은 당연히 알고 있고 시도해 보았다.

하루를 꼬박 투자하여 검색하고 커밋을 수십번 해봐도 안되서 마지막에 원래 테마 제작자 저장소에서 보이는 파일을 최상단의 파일부터 복사하여 내 로컬 저장소에 손수 붙여넣기로 수정을 하였다. 대부분 같거나 이름 정도의 수정 부분이었고,

scripts.html, feature_row, figure

위의 파일들을 원작자의 것과 동일하게 다시 수정(복원)을 하니 괄호 문제가 드디어 해결되었다.

수식 표현 불가

그러나 예전에 수식을 작성할 일이 많아 스크립트랑 _config.yml 파일을 수정한 적이 있었고 괄호 문제를 해결하니 수식이 다시 에러가 발생했다.

나와 동일한 테마를 쓰는 유저의 포스팅을 참고하여 성공적으로 고쳤다.

대부분의 블로그에서 설명하는 방법은 _includesmathjax_support.html 파일을 생성하고 head.html 에서 포스트 타이틀에 특정 조건을 만족할 때 mathjax를 사용하게 하는 방식을 알려주었다. 하지만 나는 거의 대부분에 조금씩이라도 수식이나 변수명 등을 사용해서 항상 적용 되는 방식을 원하였고, script.html 코드 하단에 다음을 추가하여 해결했다.

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

그리고 한가지 \textup은 mathjax에서 지원하지 않아서 \mathrm으로 대체해서 사용한다. 출처1,출처2