Useful Links
Developers like Jekyll because we can write content like we write code:
Ability to write content in markdown or textile in your favorite text-editor.
Ability to write and preview your content via localhost.
No internet connection required.
Ability to publish via git.
Ability to host your blog on a static web-server.
Ability to host freely on GitHub Pages.
No database required.
一组Jekyll帮助链接:
Grammar
Recommended Pages
-
index.html
You will always want to define the root index.html page as this will display on your root URL.
-
404.html
Create a root 404.html page and GitHub Pages will serve it as your 404 response.
-
sitemap.html
Generating a sitemap is good practice for SEO.
-
about.html
A nice about page is easy to do and gives the human perspective to your website.
jekyll version: 2.5.3
关键文件介绍
_config.yml
- 功能: jekyll的主要配置文件,这里面定义了一些关键的变量。如markdown引擎、高亮引擎、评论系统、统计系统、分享系统、Jekyll-Bootstrap(JB)等变量设置。
从程序设计角度理解就是在这里面定义了jekyll系统用到的一些全局变量,在其他页面可以访问这里面的值。
atom.xml
todo
index.html
博客首页
简单首页示例
todo
pages.html
todo
archive.html
todo
categories.html
todo
tags.html
todo
FAQ
1.如何在文章中输入liquid语法的文本,比如{\% highlight c++ \%}, {{ post.data }}这种原文,而不给转义?
使用raw和endraw来包裹要转义的内容