Home

This page is up to date for Rango 0.2.

Installation via RubyGems

• Daily builds: gem install rango --pre and gem install simple-templater. RubyGems don’t work with prerelease gems properly, so you can’t just run gem install simple-templater rango --pre. The trouble is when you are installing with --pre, RubyGems are looking just for prerelease gems, but Erubis, which is dependency of simple-templater, doesn’t have any prerelease gem.
• Stable version: gem install simple-templater rango
• JRuby: jruby --1.9 -S gem install simple-templater rango is how you should install Rango for JRuby. Unfortunately I’m getting strange errors here. Don’t forget the --1.9 argument, because Rango can be installed just on Ruby 1.9.

Rango itself doesn’t define any runtime dependencies, since you may want to use just a subset of Rango, i. e. just template layer. If you are using stack generator, you get Gemfile with usual dependencies, so gem bundle will take care about it.

Installation via Rip

• Install edge version: rip install git://github.com/botanicus/rango.git
• Install tagged version: rip install git://github.com/botanicus/rango.git 0.2

Generic Topics

• FAQ
• Why use Rango?
• Comparision With Others Popular Ruby Frameworks
• Rango Philosophy
• Tutorial

Documentation

Start

• Generators
• Bundling

Before Boot

• Environments Support
• Rango Boot Process

Rack & HTTP

• Introduction to Rack
• Rack Middlewares
• Subdomains Handling
• Routers
• Generic Views
• Cache
• Authentication
• Errors Handling

MVC

• Controllers
• Partial Logic
• ORM Support

Templates

• Templates
• Template Rendering
• Template Contexts
• Template Inheritance

Plugins

• Writing Plugins
• Pagination

Development

• Code Reloading
• Debugging, Inspecting and Profiling

HOWTO

• From Merb to Rango

Others

• Deployment
• Background Tasks
• Rango in Other Frameworks

Rango development

Pull requests, wiki updates, tutorials and blog posts are very welcomed!

• Roadmap
• Bug reporting

How to Contribute To Rango

Contributions to Rango is easy, you don’t have to create a ticket or something, the only thing you really have to do is write good code. Before you send a pull request, please ensure that you:

• Wrote YARD documentation
• Wrote specs and run them under at least under Ruby 1.9.1, ideally under all the supported Ruby platforms:

# run all the specs under Ruby 1.9.1 and Ruby 1.9.2
rvm specs 1.9.1,1.9.2

# run given spec under all installed Ruby implementations
rvm ruby ./script/spec spec/rango/mixins/message_spec.rb

# run given spec under Ruby 1.9.1
rvm 1.9.1 ruby ./script/spec spec/rango/mixins/message_spec.rb

Links

• Presentation Introduction to Rango
• Tutorial
• RDoc.info API Docs
• Yardoc.org API Docs
• Examples
• API Docs
• Bug reporting
• Caliper Code Metrics

Community

• Google Group
• Rango Blog
• Twitter
• IRC: #rango at irc://irc.freenode.net