This is the Github Pages source code for the Socrata Developer Portal (currently deployed to http://dev.socrata.com.
We love pull requests! If you'd like to contribute, feel free to fork this repo and send us pull requests.
The site is a customized Jekyll site, so there are some steps you'll need to take care of to get your environment set up:
- Make sure you have the
gh-pagesbranch checked out:git checkout -b gh-pages origin/gh-pages - Pull in the site templates and CSS/SASS, which come from submodules:
git submodule update --init - Make sure you have Ruby version installed. Check
.ruby-versionto see the preferred version. If you're using rbenv or rvm, this should automatically be set up - Install the Bundler Gem installed:
gem install bundler - Set up the Gem bundle:
bundle - To run a local server for development, run
rake serve. Your server will be available at http://localhost:9292
We love submissions from the community! If you'd like to submit a blog post about something you've built with the Socrata APIs, about open data technology, or something we might just be interested in, craft your blog post as a pull request and submit it for review:
- Review other posts and submissions to get a feel for the tone and language, and to see how others have formatted their posts.
- Fork this repo into your account
- Create a new blog post running
rake postand following the prompts - Write your post in Markdown, following a few rules:
- Set the
authorkey in the YAML front matter to your GitHub username so you get proper author credit - If your post uses any images, add them to the
imgfolder, prepended with your post date - Proof your post either using the instructions above to build and view the site, or using a Markdown preview tool like Marked or the one provided by GitHub.
- Submit your post and any required files as a pull request against the
gh-pagesbranch.
We'll review your post for content and acceptability. If there are any problems, we'll either fix them or let you know why we can't accept your post.
Please note that by submitting a post to the Socrata Developer Blog, you are are granting us an irrevocable license to distribute your work on dev.socrata.com or other mediums we choose. It will be covered by the same Creative Commons license as the rest of the content of dev.socrata.com.
Before submitting, please run rake test to run the test suite and confirm that you haven't broken anything. You may need to install phantomjs to run the test suite: npm install -g phantomjs
Continuous integration tests will be run when you submit a pull request, so this will save time if issues later crop up.
Site styling is controlled via css/local.sass and it's automatically regenerated by Github Pages with each push.