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!