jekyll 学习笔记

安装

1. sudo apt-get install gem
2. sudo gem install jekyll
3. sudo gem install json

创建新的bolg jekyll new blogname

build jekyll build

• --destination <destination>
• --source <source>
• --watch <watch> # 创建同时显示修改情况
• --drafts # 处理未发表的文章
• --future # 用将来的日期发表文章

serve jekyll serve <--detach> <-watch>

• -- port PORT 默认是4000
• --baseurl URL 设置默认路径前缀

目录结构

1. _config.yml 配置文件
2. _drafts 尚未发表的文件目录，文件名为title.MARKUP
3. _includes 保存部分文件的目录，用于在layouts和posts中\{\% include file.ext \%\}方式包括进去
4. _layouts 模板文件，被posts中文件引用.``
5. _posts 以发表的文章，文件名格式 YYYY-MM-DD-title.MARKUP
6. _data 保持你*.yml和*.yaml文件
7. _site 保存build后的html文件，最好加入到.gitignore中
8. index.html 文件后缀也可以是md等，
9. Other Files/Folders 其他一些文件如css、images

_config.yml 配置文件

1. baseurl: URL
2. markdown: maruku 设置markdown的处理软件

YAML front

• layout 设置被扩展的模板
• permalink 自定义输出文件路径，默认是/year/month/day/title.html
• published 如果为false则不在网站中发表
• category 和 categories 不太理解
• tags 文章的标签

变量名

• post.title
• post.url
• post.excerpt
• site.url
• \{\% highlight language lineno \%\} and \{\% endhighlight \%\} 高亮代码，显示行号

全局变量名

• site
  1. site.time 文章被build的时间
  2. site.page 页面列表
  3. site.posts post列表
  4. site.tags.TAG 所有带TAG的posts
• page
  1. page.title 文章名
  2. page.url 文章链接，除域名外
  3. page.date e.g. YYYY-MM-DD HH:MM:SS
  4. page.id e.g./2013/11/15
  5. page.tags 文章标签
  6. page.path 路径,包括域名
• paginator
  1. paginator.per_page 每页显示的文章数目
  2. paginator.posts
  3. paginator.total_posts 文章数目
  4. paginator.total_pages 页数
  5. paginator.page 当前页数
  6. paginator.previous_page 前一页的页数
  7. paginator.previous_page_path 前一页的路径
  8. paginator.next_page
  9. paginator.next_page_path

自定义变量

在目录_data下定义文件mem.ymlormem.yaml，即可以在posts目录下的文件中引用

模板使用

• Filters
• Tags
  1. include
  2. gist

设置产生的文件的路径

安装插件

Github page

1. username.github.io/projectname
2. gh-pages
3. _config.yml
   1. baseurl: projectname
   2. 使用js或css文件，//path/to/css.css
   3. 文章链接：/, 无/
   4. 本地运行可以使用参数 jekyll serve --baseurl ''