Personal portfolio
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
data
helpers
source
.gitignore
.ruby-version
Gemfile
Gemfile.lock
README.md
Rakefile
_config.yml
config.rb
gulpfile.js
package.json
yarn.lock

README.md

Hello Jason Portfolio

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

Setup in development

Dependencies

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 git@github.com:hello-jason/portfolio.git ~/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

Weblog

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

Frontmatter

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

Local

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

bundle exec rake deploy:local

Staging

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

bundle exec rake deploy:staging

Production

Builds project, runs uncss, then pushes to branch gh-pages

bundle exec rake deploy:production