Skip to content

codeforboston/codeforboston.org

Folders and files

NameName
Last commit message
Last commit date

Latest commit

4230c4a · May 13, 2025
Apr 1, 2022
May 13, 2025
Apr 23, 2025
Nov 10, 2021
Jun 8, 2022
Sep 1, 2023
Feb 12, 2022
Feb 9, 2022
Feb 12, 2022
Apr 6, 2019
Feb 10, 2022
Aug 29, 2018
Jun 11, 2020
Mar 21, 2025
Nov 17, 2021
Apr 23, 2025
Jun 28, 2023
Oct 23, 2020
Apr 23, 2025
Dec 2, 2023
May 6, 2020
May 6, 2020
Oct 23, 2020
Oct 23, 2020
Nov 15, 2023
Sep 9, 2022
Nov 10, 2021
Nov 17, 2021
Jun 28, 2023
Oct 7, 2020
Aug 24, 2017
Sep 23, 2020

Repository files navigation

Code For Boston Website

This is a pretty standard Jekyll website at http://www.codeforboston.org/; there are a number of datasets in _data that build various lists displayed on the site.

Please be sure to read our Code of Conduct. CFB is a Code for America Brigade.

I want to build the website locally. How do I do that?

  • Ensure you have Ruby installed on your system and available from your system $PATH. Instructions will vary per environment but are available here.
$> ruby --version
ruby 2.5.1p57 (2018-03-29 revision 63029) [x86_64-linux]
  • (Optional, only for those looking to contribute changes upstream) Ensure you have Git installed on your system and available from your system $PATH. Instructions will vary per environment but are available here.
$> $ git --version
git version 2.17.1
  • Install Jekyll through Ruby's Gem package management system. Jekyll is a dynamic website generator that allows Ruby code to be executed at build time. The result is a site of static pages.
$> gem install jekyll jekyll-redirect-from
Building native extensions. This could take a while...
...lots of output...
21 gems installed
  • NOTE: When the Jekyll gem is installed it will rely on several native dependencies on your system, and you may have to go hunting to find these. For instance, on Fedora 27, you may need to install gcc-c++, redhat-rpm-config, and ruby-devel using a command like:
$> sudo dnf install gcc-c++ redhat-rpm-config ruby-devel

GitHub Fork Button

  • Clone your namespace's remote into your local file system. Copy the address of your remote repository, then use that as an argument to the git clone command. For those not using git, simply download the sources using GitHub's UI. In the command below, remember to replace ALRubinger with your GitHub user name.

GitHub Clone Button

$> git clone git@github.com:ALRubinger/codeforboston.org.git
Cloning into 'codeforboston.org'...
remote: Counting objects: 1739, done.
Receiving objects:  24% (418/1739), 1.65 MiB | 3.23 MiB
...a lot of output...
Resolving deltas: 100% (867/867), done.
  • Move into the new working directory
$> cd codeforboston.org
  • Add a reference to the upstream remote repository so that you may later synchronize changes with new work.
$> git remote add upstream git@github.com:codeforboston/codeforboston.org.git
  • Use Jekyll to build the site!
$> $ jekyll build
  • Use Jekyll to start a small local web server to serve the site, reloading the build with changes you make to local files
$> $ jekyll serve --livereload
...lots of output...
LiveReload address: http://127.0.0.1:35729
    Server address: http://127.0.0.1:4000/
  Server running... press ctrl-c to stop.
  • View the site using your web browser at the address indicated above, in this case http://127.0.0.1:4000/. Changes you make to the source files should trigger a Jekyll rebuild and appear in your browser once done.

I want to update the wesite. How do I do that?

Deploy to codeforboston.org

This site is hosted via GitHub Pages, so all you need to do to deploy is to push updates to the master branch in GitHub. Within minutes, http://www.codeforboston.org/ will reflect the new changes.