Rendering error pages for Rails application.
Ruby HTML
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
spec
.gitignore
.rspec
.travis.yml
Gemfile
MIT-LICENSE
README.md
Rakefile
rexception.gemspec

README.md

Rexception

Build Status Gem Version

Rexception is a Rails plugin that renders error pages dynamically, such as 403, 404, 500, and so on.

Installation

Add this line to your application's Gemfile:

gem 'rexception'

And then execute:

$ bundle

Usage

The simplest way, just add app/views/errors/application.html.erb. That's it, and Rails application render it when raise any errors.

If you placed specific views, such as forbidden.html.erb or not_found.html.erb, Rexception prefers these views to application.html.erb. (File name is see also: ActionDispatch::ExceptionWrapper.rescue_responses)

And you can specify layout file name, directory name to place views, and custom exceptions. Create config/initializers/rexception.rb and add following lines:

Rexception.configure do |config|
  # Layout file name to use for rendering error page.
  config.layout = 'application'

  # Directory name where you place error pages.
  config.errors_dir = 'errors_dir'

  # Pairs of custom exceptions and statuses.
  config.rescue_responses = {
    'CustomException' => :not_found
  }
end

In development mode, you should add this line to config/environments/development.rb to render error pages:

config.consider_all_requests_local = false

Contributing

  1. Fork it ( https://github.com/kami-zh/rexception/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request