Hazelnut: A barebones starting point for Jekyll
About this site template:
This is a Jekyll template which uses Sass and CoffeeScript for assets, and Rake tasks for handy help with development. It assumes you’re using Pow to serve your site locally. Since this is geared for designers starting from scratch, there’s no styling.
If you’re a developer looking for pre-designed Jekyll themes, I’d recommend Poole by Mark Otto.
Websites started from this template:
mig.io, my personal site. (View the repo.)
humblepied.com, a video interview site. (View the repo.)
basecamp.com, the marketing site for Basecamp.
basecamp.com/help, the help documentation site for Basecamp.
37signals.com/incoming-transmission, an archive of the best of the web.
thedistance.com, a new online magazine about hard-working, long-lasting businesses and the people behind them.
First time setup:
- Edit the
Rakefileto add your Pow name, live URL, and GitHub repo
- Edit the
_config.ymlto put in your own name and social media handles
rake tasks you’ll commonly use:
rake to watch and update your HTML, Coffee and Sass.
rake view builds a fresh copy of your site, then opens it locally.
rake view:xip generates an xip.io friendly URL and opens it.
rake view:github to head to your GitHub repository.
And as always,
rake -T will provide you a list of all tasks.
There’s no asset pipeline, but our
rake tasks will automatically join any
.coffee files we create into one file automatically for us.
All .coffee files should go into:
Adding new stylesheets:
Since there’s no asset pipeline, when we’re adding a new stylesheet we’ll need to do just two things. Let’s pretend we want to add a new stylesheet for an About page on our new site.
First, we’ll add our underscore-named file to the proper directory.
In our case, we’ll add this:
Last, we’ll define our new stylesheet inside the main style.scss file.
@import 'pages/about', /* Adding a stylesheet for an About page. */ 'pages/home';
@migreyes on Twitter is your best bet.