Directory Structure
By default, cobalt mirrors your source file hierarchy in the destination, helping you get closer to a What-You-See-Is-What-You-Get experience.
Files or folders that help generate the site but aren't directly part of the output
are "hidden" from cobalt by prefixing them with a _.
The default Cobalt site usually looks like this
.
|- _cobalt.yml
|- _layouts
| |- default.liquid
|- _includes
| |- header.liquid
|- _data
| |- movies.json
|- _sass
| |- base.scss
|- _site
| |- index.html
|- _defaults
| |- pages.md
| |- posts.md
|- posts
| |- cats.md
|- _drafts
| |- dogs.md
|- index.liquid
| File / Directory | Description |
|---|---|
. | Root directory for your content. Can be modified in _cobalt.yml. |
_cobalt.yml | Site-wide configuration file |
_layouts | Templates that wrap pages. The layout is chosen in the frontmatter |
_includes | Liquid snippets of content to be shared among layouts or pages. |
_data | Data files that will be loaded as part of the {{ site.data }} variable. |
_sass | Sass snippets that can be imported into your .scss files. |
_site | The output directory of cobalt. Can be modified in _cobalt.yml. |
_defaults | cobalt new initializes files from here based on the collection name. |
posts | Pages in this directory will be treated as blog posts. Can be modified in _cobalt.yml. |
_drafts | Pages in this directory will be treated as draft blog posts. Can be modified in _cobalt.yml. |
index.liquid | Any other pages found will be transformed by cobalt. |
| Other files | Assets will be copied directly over from the source directory to the output directory. |