ChrBach/blog

middleman-blog-bootstrap-template

• This is a middleman template for bootstrap-based blogs.
• This aims at the easy & speedy blog-building for who don't know much about ruby / middleman.
• Select the themes from Bootswatch, then you can easily build bootstrap-based blogs!
• And it encourages asset management with Bower.

##Features:

• Rendering engine

• Markdown in posts
• Slim in layout

• Middleman plugins

• middleman-blog
• middleman-livereload
• middleman-target
• middleman-deploy config snippet to ease FTP/SFTP deployment

• Bower package management

• Normalize.css
• Modernizr
• Bootswatch
• Font-awesome
• jQuery
• Respond.js

• SCSS
• Coffeescript

Preview the sample image which is made in Bootswatch "flatly" theme.

##Installation

1. If you're just getting started, install the middleman gem and generate a new project:
2. Download/clone to .middleman/blog-bootstrap:
3. Create your new Middleman project with thie template:
4. Install the assets in the bower_components/ directory.

gem install middleman
git clone https://github.com/biblichor/middleman-blog-bootstrap-template.git ~/.middleman/blog-bootstrap
middleman init my_new_project --template=blog-bootstrap
cd my_new_project
bower install

##Configuration

###Blog configuration

• Edit config.rb as you like.

• Don't forget to add the site url, author, title, and subtitle(used as description too).
• To get analytics inclusion, simply add your account name to the appropriate places.
• To get bootswatch inclusion, simply change theme_name to your favorite bootswatch theme.

set :site_url, 'http://blog.url.com'
set :site_author, 'Blog author'
set :site_title, 'Blog title'
set :site_subtitle, 'Blog subtitle'
# Select the theme from bootswatch.com.
# If false, you can get plain bootstrap style.
# set :theme_name, 'flatly'
set :theme_name, false
# set @analytics_account, like 'XX-12345678-9'
@analytics_account = false

###Bower configuration

• With bower, you can prevent unnecessary files being copied over to build/.
• All bower packages are put in the bower_components/ directory outside of the source.
• By default, these assets are included:

• Normalize.css
• Modernizr
• Bootswatch
• Font-awesome
• jQuery
• Respond.js

• If you want another assets, edit bower.json as you like, and simply bower install and include it like you would any other file in sprockets.

###SCSS configuration

By default, bootstrap or bootswatch is installed. You can edit _settings.scss, _imports.scss as you like.

• any variables (like colors and such) go into _settings.scss
• any packages/imports go into _imports.scss

##Requirements Confirmed in ruby 2.0.0p247, rubygem 2.0.3, middleman 3.2.2

###Helpers configuration, etc.

• In helpers/, a few helpers are inclueded to help out with organizing the following information on your site.

• title
• meta keywords
• meta description

• feed.xml and sitemap.xml enables you to tell your readers / search engines the update of articles.

##Misc This project is forked from headcanon's middleman-bower-template (Big thanks to headcanon).

All the problems or questions are welcome. And of cource if you have a better idea, give it a fork! Thanks!