About Alembic

Alembic is a starting point for Jekyll projects. Rather than starting from scratch, this boilerplate is designed to get the ball rolling immediately. Install it, configure it, tweak it, push it.

Fork on GitHub  Install Alembic Tip me $5

Features

• Available as a starter kit or as Jekyll 3.3 theme gem
• Tested in all major browsers, that includes IE as well as Edge
• Extensive set of shortcodes to include various elements; such as buttons, icons, figure images and more
• Solid typographic framework from Sassline
• Configurable navigation via a single file
• Modular Jekyll components
• Easily interchangeable sidebar
• Post category support in the form of a single post index page grouped by category
• Built in live search using JavaScript
• Contact form built in using Formspree
• Works on GitHub Pages out of the box
• Built with Jekyll 3.3
• Designed with Siteleaf in mind
• Has 9 of the most popular networks as performant sharing buttons
• Has documentation

Examples

Here are a few examples of Alembic out in the wild being used in a variety of ways:

• bitpodcast.com
• katiesimonemusic.com
• joelcagedesign.com
• bawejakunal.github.io
• case2111.github.io
• www.10people.co.uk

Installation

As a Boilerplate / Fork

1. Fork the repo
2. Clone down the repo with $ git clone git@github.com:username/reponame.git
3. Delete the demo/ folder and screenshot.png files
4. Change the CNAME record to your projects’ record
5. Install bundler with $ gem install bundler
6. Install gems with $ bundle install
7. Run Jekyll with $ bundle exec jekyll serve --watch
8. Begin hacking for your project

As a Jekyll 3.3 theme gem

1. Download the starter /demo content, quick download link
2. Install bundler with $ gem install bundler
3. Install gems with $ bundle install
4. Run Jekyll with $ bundle exec jekyll serve --watch
5. Begin hacking for your project

Boilerplate & Theme differences

The boilerplate kit is better for more drastic hacking and changes, a project that’s quite different to any other and needs a lot of custom work done. Additionally you’ll only be able to use this method if you want to host it on GitHub Pages, as themes can’t be submitted… yet.

Using the theme will allow you to receive updates made and will be more programmatic. To make your own changes you’ll need to overwrite the files with your own. For example: If I want to change the colours of my site I’ll need to copy the _colors.scss file and create my own in _sass/colors.scss with my own changes. This is the same for all files within the theme, which means your own project will be more lean than if you were to use the boilerplate.