https://github.com/civictechdc/codefordc.github.com
[DEPRECATED] The old Code for DC website
https://github.com/civictechdc/codefordc.github.com
brigade cfa code-for-dc deprecated washington-dc
Last synced: 6 months ago
JSON representation
[DEPRECATED] The old Code for DC website
- Host: GitHub
- URL: https://github.com/civictechdc/codefordc.github.com
- Owner: civictechdc
- License: gpl-2.0
- Created: 2013-08-06T11:45:40.000Z (almost 13 years ago)
- Default Branch: master
- Last Pushed: 2022-10-05T22:43:17.000Z (over 3 years ago)
- Last Synced: 2024-09-08T02:16:07.485Z (almost 2 years ago)
- Topics: brigade, cfa, code-for-dc, deprecated, washington-dc
- Language: HTML
- Homepage: https://codefordc.github.io/
- Size: 19.1 MB
- Stars: 32
- Watchers: 16
- Forks: 60
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Code For DC Website
**PLEASE NOTE: This repository powers Code for DC’s old website, which you can find online [here](https://codefordc.github.io/). Code for DC’s [current website](https://codefordc.org/) is powered by the [`codefordc-website`](https://github.com/codefordc/codefordc-website) GitHub repository.**
-----
This is the repository for the website for Code for DC, the DC chapter of the Code for America Brigade program.
This site is built on Github pages and uses Jekyll for its blog.
## Contributing
If you want to make a blog post: read [this](https://github.com/codefordc/codefordc.github.com/blob/master/_resources/submitapost.md).
If you want to add a project to the projects page: read [this](https://github.com/codefordc/codefordc.github.com/blob/master/_resources/startaproject.md).
For everything else:
First, make sure that you have [`git`](http://git-scm.com/downloads) on your computer. Create your own [fork](https://guides.github.com/activities/forking/) of the repository, then clone it to your computer:
git clone git@github.com:[YOUR GITHUB NAME]/codefordc-2.0.git
You can work on the `master` branch (which is the default), but it's preferable to set up a new branch if you're working on a specific feature:
git checkout -b [NEW BRANCH NAME]
Next, you'll want to view the site locally using [`jekyll`](http://jekyllrb.com/docs/installation/). There are three ways to do this:
### Using Docker
Docker is a tool that abstracts away all of the environment configuration, allowing you to run this project (and others) without needing to install any other tools. To get started [install Docker](https://docs.docker.com/engine/installation/)
and then run
docker run --volume=$(pwd):/srv/jekyll -p 127.0.0.1:4000:4000 codefordc2/codefordc.org
### Less steps, but more points of failure
Make sure that you have [Ruby](https://www.ruby-lang.org/en/downloads/) installed on your system.
If you do, try this:
gem install jekyll #sudo is probably required
jekyll serve -w
Hopefully it works! If not and you see something like `jekyll: command not found`, you'll need to add the jekyll executable's location to your shell's `$PATH` variable. Here's an example of how that might work, but you should do some Googling to understand what you're doing here:
gem which jekyll
# /usr/lib/ruby/gems/1.9.3/gems/jekyll-2.4.0/lib/jekyll.rb
export PATH=$PATH:/usr/lib/ruby/gems/1.9.3/gems/jekyll-2.4.0/bin
jekyll serve -w
Point your browser to 0.0.0.0:4000. As you can see, this is a bit of a hacky workaround. If you upgrade Ruby in the future, be aware that this might get confusing as you add more gems.
### More steps, but more likely to work
A more elegant solution is to use a Ruby manager. Both `rbenv` and `RVM` are popular, but this example will use the former for its simplicity. Install [it](https://github.com/sstephenson/rbenv#installation), making sure to set up the init script and restart your shell. This may take some effort, but will allow you to manage multiple versions of Ruby and their various dependencies across projects (this is a common problem in Rubyland).
Then:
rbenv install 2.1.1
gem install bundler
bundle install
bundle exec jekyll serve -w
Point your browser to 0.0.0.0:4000.
## License
As stated in [LICENSE](LICENSE), the code in this repo is available under the GNU General Public License v2.0.
However, the copyright to certain parts of this repo is waived under the [Creative Commons Zero v1.0 license](http://creativecommons.org/publicdomain/zero/1.0/legalcode). Specifically, the following files are public domain:
- [Code of Conduct](https://github.com/codefordc/codefordc.github.com/blob/master/_resources/codeofconduct.md)