codeforsanfrancisco.org

codeforsanfrancisco.org

CodeForSanFrancisco.org is hosted on Netlify and build using Jekyll

CodeForSanFrancisco.org

Website Background

Brigadehub, the current host of codeforsanfranciso.org is retired we desire to find a new long term solution to host the website. The current thought is to move back to using a static site generator, Jekyll. This repository is attempt at that. It is now live at codeforsanfrancisco.org.

Heavily inspired by Chi Hack Night's website.

Developing

  • Install the version of Ruby specified in .ruby-version
    • Usage of rbenv recommended
    • gem install bundle
  • Install yarn (used for managing external asset libraries (like Bootstrap, jQuery, etc.)
  • Run make
  • Edit code locally in new branch
  • Push to Github and open a Pull Request
  • Get Pull Request reviewed and preview the build by clicking on the Netlify build hook link
  • Merge into master (automatically publishes changes)

If you add a new external resource, be sure to add lines to the relevant Makefile target to copy them into css/vendor and js/vendor.

Scripts

Several scripts are included to facilitate synchronizing data to/from the site and external sources. Relevant scripts are highlighted below:

scripts/update-meetup

This script is used to update a Meetup.com event with the description and metadata specified in the corresponding markdown document in the _events/ collection. It should be run any time an event is updated. We would like to automate this in the future.