Ruby implementation of the MediaWiki markup language.

Supports

---

* Variables, Templates {{ ... }}
* Links
      o External Links [ ... ]
      o Internal Links, Images [[ ... ]]
            + (see also pipe trick) 
* Wikimedia Markup
      o == Headings ==
      o Lists (*#;:)
      o bold ('''), italic ('') or both (''''')
      o Horizontal rule (----)
      o Tables 
      o Table of Contents [__NOTOC__, __FORCETOC__, __TOC__]
* <code>,<nowiki>,<pre> (disable wiki markup)
      o space at the beginning of a line (<pre>) 
* <ref> and <references/> support
* html sanitization

Install

---

git clone git://github.com/nricciar/wikicloth.git
cd wikicloth/
rake gem
sudo gem install pkg/wikicloth-0.5.0.gem

Usage

---

@wiki = WikiCloth::Parser.new({
  :data => "<nowiki>{{test}}</nowiki> ''Hello {{test}}!''\n",
  :params => { "test" => "World" } })
@wiki.to_html => "<p>&#123;&#123;test&#125;&#125;  <i>Hello World!</i></p>"

Advanced Usage

---

Most features of WikiCloth can be overriden as needed…

class WikiParser < WikiCloth::Parser

  url_for do |page|
    "javascript:alert('You clicked on: #{page}');"
  end

  link_attributes_for do |page|
    { :href => url_for(page) }
  end

  include_resource do |resource,options|
    case resource
    when "date"
      Time.now.to_s
    else
      params[resource] unless params[resource].nil?
    end
  end

end

@wiki = WikiParser.new({ 
  :params => { "PAGENAME" => "Testing123" }, 
  :data => "[[ Hello World ]] From {{ PAGENAME }} on {{ date }}\n" 
})

@wiki.to_html =>
<p>
<a href="javascript:alert('You clicked on: Hello World');">Hello World</a> From Testing123 on Wed Jul 08 22:23:44 -0400 2009
</p>