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.
- 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
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
, andruby-devel
using a command like:
$> sudo dnf install gcc-c++ redhat-rpm-config ruby-devel
- Fork the upstream code repository at https://github.com/codeforboston/codeforboston.org into your namespace using the GitHub UI.
- 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 usinggit
, simply download the sources using GitHub's UI. In the command below, remember to replaceALRubinger
with your GitHub user name.
$> git clone [email protected]: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 [email protected]: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.
- To add/update jobs, edit
_data/jobs.yml
- To add/update events, edit
_data/events/active.yml
- To add/update current projects, edit
_data/projects/active.yml
- To add/update retired projects, edit
_data/projects/inactive.yml
- To edit normal site pages, edit the
html
ormarkdown
files in_pages/
- To edit the homepage content, edit
index.html
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.