默认配置 Default Configuration
Jekyll 运行时默认使用以下配置选项。你可以在配置文件中修改或在命令行中指定不同的设置。
注意目录路径
一般来说,配置中的目录路径(如plugins_dir
)应该相对于当前的工作目录而非站点源目录。唯独sass
配置项是个例外,其路径值必须相对于站点源目录。
# 文件存储路径 Where things are
source : .
destination : ./_site
collections_dir : .
plugins_dir : _plugins # 使用字符串数组,并按照顺序加载这些插件 takes an array of strings and loads plugins in that order
layouts_dir : _layouts
data_dir : _data
includes_dir : _includes
sass:
sass_dir: _sass
collections:
posts:
output : true
# 处理阅读操作 Handling Reading
safe : false
include : [".htaccess"]
exclude : ["Gemfile", "Gemfile.lock", "node_modules", "vendor/bundle/", "vendor/cache/", "vendor/gems/", "vendor/ruby/"]
keep_files : [".git", ".svn"]
encoding : "utf-8"
markdown_ext : "markdown,mkdown,mkdn,mkd,md"
strict_front_matter : false
# 过滤内容 Filtering Content
show_drafts : null
limit_posts : 0
future : false
unpublished : false
# 插件 Plugins
whitelist : []
plugins : []
# 转化 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
strict_filters : false
strict_variables : false
# Markdown 处理器 Markdown Processors
kramdown:
auto_ids : true
entity_output : as_char
toc_levels : [1, 2, 3, 4, 5, 6]
smart_quotes : lsquo,rsquo,ldquo,rdquo
input : GFM
hard_wrap : false
footnote_nr : 1
show_warnings : false