Chi Hack Night website

Website for Chi Hack Night.

Chi Hack Night is Chicago's weekly event to build, share & learn about civic tech.

Hosted by Netlify.

Dependencies

• Jekyll - Static site generator built in Ruby
• Bootstrap 3 - HTML and CSS layouts
• DataTables - for searching and sorting tables
• Mustache - templating library for javascript (used on projects page)
• jQuery Address - for deep linking URLs on the projects page

Running locally

Requirements:

• ruby-2.6.2
• jekyll 3.6.3

We recommend using rvm to manage your Ruby versions.

Initial setup

git clone https://github.com/chihacknight/chihacknight.org.git
cd chihacknight.org
rvm install ruby-2.6.2
bundle install

Running locally

jekyll serve -w

Then open your web browser and navigate to http://localhost:4000

Run in a Docker container

If you have Docker installed, can avoid some of the hassle of installing Jekyll and/or Ruby by pulling from the offical Jekyll image, installing dependancies, and serving locally.

This is especially handy if you're on Windows machine:

docker run --rm --label=jekyll --volume=%CD%:/srv/jekyll  -it -p 4000:4000 jekyll/jekyll set JEKYLL_VERSION=3.6.3 | bundle install | jekyll serve

Deploying

Deployments are handled by Netlify by pushing to the production branch.

Whenver a branch is merged into production, or a commit is pushed to production it will trigger a Netlify deploy.

Workflow

The Chi Hack Night web team manages bugs, new features and site development through the GitHub project board.

To ensure high code quality, we practice using pull requests and having at least one member of the web team review them before merging in to production.

Protocols

Cancelled presenters If a presenter cancel after we have sent out our email blast, we add CANCELLED PRESENTATION to the event title and update the description of the event noting that it will be an open hack event. Example: https://chihacknight.org/events/2018/10/09/censusbureau.html

Projects and People

The projects and people pages are powered by Github and civic-json-worker, a script we run every 5 minutes that fetches data from the Github API.

The JSON files are backed up every hour in the civic-json-files repository.