Folders are used by Jekyll to organize files to make creating a web site easy. Once the the site is set up, the folders help with making it a snap to update the site. Any file or folder that starts with an underline will not be loaded directly into the site. This is not a complete list.

Note: The double curly braces in this post should not have a space, the space was inserted to allow the code to be seen.

_includes

Building websites can mean reuseing parts over and over again. Breaking these out into small files that can be called in; or ‘included’ can mean making websites quickly since less typing is needed. But also easier to maintain since common parts are in single spot.

To use an include add

{ { include head.html } }

_layouts

A layout file is used to describe the order of includes. But also has the HTML structure that can best describe a page.

_posts

The heart of any blog. The content itself. These files are written in markdown to allow Jekyll to add the HTML code.

_drafts

Unpublished posts will be placed here.

_site

When Jekyll creates the static website, all the files get put in this directory. Any changes that are manually edited in this folder will be lost during the next build.

_data

Using yaml files, data can be stored and accessed using a variable call. In the following example, there is a file call books.yml.

site.data.books

Resource Folders

Any folder that normally would be added to a site, can be added to a Jekyll site. This includes but is not limited to CSS, Images, Script or whatever folders you want to use.