目录结构 - Jekyll 文档

一个基本的 Jekyll 站点看起来这样：

.
├── _config.yml
├── _data
│   └── members.yml
├── _drafts
│   ├── begin-with-the-crazy-ideas.md
│   └── on-simplicity-in-technology.md
├── _includes
│   ├── footer.html
│   └── header.html
├── _layouts
│   ├── default.html
│   └── post.html
├── _posts
│   ├── 2007-10-29-why-every-programmer-should-play-nethack.md
│   └── 2009-04-26-barcamp-boston-4-roundup.md
├── _sass
│   ├── _base.scss
│   └── _layout.scss
├── _site
├── .jekyll-cache
│   └── Jekyll
│       └── Cache
│           └── [...]
├── .jekyll-metadata
└── index.html # can also be an 'index.md' with valid front matter

基于 Gem 主题的 Jekyll 站点目录结构

从 3.2 版本开始，基于 Gem 主题启动一个新的 Jekyll 项目时只需 jekyll new 即可生成一个比较规范的站点结构。这就导致了一个更轻量的目录结构： _layouts、_includes 和 _sass 默认都保存在 Gem 主题内。

minima 是当前默认主题，bundle info minima 会显示 minima 主题文件在您的计算机的存储位置。

目录结构内文件/文件夹概览：

文件 / 文件夹	简介
`_config.yml`	Stores configuration data. Many of these options can be specified from the command line executable but it’s easier to specify them here so you don’t have to remember them.
`_drafts`	Drafts are unpublished posts. The format of these files is without a date: `title.MARKUP`. Learn how to work with drafts.
`_includes`	These are the partials that can be mixed and matched by your layouts and posts to facilitate reuse. The liquid tag `{% include file.ext %}` can be used to include the partial in `_includes/file.ext`.
`_layouts`	These are the templates that wrap posts. Layouts are chosen on a post-by-post basis in the front matter, which is described in the next section. The liquid tag `{{ content }}` is used to inject content into the web page.
`_posts`	Your dynamic content, so to speak. The naming convention of these files is important, and must follow the format: `YEAR-MONTH-DAY-title.MARKUP`. The permalinks can be customized for each post, but the date and markup language are determined solely by the file name.
`_data`	Well-formatted site data should be placed here. The Jekyll engine will autoload all data files (using either the `.yml`, `.yaml`, `.json`, `.csv` or `.tsv` formats and extensions) in this directory, and they will be accessible via `site.data`. If there's a file `members.yml` under the directory, then you can access contents of the file through `site.data.members`.
`_sass`	These are sass partials that can be imported into your `main.scss` which will then be processed into a single stylesheet `main.css` that defines the styles to be used by your site. Learn how to work with assets.
`_site`	This is where the generated site will be placed (by default) once Jekyll is done transforming it. It’s probably a good idea to add this to your `.gitignore` file.
`.jekyll-cache`	Keeps a copy of the generated pages and markup (e.g.: markdown) for faster serving. Created when using e.g.: `jekyll serve`. Can be disabled with an option and/or flag. This directory will not be included in the generated site. It’s probably a good idea to add this to your `.gitignore` file.
`.jekyll-metadata`	This helps Jekyll keep track of which files have not been modified since the site was last built, and which files will need to be regenerated on the next build. Only created when using incremental regeneration (e.g.: with `jekyll serve -I`). This file will not be included in the generated site. It’s probably a good idea to add this to your `.gitignore` file.
`index.html` or `index.md` and other HTML, Markdown files	Provided that the file has a front matter section, it will be transformed by Jekyll. The same will happen for any `.html`, `.markdown`, `.md`, or `.textile` file in your site’s root directory or directories not listed above.
Other Files/Folders	Except for the special cases listed above, every other directory and file—such as `css` and `images` folders, `favicon.ico` files, and so forth—will be copied verbatim to the generated site. There are plenty of sites already using Jekyll if you’re curious to see how they’re laid out.

source 文件夹中每个以字符 .、_ 、#或~开始的文件或者文件夹都不会包含在 目标（destination）文件夹。有些路径必须通过配置文件的 include 命令明确定义以确保它们被复制：

include:
 - _pages
 - .htaccess