Update July 2018:
This post is outdated as the issues stated at the time of writing are not issues anymore. It is still kept for potential interest.
I did encounter a few stones on my way to adopt Tian Qi’s TeXt for setting up my own GitHub Pages. I had just two basic requirements: 1. support LaTex syntax. 2. simple but functional. I know very few about web design, that is why even a little stone could cost me half an hour to move it away.
The first thing is about setting up both ruby and node.js environment on my Ubuntu machine. Installing Ruby and gem went smoothly, therefore setting up Jekyll is easy. But when I tried to install
npm, my Ubuntu constantly complained that it could not install the current stable version of Node.js, and it installed
Node 4.2.6instead, which in turn made the latest
npmrefuse to work with the old
Node 4.2.6. Many people filed this problem already, but most of them did not work for me.
The problem is caused by a discontinued ppa application, I need to remove it from
/etc/apt/source.list.d. This is the detailed solution
The second thing is to make LaTex work in Markdown. MathJax is the choice but there exists several ways to set up MathJax in Jekyll, and some of them just did not work for me. I did not have the time to dig out the reason but just wanted to find a quick solution. Eventually I made it work with these settings:
- Using kramdown engine for markdown.
_layouts/page.html. Be sure to use
https, otherwise the rendering online could fail.
- Then I could write equations in LaTex! For inline equations, the expressions need to be embraced with double dollar sign like this:
$$x$$. For independent lines, the expressions should start from a new line after
$$, and the ending
$$should also stay in a new line.
Okay, that is it. I hope someone could find this post useful.