一个基本的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-based 主题的Jekyll网站的目录结构
自3.2
版本以来,一个由 jekyll new
启动的新Jekyll项目使用基于gem的主题来定义网站的外观。这导致了一个更轻的默认目录结构:_layouts
、_includes
和_sass
默认存储在 theme-gem 中。
minima是当前的默认主题,bundle info minima
将显示minima主题的文件存储在您的计算机上的位置。
这些功能的概述:
File / Directory | Description |
---|---|
| 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 are unpublished posts. The format of these files is without a date: |
| These are the partials that can be mixed and matched by your layouts and posts to facilitate reuse. The liquid tag |
| 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 |
| Your dynamic content, so to speak. The naming convention of these files is important, and must follow the format: |
| Well-formatted site data should be placed here. The Jekyll engine will autoload all data files (using either the |
| These are sass partials that can be imported into your |
| 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 |
| Keeps a copy of the generated pages and markup (e.g.: markdown) for faster serving. Created when using e.g.: |
| 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 |
| Provided that the file has a front matter section, it will be transformed by Jekyll. The same will happen for any |
Other Files/Folders | Except for the special cases listed above, every other directory and file—such as |
=========================== | ========================================================= |
以下列字符开头的每个文件或目录:.
, _
, #
或source
目录中的 ~
将不会包含在destination
文件夹中。这些路径必须通过include
指令中的配置文件明确指定,以确保它们被复制:
include:
- _pages
- .htaccess