Skip to content
Switch branches/tags
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Hello Jason Portfolio

Written with Ruby+Middleman and based on the middleman-bss starter theme

Setup in development


Installation steps

  • Install optimization packages, globally
npm install -g svgo pngout-bin
  • Clone project and cd into project directory. A bug in middleman-blog requires absolute path, so this project must live in ~/Sites/portfolio.
git clone ~/Sites/portfolio && cd ~/Sites/portfolio
  • Install Ruby version set in .ruby-version
rbenv install
  • Install gems
gem install bundler && bundle install
  • Install project node packages
yarn install
  • Start Middleman server
bundle exec middleman

Case Studies

Special project pages that break a typical page's layout. Set the following in frontmatter to build a custom page. These settings will give body a class of case-study and allow the page's content to break the container layout restriction.

layout: case-study
body_class: case-study


Use middleman-blog for blogging features.

  • Create new posts via the command line:
middleman article "Some title for the article"
  • Set date_updated variable in frontmatter to indicate an article has been updated since being published


The following options are available in frontmatter:

  • title: Foobar
  • priority: 0.0 to 1.0 (default 0.5)
  • changefreq: always/hourly/daily/weekly/monthly/yearly/never (default: monthly)
  • date: 2015-03-28 19:29 CDT
  • date_updated: July 27, 2018
  • article_summary: String, summary of blog article used in blog archive list
  • published: false (default: true)

Deploying to Github Pages

Simplified deployments courtesy of middleman-deploy and called via rake tasks

  • Run the appropriate rake task, which will deploy the current branch


Builds project and runs uncss. Useful to cd into build and run http-server for local testing.

bundle exec rake deploy:local


Builds project, runs uncss, then pushes to branch staging.

bundle exec rake deploy:staging


Builds project, runs uncss, then pushes to branch gh-pages. After site builds, you must type yes to confirm the deploy.

bundle exec rake deploy:production