yaobinwen.github.io

Blog Theme

I'm using The Hacker theme.

Build & Serve

Run ./build-serve.sh to build the site and serve locally.

Notes:

• 1. I'm building my own ruby Docker images in order to build and serve locally for local development.
• 2. The script build-serve.sh does everything: build the customized Docker image and run jekyll serve appropriately.

Various Issues

Once I forgot to add the YAML front matter in index.md. As a result, jekyll didn't convert index.md to index.html. See the two references:

• Jekyll site working on GitHub Pages not working locally
• Jekyll: Front Matter

I dealt with the broken links from index page to the posts because I used hard links that were quite fragile. Refer to link tag on how to do it appropirately. See how it is used in index.md.

I needed to deal with displaying the literal {{}} in the middle of my post content. How to escape liquid template tags? told me to use {% raw %}. See how it is used in the post "Ansible: Understanding the subelements lookup (with_subelements)".

I used MathJax to render mathematical expressions in the posts:

• In _layouts/posts.html, I added the <script> tags to include MathJax into the posts. Refer to MathJax - Getting Started - Web Integration.
• Refer to the article Information, Entropy, and Password Strength on how to write inline and separate math expressions in Markerdown.