Структура каталогов

Jekyll по своей сути это движок трансформации текста. Его концепция состоит в следующем: вы передаете текст написанный в выбранном вами формате Markdown (Markdown, Textile и т.д.) или в чистом HTML, а Jekyll форматирует его в соответствии с файлами шаблонов. В ходе этого процесса вы можете настроить как будут выглядеть URL вашего сайта, какие данные будут отражаться в макете и многое другое. Все это делается путем редакции текстовых файлов , финальным продуктом является статический сайт.

Базовый сайт на 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-metadata
└── index.html # can also be an 'index.md' with valid YAML Frontmatter

Структура каталогов сайтов на Jekyll с использованием тем, поставляемых в гемах

Начиная с Jekyll 3.2, новые проекты, создаваемые с помощью команды jekyll new используют для задания внешнего вида сайта темы, поставляемые в гемах . Это ведет к облегченной структуре каталогов по умолчанию: каталоги _layouts, _includes и_sass хранятся в геме темы. Текущая тема по умолчанию minima, команда bundle show minima покажет, в каком каталоге на вашем компьютере хранятся файлы этой темы.

А вот обзор основных файлов и каталогов: