Where things are
source:       .
destination:  ./_site
plugins_dir:  _plugins
layouts_dir:  _layouts
data_dir:     _data
includes_dir: _includes
collections:
  posts:
output:   true

Handling Reading
safe:         false
include:      [".htaccess"]
exclude:      ["node_modules", "vendor/bundle/", "vendor/cache/", "vendor/gems/", "vendor/ruby/"]
keep_files:   [".git", ".svn"]
encoding:     "utf-8"
markdown_ext: "markdown,mkdown,mkdn,mkd,md"

Filtering Content
show_drafts: null
limit_posts: 0
future:      false
unpublished: false

Plugins
whitelist: []
gems:      []

Conversion
markdown:    kramdown
highlighter: rouge
lsi:         false
excerpt_separator: "\n\n"
incremental: false

Serving
detach:  false
port:    4000
host:    127.0.0.1
baseurl: "" # does not include hostname
show_dir_listing: false

Outputting
permalink:     date
paginate_path: /page:num
timezone:      null

quiet:    false
verbose:  false
defaults: []

liquid:
  error_mode: warn

Markdown Processors
rdiscount:
  extensions: []

redcarpet:
  extensions: []

kramdown:
  auto_ids:       true
  footnote_nr:    1
  entity_output:  as_char
  toc_levels:     1..6
  smart_quotes:   lsquo,rsquo,ldquo,rdquo
  input:          GFM
  hard_wrap:      false
  footnote_nr:    1

paginate: 分页数目 title: 博客主题 url: 博客地址(最基础的一级域名) feed: 订阅地址 author: 作者信息 aubout: 关于作者(描述性) follow: 社交 indexContent: 在首页是否显示文章详情,true为显示 imagelink: 联系我的个人图片 style: 样式地址 blogName: 博客标题blogDesc: 博客介绍 favicon: favicon地址 theme: 博客的主题 desqus: 社会化评论的id copyright: 版权

其中Gravatar头像标识需要使用你自己的gravatar注册的邮箱MD5值替换,就可以在页面上显示自己的头像了

站内搜索 如果你需要站内搜索功能,那么最好的办法就是申请Google Custom Search(CSE)服务。 主题中已经配置了作者站点的站内搜索为默认引擎,具体设置也在config.yml中的author部分,gcse字段。将其中引擎用户ID字符串改为你自己的即可。

Baseurl

If you go to the provided URL and don’t see the site, like this for example:
*404 Not Found*

*check on the value of baseurl in the config.yml file.*

 This file, which we’ll talk more about later, controls the overall configuration for the entire site.

The baseurl variable is appended to the main domain, which when we work offline is http://localhost:4000.
In the above example we want our site to show up at http://localhost:4000. In the config.yml file our baseurl variable is set to:

baseurl: "http://localhost"
This may seem right at first, but because this value is appended to the main domain it actually makes the site try to load at http://localhost:4000http://localhost.
So, we need to change the value to an empty string like this:

baseurl: ""
Your site will then load as expected.
If you want to load your site from a subdirectory instead, change the baseurlvalue to the name of the subdirectory, being sure to start and finish with a forward slash:

baseurl: "/themedemo/"

集合

每一个集合可以通过 site 变量来访问: site.my_collection每一个集合都是一个包含了对应集合下文档的数组,与 site.pagessite.posts 类似。

文档

除了定义在头信息中的属性,每个文档还有以下属性:

content        包含头信息的文档的未被渲染的正文部分。
output         基于文档content的渲染后的输出。
path           文档源文件的完整路径。
relative_path  文档源目录相对于站点源目录的相对路径。
url            渲染后集合的链接。需要在配置文件的 render 键中添加文件所属的集合名称。
collection     文档所属的集合名称。

YML头部定义

主要 用于指定模板. 和定义一些变量: 标题:title 描述: description 标签: tags 分类: category / categories 是否发布: published 以及 其他的自定义变量.

layout:     post   # 指定使用的模板文件,“_layout” 目录下的模板文件名决定变量名
title:      title  # 文章的标题
date:       date   # 覆盖文章名中的日期
category:   blog   # 文章的类别
description: description
published:  true   # default true 设置 “false” 后,文章不会显示
permalink:  /:categories/:year/:month/:day/:title.html  # 覆盖全局变量设定的文章发布格式