See Jekyll's docs. Also github pages docs.
High-level:
- posts go in
_posts/
and are namedYYYY-MM-DD-post-title.md
- drafts go in
_drafts/
and no one will ever see them.
To check it all goes before you push (thumbs up):
> gem install bundler
if you haven't already> bundle install
but probably only if it's your first time> bundle exec jekyll serve --watch
and go to town on it.
- if you want to see drafts add the
--drafts
flag.
posts should start with the following YAML front matter:
---
layout: post
title: Some post about a stuff.
---
Then just write pro markdown like a hero.
index.html
is, unsurprisingly, the main page. It uses the default
layout which right now comes straight from the theme.
_layouts/post.html
is the template for the individual posts.
To really look good we will probably want to make a css/
folder
which will just get copied over and contain our styles. If we make
a _sass
folder full of SASS then Jekyll will build those too,
and this could be positive.