https://github.com/5t111111/middleman-blog-bourbon-template
https://github.com/5t111111/middleman-blog-bourbon-template
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/5t111111/middleman-blog-bourbon-template
- Owner: 5t111111
- License: other
- Created: 2014-09-15T06:08:23.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2014-09-30T14:48:54.000Z (over 10 years ago)
- Last Synced: 2025-01-12T07:46:52.516Z (5 months ago)
- Language: CSS
- Size: 1.47 MB
- Stars: 3
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# middleman-blog-bourbon-template
This is a [Middleman](http://middlemanapp.com) template styled with [Bourbon](http://bourbon.io), [Neat](http://neat.bourbon.io) and [Bitters](http://bitters.bourbon.io).
## Screenshot
## Features
- [Slim](http://slim-lang.com) as template engine
- Syntax highlighting with [middleman-syntax](https://github.com/middleman/middleman-syntax) (using [rouge](https://github.com/jneen/rouge))
- Responsive layout with Neat grid system
- [Font Awesome](http://fortawesome.github.io/Font-Awesome) for easily adding social media link icon
- Live reload with middleman-livereload
- [Rails Assets](https://rails-assets.org) for assets management.
## Quickstart
Install Middleman if you haven't done yet.
```console
$ gem install middleman
```
### Clone this template to your machine
```console
$ mkdir ~/.middleman # if it doesn't exist
$ cd ~/.middleman
$ git clone https://github.com/5t111111/middleman-blog-bourbon-template.git blog-bourbon
```
### Create middleman blog
```console
$ middleman init my-fantastic-blog --template=blog-bourbon
```
### Install bitters
```console
$ cd my-fantastic-blog/source/stylesheets
$ bundle exec bitters install
```
### Enable Neat grid system in bitters' settings
Uncomment the below line in `source/stylesheets/base/_base.scss`
```scss
// Neat Settings -- uncomment if using Neat -- must be imported before Neat$
// @import 'grid-settings';$
```
### Start Middleman server
```console
$ bundle exec middleman
```
Open `http://localhost:4567` in a web browser.
## Site configuration
Edit at least the following settings in config.rb.
- :site_url - Your blog URL
- :site_author - Author name of your blog
- :site_title - Your blog title
## Thanks
- This project is strongly inspired by [middleman-blog-bootstrap-template](https://github.com/biblichor/middleman-blog-bootstrap-template)
- The article [Styling a Middleman Blog with Bourbon, Neat, and Bitters](http://robots.thoughtbot.com/middleman-bourbon-walkthrough) also gives me a lot of help.