Here record some tips of jekyll when I set up sites with it.
- No
BOM
! UTF-8BOM
in Windows' text editors would bring any post with YAML head matter down! - 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. - Pagination permalink must be
/pageN/
and use/index.html
for index. Can not customize as/blog/page/N/
. (Issue here) - Including will be processed earlier than markdown converting.
- Any file which name starts with underscore(
_
) will not be copied when building.
-
Problem in auto generating ID for header elements(h1-h6). (Issue here. Resolved by using
kramdown
markdown engine.) -
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}
- To judge if a variable not exist, use this syntax
{% if var == null %}
.
-EOF-