Tips of jekyll

tips-of-jekyll.md

Tips of jekyll

Here record some tips of jekyll when I set up sites with it.

jekyll

0. No BOM! UTF-8 BOM in Windows' text editors would bring any post with YAML head matter down!
1. When put any posts out of /_posts folder, the category can not set. And the category would be the folder name which the post put in.
2. Pagination permalink must be /pageN/ and use /index.html for index. Can not customize as /blog/page/N/. (Issue here)
3. Including will be processed earlier than markdown converting.
4. Any file which name starts with underscore(_) will not be copied when building.

Markdown Engines

maruku

0. Problem in auto generating ID for header elements(h1-h6). (Issue here. Resolved by using kramdown markdown engine.)

1. The feature of Table Of Content can not work by only using the {:toc} in a seperated line(Issue here). But if put a list line close before {:toc} will work right. example:

       * Anything
       {:toc}
   

Liquid

if/else

0. To judge if a variable not exist, use this syntax {% if var == null %}.

-EOF-