The project is a prototype of improved form design based on learnings from user research and usability testing with Austin Animal Center Foster Forms.
-
A Ruby dev environment is a requirement in order to run Jekyll locally.
-
(Optional) Install iTerm for a better Command Line App in OS X.
-
(Optional) Install oh-my-zsh for a prettier command line interface and easier zsh configuration than bash.
sh -c "$(curl -fsSL https://raw.github.com/robbyrussell/oh-my-zsh/master/tools/install.sh)"
-
Install homebrew (for better installation of OS X packages)
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
-
Install ruby-install for installing Ruby versions. (OS X comes with ruby 2.0.0, but its not the latest version and you may have to use the
sudo
command to do anything. Best to install a version manager like ruby-install + chruby to help with that.)brew install ruby-install
ruby-install ruby 2.4
-
Install chruby to switch ruby versions.
brew install chruby
chruby ruby 2.4
-
Install jekyll to install Jekyll.
gem install jekyll
-
Install dependencies
bundle install
Once you've got everything installed,
cd [directory_of_repo]
jekyll serve
Then go to
http://localhost:4000/
The prototype lives at https://cityofaustin.github.io/prototypeform/.
The master
branch of this repo is what gets deployed using Github Pages + Jekyll.rb.