Plugin installation

Official installation documentation is at http://www.malline.org/install, but this page lists also alternative methods.

Any of the following methods will trigger *.mn -files to be handled automatically as Malline templates in Rails.

Using RubyGems

Preferred way to install stable Malline is to use gem:

sudo gem install malline

You need to require the plugin by adding the following line to config/environment.rb (this step is only needed when using gem, plugin installation will be registered automatically to Rails):

require 'malline/rails'

The gem can also be directly downloaded from Malline RubyForge project page.

Compile your own gem

If you want to install the latest development version as a gem, it's also easy:

svn co http://svn.malline.org/trunk/malline
cd malline
rake gem
sudo gem1.8 install pkg/malline*gem

Using Piston

If you want the latest bleeding edge version of the plugin or just don't want to use gem, Piston is probably the best way to do that:

piston import http://svn.malline.org/trunk/malline vendor/plugins/malline

or for stable version:

piston import http://svn.malline.org/stable/malline vendor/plugins/malline

You can later update the plugin with command:

piston update vendor/plugins/malline

You can do similar things with script/plugin install -x (svn:externals), but it is deprecated method and bad practice.

Using traditional plugin interface

Malline also supports installation as a normal Rails plugin. Use this if you want the development version, but you are not using subversion:

script/plugin install http://svn.malline.org/stable/malline

Unit testing

After installation run unit tests to make sure everything works correctly.

If installed with gem, run the tests also with gem:

gem check -t malline

Use rake when you installed the plugin with script/plugin, svn checkout or piston:

rake test:plugins PLUGIN=malline