Webworke.rs

Life and Craft in Columbus, Ohio

Webworke.rs runs on Jekyll, a blog-aware, static site generator, with some help from Grunt.

The Stack

• Node.js and NPM: Required for Grunt and Bower
• Ruby: Required for Jekyll and Sass
• Bower: Manage most (but not all) of the front-end dependencies
• Bundler: Manage Ruby dependencies
• Grunt: Automate Jekyll development and build tasks
• ImageMagick: For Jekyll Picture Tag.

Recommended Setup

• Ensure that Command Line Tools for Xcode is installed and up-to-date
  • To install: xcode-select --install
• Manage your Ruby enviroments with RVM or rbenv
  • To update RVM: rvm get stable
• Use Homebrew to manage ImageMagick
  • To install Homebrew: ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  • To install ImageMagick: brew install imagemagick
• Make sure your install of Node.js is up-to-date
• Install the command line interface for Grunt (please note that Grunt is actually managed by NPM)
  • To install: npm install -g grunt-cli
• Install Bower
  • To install: npm install -g bower

Install Dependencies

Run the following commands to install the dependencies:

• NPM: npm cache clean and then npm install
• Bundler: bundle
• Bower: bower install

Grunt Workflow

• grunt serve: Compiles all files and opens the site in your default browser. A watch task watches for changes to files, recompiles if necessary, and injects the changes into the browser with BrowserSync
• grunt check: Checks for outdated dependencies with grunt-dev-update, Javascript code quality with JSHint, Jekyll health with jekyll doctor, and then runs the site through Google’s PageSpeed Insights
• grunt build: Builds an optimized site to the dist directory
• grunt deploy: Builds an optimized site to the dist directory and then deploys it.

Hat Tip

The site was scaffolded by Yeoman and generator-jekyllrb, the latter being a project of @robwierzbowski. Learn more about the site by reading the Colophon.