No commit activity in last 3 years
No release in over 3 years
Rails content mangement for pages that shouldn't be views.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

>= 1.0.0
>= 4.1.1
>= 1.0.2
 Project Readme

Spreadhead

spreadhead noun two facing pages of a book or other publication.

Rails content management for pages that shouldn’t be views.

Installation

Spreadhead is a Rails engine. It works with versions of Rails greater than 2.3.

In config/environment.rb:

config.gem "jeffrafter-spreadhead",
  :lib     => 'spreadhead',
  :source  => 'http://gems.github.com'

Vendor the gem:

rake gems:install
rake gems:unpack

Make sure the development database exists and run the generator:

script/generate spreadhead

A number of files will be created and instructions will be printed.

You may already have some of these files. Don’t worry. You’ll be asked if you want to overwrite them.

Run the migration:

rake db:migrate

Modify the initializer in config/initializers/spreadhead.rb to control access.

Routes

Spreadhead installs default catch-all routes. These are given the lowest priority in your application. If your application is already catching these routes then you may not be able to access your spreadhead pages.

Tutorial

Checkout the tutorial.

Authors

Spreadhead is based on the blog post http://neverlet.be/2008/12/17/building-a-content-managment-system by Jeff Rafter

The engine implementation and gem was patterned after the Clearance gem by Thoughtbot.

Suggestions, Bugs, Refactoring?

Fork away and create a Github Issue. Please send pull requests.

When you do:

  • Fork the project.
  • Make your feature addition or bug fix.
  • Add tests for it. This is important so I don’t break it in a future version unintentionally.
  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request. Bonus points for topic branches.

Documentation

Documentation is available at http://rdoc.info/projects/jeffrafter/spreadhead