Project

headword

0.0
No commit activity in last 3 years
No release in over 3 years
Simplify adding usernames to your application.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

>= 1.0.2
 Project Readme

Headword

Rails user name routes for vain users.

Installation

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

In config/environment.rb:

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

We recommend you don’t vendor the gem:

Make sure the development database exists and run the generator:

script/generate headword

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

Routes

Headword installs a default catch-all route for single words (e.g., /jeffrafter). 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 headword based user pages.

Tutorial

Checkout the tutorial.

Authors

Headword is based on Spreadhead.

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/headword