Based on Poole: the butler for Jekyll, the static site generator.
It's designed and developed by @_ndugu to provide a clear and concise foundational theme for a Jekyll wesite.
You get a full vanilla Jekyll install with example templates, pages, posts and styles.
See Poole in action with the demo site.
There are currently two official themes built on Poole:
Individual theme feedback and bug reports should be submitted to the theme's individual repository.
Poole is built on Jekyll and uses its built-in SCSS compiler to generate our CSS. Before getting started, you'll need to install the Jekyll gem and related dependencies:
$ gem install jekyll jekyll-gist jekyll-sitemap jekyll-seo-tag
Windows users: Windows users have a bit more work to do, but luckily @juthilo has your back with his Run Jekyll on Windows guide.
Need syntax highlighting? Poole includes support for Pygments or Rouge, so install your gem of choice to make use of the built-in styling. Read more about this in the Jekyll docs.
To help anyone with any level of familiarity with Jekyll quickly get started, Poole includes everything you need for a basic Jekyll site. To that end, just download Poole and start up Jekyll.
Folks wishing to use Jekyll's templates and styles can do so with a little bit of manual labor. Download Poole and then copy what you need (likely _layouts/
, *.html
files, atom.xml
for RSS, and assets/
for CSS, JS, etc.).
To see your Jekyll site with Poole applied, start a Jekyll server. In Terminal, from /poole
(or whatever your Jekyll site's root directory is named):
$ jekyll serve
Open http://localhost:4000 in your browser, and voilà.
If you host your code on GitHub, you can use GitHub Pages to host your project.
gh-pages
branch.CNAME
file to point to your new domain.baseurl
in _config.yml
to point to your GitHub Pages URL. Example: for a repo at github.com/username/poole
, use http://username.github.io/poole/
. Be sure to include the trailing slash.No matter your production or hosting setup, be sure to verify the baseurl
option file and CNAME
settings. Not applying this correctly can mean broken styles on your site.
Poole has two branches, but only one is used for active development.
master
for development. All pull requests should be to submitted against master
.gh-pages
for our hosted site, which includes our analytics tracking code. Please avoid using this branch.CSS is handled via Jeykll's built-in Sass compiler. Source Sass files are located in _sass/
, included into styles.scss
, and compile to styles.css
.
Mark Otto
Open sourced under the MIT license.
<3