The gh-pages branch is fixmystreet.org, the Jekyll-based static site running on GitHub Pages that is the documentation for setting up / running the FixMyStreet platform.
In the below you could of course run
sudo gem install or
npm install -g but
I personally never think that's a good idea. You must already have gem and git
installed (you probably do).
gem install --no-document --user-install github-pages # Add ~/.gem/ruby/2.0.0/bin/ or similar to your $PATH # Check you can run "jekyll" git clone --recursive -b gh-pages https://github.com/mysociety/fixmystreet fixmystreet-pages cd fixmystreet-pages
If you only want to edit the text of the site, this is all you need. Run
jekyll serve --watch to run a webserver of the static site, and make changes
to the text you want.
If you want to edit the CSS or JS, or you'd like live reloading of changes in your web browser, you might as well set up the thing that monitors it all for you. You will need npm already installed.
gem install --no-document --user-install sass npm install grunt-cli npm install node_modules/.bin/grunt
This will start up a watcher that monitors the files and automatically compiles
jekyll build when necessary. It also live reloads
your web pages.
npm install bower node_modules/.bin/bower install
Then use bower to install a new library and add it to the Gruntfile.js.