ruhoh / ruhoh.rb

http://ruhoh.com
616 stars 69 forks source link

Stories in Ready
Build Status

Ruhoh is the Universal Static Blog API

Usage and quick start information at http://ruhoh.com

Running the Latest Version

All official releases are pushed out to http://rubygems.org/gems/ruhoh which can be used with bundler via Gemfile entry:

gem 'ruhoh'

The master branch will refer to the next version and can be used in the Gemfile:

gem 'ruhoh', :git => "git@github.com:ruhoh/ruhoh.rb.git"

Platforms

ruhoh has official support for ruby 1.9.2, 1.9.3, ruby 2.0.0 ruhoh runs in production with ruby 1.9.2 on Ubuntu 10.04.4 LTS.

ruby 1.8.7 is not supported.

Windows

ruhoh should run on Windows with a few considerations:

If you run into trouble with YAML and psych see: https://github.com/ruhoh/ruhoh.rb/issues/54 More help is available here: https://github.com/ruhoh/ruhoh.rb/issues/search?q=windows

I can't easily test ruhoh on a Windows machine, so please consider contributing back to the community for running on Windows.

Contributing

I enjoy getting better at managing contributions so all skill levels are welcome.

Tips to ensure your work has the best chance of getting merged in:

Testing

We use Cucumber for integration tests. Please have a look at https://github.com/ruhoh/ruhoh.rb/tree/master/features to see how to quickly write out tests. It should be quite fast to make new tests if you take advantage of the current step_defs.

Reporting Issues

Please use GitHub's issue tracker to report all issues and bugs.

If you are familiar enough with cucumber, it's best to include a failing test.feature file that sets up your situation and shows how the expected behavior is failing. In this way the bug can instantly be verified, a fix can be put in and a regression test will already exist =)

Community