cbot-bbcodeizer 0.2.0

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in bbcodeizer.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2006 Jonathan Dance / Agora Games
+Copyright (c) 2006 Trevor Turk
+Copyright (c) 2011 Luke Curley
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.

data/README

@@ -0,0 +1,128 @@
+== BBCodeizer
+
+BBCodeizer is a gem used to translate BBCode to HTML. The main interface
+is provided through the helper method "bbcodeize." Use of it is as simple as
+passing a string to bbcodeize:
+
+  <%= bbcodeize post.body %>
+
+You can also invoke the BBCodeizer directly without the helper:
+
+  render :text => BBCodeizer.bbcodeize(post.body)
+
+All settings are centralized so you can very quickly deactivate any tag or
+modify the HTML that is generated. You can modify these settings by adding
+lines to the end of your environment.rb. For example:
+
+  # deactivate [color], [size], and [code] tags
+  BBCodeizer.deactivate(:color, :size, :code)
+
+  # use <b> instead of <strong>
+  BBCodeizer.replace_using(:bold, '<b>\1</b>')
+
+These changes should be considered one-time configuration, e.g. tags
+cannot be deactivated then activated again.
+
+== Warning
+
+While BBCodeizer does some validation (see below), you should be aware it is
+possible to create unsafe HTML in the wrong hands (for example, invoking
+Javascript using the [url] tag). It is highly recommended you run the
+resulting HTML through a sanity checker such as WhiteList:
+
+  http://svn.techno-weenie.net/projects/plugins/white_list/
+
+Once installed, the following is a helper method that will produce nicely
+formatted, safe HTML:
+
+  def format_text(text)
+    white_list(simple_format(auto_link(bbcodeize(h(text)))))
+  end
+
+== Supported Tags
+
+BBCodeizer currently supports the following tags. The default HTML expansion
+is documented here.
+
+  [u]text[/u]
+
+    <u>text</u>
+
+  [b]text[/b]
+
+    <strong>text</strong>
+
+  [i]text[/i]
+
+    <em>text</em>
+
+  [img]http://example.com/image.gif[/img]
+
+    <img src="http://example.com/image.gif" />
+
+  [email=joe@example.com]Joe Example[/email]
+
+    <a href="mailto:joe@example.com">Joe Example</a>
+
+  [email]joe@example.com[/email]
+
+   <a href="mailto:joe@example.com">joe@example.com</a>
+
+  [code]bbcodeize(string)[/code]
+
+    <pre>bbcodeize(string)</pre>
+
+  [url=http://www.google.com]Google[/url]
+
+    <a href="http://www.google.com">Google</a>
+
+  [url]http://www.google.com[/url]
+
+    <a href="http://www.google.com">http://www.google.com</a>
+
+  [quote="Shakespeare"]To be or not to be[/quote]
+
+    <blockquote><cite>Shakespeare wrote:</cite><br />To be or not to
+  be</blockquote>
+
+  [quote]That is the question[/quote]
+
+    <blockquote>That is the question</blockquote>
+
+  [size=32]Big Text[/size]
+
+    <span style="font-size: 32px">Big Text</span>
+
+  [color=red]Red Text[/color] [color=#ABCDEF]Alphabet-colored Text[/color]
+
+    <span style="color: red">Red Text</span>
+    <span style="color: #ABCDEF">Alphabet Colored Text</span>
+
+== Validation
+
+BBCodeizer aims to produce HTML that will not break your site - all opening
+tags must have a closing tag or they will not be replaced (unmatched tags are
+left as-is). All [code] and [quote] tags are left entirely untouched if there
+is any mismatch with either of these. All other tags will replace as many as
+possible and leave the remaining unmatched tags as-is.
+
+BBCodeizer attempts to produce XHTML-compliant markup, however, misuse of
+nesting tags is not validated or corrected. For example:
+
+ [b]bold [u]bold + underline[/b] underline[/u]
+
+Will produce the following HTML:
+
+ <strong>bold <u>bold + underline</strong> underline</u>
+
+Colors in the [color] tag are not validated - any string can be used. Strings
+containing semicolons are not allowed to prevent users from adding additional
+style rules.
+
+Sizes used in the [size] tag are validated - only 1 or 2 digit numbers are
+accepted.
+
+-----------------
+Copyright (c) 2006 Jonathan Dance / Agora Games
+Copyright (c) 2011 Luke Curley
+Distributed under the MIT license

data/Rakefile

@@ -0,0 +1,22 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the BBCodeizer plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the BBCodeizer plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'BBCodeizer'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/bbcodeizer.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "bbcodeizer/version"
+
+Gem::Specification.new do |s|
+  s.name        = "cbot-bbcodeizer"
+  s.version     = Bbcodeizer::VERSION
+  s.authors     = ["Jonathan Dance", "Luke Curley"]
+  s.email       = ["jd+bbcodeizer@wuputah.com", "luke@box.net"]
+  s.homepage    = "https://github.com/qpingu/bbcodeizer"
+  s.summary     = %q{BBCodeizer is a simple gem that translates BBCode to HTML}
+
+  s.rubyforge_project = "bbcodeizer"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  s.add_development_dependency "rake"
+  s.add_development_dependency "rdoc"
+end

data/init.rb

@@ -0,0 +1,4 @@
+require 'bbcodeizer'
+require 'bbcodeize_helper'
+
+ActionView::Base.send :include, BBCodeizeHelper

data/lib/bbcodeizer.rb

@@ -0,0 +1,171 @@
+module BBCodeizer
+  class << self
+
+    #:nodoc:
+    Tags = {
+      :literal               => [ /\[\[(.+?)\]\]/im, '&#91\1&#93' ],
+      :start_code            => [ /\[code\](\r\n?)?/i, '<pre><code>' ],
+      :end_code              => [ /(\r\n?)?\[\/code\]/i, '</code></pre>' ],
+      :start_list            => [ /\[list\](\r\n?)?/i, '<ul>' ],
+      :start_li              => [ /\[li\](\r\n?)?/i, '<li>' ],
+      :end_li                => [ /(\r\n?)?\[\/li\](\r\n?)?/i, '</li>' ],
+      :end_list              => [ /(\r\n?)?\[\/list\]/i, '</ul>' ],
+      :start_quote           => [ /\[quote(?:=.*?)?\](\r\n?)?/i, '<blockquote>' ],
+      :start_quote_with_cite => [ /\[quote=(.*?)\](\r\n?)?/i, '<blockquote><p><cite>\1 wrote:</cite></p>' ],
+      :start_quote_sans_cite => [ /\[quote\](\r\n?)?/i, '<blockquote>' ],
+      :end_quote             => [ /(\r\n?)?\[\/quote\]/i, '</blockquote>' ],
+      :bold                  => [ /\[b\](.+?)\[\/b\]/im, '<strong>\1</strong>' ],
+      :italic                => [ /\[i\](.+?)\[\/i\]/im, '<em>\1</em>' ],
+      :underline             => [ /\[u\](.+?)\[\/u\]/im, '<u>\1</u>' ],
+      :del                   => [ /\[del\](.+?)\[\/del\]/im, '<del>\1</del>' ],
+      :strike                => [ /\[strike\](.+?)\[\/strike\]/im, '<del>\1</del>' ],
+      :email_with_name       => [ /\[email=(.+?)\](.+?)\[\/email\]/i, '<a href="mailto:\1">\2</a>' ],
+      :email_sans_name       => [ /\[email\](.+?)\[\/email\]/i, '<a href="mailto:\1">\1</a>' ],
+      :url_with_title        => [ /\[url=(.+?)\](.+?)\[\/url\]/i, '<a href="\1" target="_blank">\2</a>' ],
+      :url_sans_title        => [ /\[url\](.+?)\[\/url\]/i, '<a href="\1" target="_blank">\1</a>' ],
+      :image                 => [ /\[img\](.+?)\[\/img\]/i, '<img src="\1" alt="\1" />' ],
+      :size                  => [ /\[size=(\d{1,2})\](.+?)\[\/size\]/im, '<span style="font-size: \1px">\2</span>' ],
+      :color                 => [ /\[color=([^;]+?)\](.+?)\[\/color\]/im, '<span style="color: \1">\2</span>' ],
+      :youtube               => [ /\[youtube\](.+?)youtube.com\/watch\?v=(.+?)\[\/youtube\]/i, '<object width="425" height="350"><param name="movie" value="http://www.youtube.com/v/\2?fs=1"></param><param name="allowFullScreen" value="true"></param><embed src="http://www.youtube.com/v/\2?fs=1" type="application/x-shockwave-flash" allowfullscreen="true" width="425" height="350"></embed></object>' ],
+      :googlevid             => [ /\[googlevid\](.+?)video.google.com\/videoplay\?docid=(.*?)\[\/googlevid\]/i, '<embed style="width:400px; height:326px;" id="VideoPlayback" type="application/x-shockwave-flash" src="http://video.google.com/googleplayer.swf?docId=\2&amp;hl=en"></embed>' ],
+      :flash                 => [ /\[flash\](.+?)\[\/flash\]/i, '<object width="100%" height="100%"><param name="movie" value="\1"></param><embed src="\1" type="application/x-shockwave-flash" width="100%" height="100%"></embed></object>' ],
+      :spoiler               => [ /\[spoiler\](.+?)\[\/spoiler\]/im, '<a href="#" class="spoiler-link" onclick="$(\'_RANDOM_ID_\').toggle(); return false;">SPOILER</a><div id="_RANDOM_ID_" class="spoiler" style="display:none;">\1</div>' ],
+      :nsfw                  => [ /\[nsfw\](.+?)\[\/nsfw\]/im, '<a href="#" class="nsfw-link" onclick="$(\'_RANDOM_ID_\').toggle(); return false;">NSFW</a><div id="_RANDOM_ID_" class="nsfw" style="display:none;">\1</div>' ],
+      :hide                  => [ /\[hide=(.+?)\](.+?)\[\/hide\]/im, '<a href="#" class="hide-link" onclick="$(\'_RANDOM_ID_\').toggle(); return false;">\1</a><div id="_RANDOM_ID_" class="hide" style="display:none;">\2</div>' ],
+      :mp3                   => [ /\[mp3\](.+?)\[\/mp3\]/i, '<script language="JavaScript" src="/javascripts/audio-player.js"></script><object type="application/x-shockwave-flash" data="/flash/player.swf" id="_RANDOM_ID_" height="24" width="290"><param name="movie" value="/flash/player.swf"><param name="FlashVars" value="playerID=_RANDOM_ID_&amp;soundFile=\1"><param name="quality" value="high"><param name="menu" value="false"><param name="wmode" value="transparent"></object>' ],
+      :superdeluxe           => [ /\[superdeluxe\](.+?)superdeluxe.com\/sd\/contentDetail.do\?id=(.+?)\[\/superdeluxe\]/i, '<object width="400" height="350"><param name="allowFullScreen" value="true" /><param name="movie" value="http://www.superdeluxe.com/static/swf/share_vidplayer.swf" /><param name="FlashVars" value="id=\2" /><embed src="http://www.superdeluxe.com/static/swf/share_vidplayer.swf" FlashVars="id=\2" type="application/x-shockwave-flash" width="400" height="350" allowFullScreen="true" ></embed></object>' ],
+      :comedycentral         => [ /\[comedycentral\](.+?)comedycentral.com(.+?)?(.+?)=(.+?)\[\/comedycentral\]/i, '<embed FlashVars="config=http://www.comedycentral.com/motherload/xml/data_synd.jhtml?vid=\4%26myspace=false" src="http://www.comedycentral.com/motherload/syndicated_player/index.jhtml" quality="high" bgcolor="#006699" width="340" height="325" name="comedy_player" align="middle" allowScriptAccess="always" allownetworking="external" type="application/x-shockwave-flash" pluginspage="http://www.macromedia.com/go/getflashplayer"></embed>' ],
+      :revver                => [ /\[revver\](.+?)revver.com\/video\/(.+?)\/(.+?)\[\/revver\]/i, '<embed type="application/x-shockwave-flash" src="http://flash.revver.com/player/1.0/player.swf" pluginspage="http://www.macromedia.com/go/getflashplayer" scale="noScale" salign="TL" bgcolor="#000000" flashvars="mediaId=\2&affiliateId=0&allowFullScreen=true" allowfullscreen="true" height="392" width="480"></embed>' ],
+      :myspacetv             => [ /\[myspacetv\](.+?)myspace(.+?)videoid=(.+?)\[\/myspacetv\]/i, '<embed src="http://lads.myspace.com/videos/vplayer.swf" flashvars="m=\3&v=2&type=video" type="application/x-shockwave-flash" width="430" height="346"></embed>' ],
+      :collegehumor          => [ /\[collegehumor\](.+?)collegehumor.com\/video:(.+?)\[\/collegehumor\]/i, '<embed src="http://www.collegehumor.com/moogaloop/moogaloop.swf?clip_id=\2" quality="best" width="400" height="300" type="application/x-shockwave-flash"></embed>' ],
+      :hulu                  => [ /\[hulu\](.+?)\[\/hulu\]/i, '<object width="512" height="296"><param name="movie" value="http://www.hulu.com/embed/\1"></param><param name="allowFullScreen" value="true"></param><embed src="http://www.hulu.com/embed/\1" type="application/x-shockwave-flash" allowFullScreen="true"  width="512" height="296"></embed></object>' ],
+      :metacafe              => [ /\[metacafe\](.+?)metacafe.com\/watch\/(.+?)\/(.+?)\/\[\/metacafe\]/i, '<embed src="http://www.metacafe.com/fplayer/\2/\3.swf" width="400" height="345" wmode="transparent" pluginspage="http://www.macromedia.com/go/getflashplayer" type="application/x-shockwave-flash"></embed>' ],
+      :yahoovid              => [ /\[yahoovid\](.+?)video.yahoo.com\/watch\/(.+?)\/(.+?)\[\/yahoovid\]/i, '<object width="512" height="323"><param name="movie" value="http://d.yimg.com/static.video.yahoo.com/yep/YV_YEP.swf?ver=2.2.2" /><param name="allowFullScreen" value="true" /><param name="flashVars" value="id=\3&vid=\2&lang=en-us&intl=us&embed=1" /><embed src="http://d.yimg.com/static.video.yahoo.com/yep/YV_YEP.swf?ver=2.2.2" type="application/x-shockwave-flash" width="512" height="323" allowFullScreen="true" flashVars="id=\3&vid=\2&lang=en-us&intl=us&embed=1" ></embed></object>' ],
+      :flickr                => [ /\[flickr\](.+?)\/photos\/(.+?)\/(.+?)\[\/flickr\]/i, '<object type="application/x-shockwave-flash" width="400" height="300" data="http://www.flickr.com/apps/video/stewart.swf?v=1.162"><param name="flashvars" value="intl_lang=en-us&amp;photo_id=\3&amp;show_info_box=true"></param><param name="movie" value="http://www.flickr.com/apps/video/stewart.swf?v=1.162"></param><param name="bgcolor" value="#000000"></param><param name="allowFullScreen" value="true"></param><embed type="application/x-shockwave-flash" src="http://www.flickr.com/apps/video/stewart.swf?v=1.162" bgcolor="#000000" allowfullscreen="true" flashvars="intl_lang=en-us&amp;photo_id=\3&amp;flickr_show_info_box=true" height="300" width="400"></embed></object>' ],
+      :gametrailers          => [ /\[gametrailers\](.+?)gametrailers.com\/player\/(.+?)\.(.+?)\[\/gametrailers\]/i, '<object codebase="http://download.macromedia.com/pub/shockwave/ca...=8,0,0,0" id="gtembed" width="480" height="392">	<param name="allowScriptAccess" value="sameDomain" /> <param name="allowFullScreen" value="true" /> <param name="movie" value="http://www.gametrailers.com/remote_wrap.php?mid=\2"/> <param name="quality" value="high" /> <embed src="http://www.gametrailers.com/remote_wrap.php?mid=\2" swLiveConnect="true" name="gtembed" align="middle" allowScriptAccess="sameDomain" allowFullScreen="true" quality="high" pluginspage="http://www.macromedia.com/go/getflashplayer" type="application/x-shockwave-flash" width="480" height="392"></embed> </object>' ],      :slideshare            => [ /\[slideshare id=(.+?)&(.+?)=(.+?)&(.+?)=(.+?)\]/i, '<object type="application/x-shockwave-flash" wmode="transparent" data="https://s3.amazonaws.com:443/slideshare/ssplayer.swf?id=\1&#038;doc=\3" width="\5" height="348"><param name="movie" value="https://s3.amazonaws.com:443/slideshare/ssplayer.swf?id=\1&#038;doc=\3" /></object>' ],
+      :funnyordie            => [ /\[funnyordie\](.+?)funnyordie.com\/videos\/([^\/]+)(.*)\[\/funnyordie\]/i, '<object width="464" height="388"><param name="movie" value="http://www2.funnyordie.com/public/flash/fodplayer.swf?6045" /><param name="flashvars" value="key=\2" /><param name="allowfullscreen" value="true" /><embed width="464" height="388" flashvars="key=\2" allowfullscreen="true" quality="high" src="http://www2.funnyordie.com/public/flash/fodplayer.swf?6045" type="application/x-shockwave-flash"></embed></object>' ],
+      :atomfilms             => [ /\[atomfilms\](.+?)atomfilms.com\/film\/(.+?)\[\/atomfilms\]/i, '<embed src="http://www.atomfilms.com:80/a/autoplayer/shareEmbed.swf?keyword=\2" width="426" height="350"></embed>' ],
+      :current               => [ /\[current\](.+?)current.com\/items\/(.+?)\/(.+?)\[\/current\]/i, '<object width="400" height="400"><param name="movie" value="http://current.com/e/\2/en_US"></param><param name="wmode" value="transparent"></param><param name="allowfullscreen" value="true"></param><param name="allowscriptaccess" value="always"></param><embed src="http://current.com/e/\2/en_US" type="application/x-shockwave-flash"  width="400" height="400" wmode="transparent" allowfullscreen="true" allowscriptaccess="always"></embed></object>' ],
+      :vimeo                 => [ /\[vimeo\](.+?)vimeo.com\/(.+?)\[\/vimeo\]/i, '<object type="application/x-shockwave-flash" width="400" height="300" data="http://www.vimeo.com/moogaloop.swf?clip_id=\2&amp;server=www.vimeo.com&amp;fullscreen=1&amp;show_title=1&amp;show_byline=1&amp;show_portrait=0&amp;color=">	<param name="quality" value="best" />	<param name="allowfullscreen" value="true" />	<param name="scale" value="showAll" />	<param name="movie" value="http://www.vimeo.com/moogaloop.swf?clip_id=\2&amp;server=www.vimeo.com&amp;fullscreen=1&amp;show_title=1&amp;show_byline=1&amp;show_portrait=0&amp;color=" /></object>' ],
+      :grooveshark           => [ /\[grooveshark\](.+?)\[\/grooveshark\]/i, '<object width="250" height="40"> <param name="movie" value="http://listen.grooveshark.com/songWidget.swf"></param> <param name="wmode" value="window"></param> <param name="allowScriptAccess" value="always"></param> <param name="flashvars" value="hostname=cowbell.grooveshark.com&widgetID=\1&style=grass&p=0"></param> <embed src="http://listen.grooveshark.com/songWidget.swf" type="application/x-shockwave-flash" width="250" height="40" flashvars="hostname=cowbell.grooveshark.com&widgetID=\1&style=grass&p=0" allowScriptAccess="always" wmode="window"></embed></object>'],
+      :sup                   => [ /\[sup\](.+?)\[\/sup\]/im, '<sup>\1</sup>' ],
+      :sub                   => [ /\[sub\](.+?)\[\/sub\]/im, '<sub>\1</sub>' ],
+      :auto_link             => [ /(\A|\s|>)((https?:\/\/|www\.)[^\s<]+)/, '\1<a href="\2" target="_blank">\2</a>' ],
+    }
+
+    # Tags in this list are invoked. To deactivate a particular tag, call BBCodeizer.deactivate.
+    # These names correspond to either names above or methods in this module.
+                # The ':literal' tag MUST be first for it to work correctly
+    TagList = [ :literal, :bold, :italic, :underline, :del, :strike, :email_with_name,
+                :email_sans_name, :image, :size, :color, :code, :quote, :youtube, :googlevid,
+                :flash, :spoiler, :nsfw, :hide, :mp3, :superdeluxe, :comedycentral, :revver,
+                :myspacetv, :collegehumor, :hulu, :metacafe, :yahoovid, :flickr, :gametrailers,
+                :slideshare, :funnyordie, :atomfilms, :vimeo, :li, :list, :current, :auto_link,
+                :url_with_title, :url_sans_title ]
+
+    TagGroups = { :video => [ :youtube, :googlevid, :flash, :superdeluxe, :comedycentral, :revver,
+                            :myspacetv, :collegehumor, :hulu, :metacafe, :yahoovid, :gametrailers,
+                            :funnyordie, :atomfilms, :vimeo ],
+                  :image => [ :image, :flickr ] }
+
+    # Parses all bbcode in +text+ and returns a new HTML-formatted string.
+    def bbcodeize(text, options = Hash.new)
+      text = text.dup
+
+      disabled = Array.new
+      disabled += @deactivated if @deactivated
+      disabled += decode_tags(options[:disabled]) if options[:disabled]
+
+      (TagList - disabled).each do |tag|
+        if Tags.has_key?(tag)
+          apply_tag(text, tag)
+        else
+          self.send(tag, text)
+        end
+        # Replace the matching random ids for the following tags: spoiler, nsfw, mp3
+        @random_id = random_string
+        2.times { text = text.sub('_RANDOM_ID_', @random_id) }
+      end
+      text
+    end
+
+    # Configuration option to deactivate particular +tags+.
+    def deactivate(*tags)
+      @deactivated ||= Array.new
+      @deactivated += decode_tags(*tags)
+    end
+
+    # Configuration option to reactivate particular +tags+.
+    def activate(*tags)
+      @deactivated ||= Array.new
+      @deactivated -= decode_tags(*tags)
+    end
+
+    # Configuration option to change the replacement string used for a particular +tag+. The source
+    # code should be referenced to determine what an appropriate replacement +string+ would be.
+    def replace_using(tag, string)
+      Tags[tag][1] = string
+    end
+
+  private
+
+    def code(string)
+      # code tags must match, else don't do any replacing.
+      if string.scan(Tags[:start_code].first).size == string.scan(Tags[:end_code].first).size
+        apply_tags(string, :start_code, :end_code)
+        # strip out newlines from within the tags and replace them with '<br />', otherwise
+        # simple_format will simply append a '<br />' to the newlines, creating double spaces
+        string.gsub!(/#{Tags[:start_code].last}.+?#{Tags[:end_code].last}/im) { |s| s.gsub(/\r\n?/, '<br />') }
+      end
+    end
+
+    def li(string)
+      # list tags must match, else don't do any replacing.
+      if string.scan(Tags[:start_li].first).size == string.scan(Tags[:end_li].first).size
+        apply_tags(string, :start_li, :end_li)
+        # strip out newlines from within the tags and replace them with '<br />', otherwise
+        # simple_format will simply append a '<br />' to the newlines, creating double spaces
+        string.gsub!(/#{Tags[:start_li].last}.+?#{Tags[:end_li].last}/im) { |s| s.gsub(/\r\n?/, '<br />') }
+      end
+    end
+
+    def list(string)
+      # list tags must match, else don't do any replacing.
+      if string.scan(Tags[:start_list].first).size == string.scan(Tags[:end_list].first).size
+        apply_tags(string, :start_list, :end_list)
+        # strip out newlines from within the tags and replace them with '<br />', otherwise
+        # simple_format will simply append a '<br />' to the newlines, creating double spaces
+        string.gsub!(/#{Tags[:start_list].last}.+?#{Tags[:end_list].last}/im) { |s| s.gsub(/\r\n?/, '<br />') }
+      end
+    end
+
+    def quote(string)
+      # quotes must match, else don't do any replacing
+      if string.scan(Tags[:start_quote].first).size == string.scan(Tags[:end_quote].first).size
+        apply_tags(string, :start_quote_with_cite, :start_quote_sans_cite, :end_quote)
+        # strip out newlines from within the tags and replace them with '<br />', otherwise
+        # simple_format will simply append a '<br />' to the newlines, creating double spaces
+        string.gsub!(/#{Tags[:start_quote].last}.+?#{Tags[:end_quote].last}/im) { |s| s.gsub(/\r\n?/, '<br />') }
+      end
+    end
+
+    def apply_tags(string, *tags)
+      tags.each do |tag|
+        string.gsub!(*Tags[tag])
+      end
+    end
+    alias_method :apply_tag, :apply_tags
+
+    def decode_tags(*tags)
+      tags.inject(Array.new) do |decoded_tags, tag|
+        decoded_tag = TagGroups.key?(tag) ? TagGroups[tag] : tag
+        decoded_tags + Array(decoded_tag)
+      end
+    end
+
+    # http://stackoverflow.com/questions/88311/how-best-to-generate-a-random-string-in-ruby
+    def random_string
+      (0...16).map{ ('a'..'z').to_a[rand(26)] }.join
+    end
+  end
+end

data/lib/bbcodeizer/version.rb

@@ -0,0 +1,3 @@
+module Bbcodeizer
+  VERSION = "0.2.0"
+end

data/lib/bbcodeizer_helper.rb

@@ -0,0 +1,8 @@
+require 'bbcodeizer'
+
+module BBCodeizeHelper
+  # Parses all bbcode in +text+ and returns a new HTML-formatted string.
+  def bbcodeize(text, options = Hash.new)
+    BBCodeizer.bbcodeize(text, options)
+  end
+end

data/rdoc/BBCodeizeHelper.html

@@ -0,0 +1,182 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
+
+  <title>Module: BBCodeizeHelper</title>
+
+  <link rel="stylesheet" href="./rdoc.css" type="text/css" media="screen" />
+
+  <script src="./js/jquery.js" type="text/javascript" charset="utf-8"></script>
+  <script src="./js/thickbox-compressed.js" type="text/javascript" charset="utf-8"></script>
+  <script src="./js/quicksearch.js" type="text/javascript" charset="utf-8"></script>
+  <script src="./js/darkfish.js" type="text/javascript" charset="utf-8"></script>
+
+</head>
+<body id="top" class="module">
+
+  <div id="metadata">
+    <div id="home-metadata">
+      <div id="home-section" class="section">
+        <h3 class="section-header">
+          <a href="./index.html">Home</a>
+          <a href="./index.html#classes">Classes</a>
+          <a href="./index.html#methods">Methods</a>
+        </h3>
+      </div>
+    </div>
+
+    <div id="file-metadata">
+      <div id="file-list-section" class="section">
+        <h3 class="section-header">In Files</h3>
+        <div class="section-body">
+          <ul>
+          
+            <li><a href="./lib/bbcodeizer_helper_rb.html?TB_iframe=true&amp;height=550&amp;width=785"
+              class="thickbox" title="lib/bbcodeizer_helper.rb">lib/bbcodeizer_helper.rb</a></li>
+          
+          </ul>
+        </div>
+      </div>
+
+      
+    </div>
+
+    <div id="class-metadata">
+      
+
+      
+
+      
+
+      
+      <!-- Method Quickref -->
+      <div id="method-list-section" class="section">
+        <h3 class="section-header">Methods</h3>
+        <ul class="link-list">
+          
+          <li><a href="#method-i-bbcodeize">#bbcodeize</a></li>
+          
+        </ul>
+      </div>
+      
+
+      
+    </div>
+
+    <div id="project-metadata">
+      
+      
+      <div id="fileindex-section" class="section project-section">
+        <h3 class="section-header">Files</h3>
+        <ul>
+        
+          <li class="file"><a href="./README.html">README</a></li>
+        
+        </ul>
+      </div>
+      
+
+      <div id="classindex-section" class="section project-section">
+        <h3 class="section-header">Class/Module Index
+          <span class="search-toggle"><img src="./images/find.png"
+            height="16" width="16" alt="[+]"
+            title="show/hide quicksearch" /></span></h3>
+        <form action="#" method="get" accept-charset="utf-8" class="initially-hidden">
+        <fieldset>
+          <legend>Quicksearch</legend>
+          <input type="text" name="quicksearch" value=""
+            class="quicksearch-field" />
+        </fieldset>
+        </form>
+
+        <ul class="link-list">
+        
+          <li><a href="./BBCodeizeHelper.html">BBCodeizeHelper</a></li>
+        
+          <li><a href="./Bbcodeizer.html">Bbcodeizer</a></li>
+        
+        </ul>
+        <div id="no-class-search-results" style="display: none;">No matching classes.</div>
+      </div>
+
+      
+    </div>
+  </div>
+
+  <div id="documentation">
+    <h1 class="module">BBCodeizeHelper</h1>
+
+    <div id="description" class="description">
+      
+    </div><!-- description -->
+
+    
+    
+    
+    <div id="5Buntitled-5D" class="documentation-section">
+      
+
+      
+
+      
+
+      
+
+      <!-- Methods -->
+      
+      <div id="public-instance-method-details" class="method-section section">
+        <h3 class="section-header">Public Instance Methods</h3>
+
+      
+        <div id="bbcodeize-method" class="method-detail ">
+          <a name="method-i-bbcodeize"></a>
+
+          
+          <div class="method-heading">
+            <span class="method-name">bbcodeize</span><span
+              class="method-args">(text, options = Hash.new)</span>
+            <span class="method-click-advice">click to toggle source</span>
+          </div>
+          
+
+          <div class="method-description">
+            
+            <p>Parses all bbcode in <tt>text</tt> and returns a new HTML-formatted string.</p>
+            
+
+            
+            <div class="method-source-code" id="bbcodeize-source">
+<pre>
+<span class="ruby-comment"># File lib/bbcodeizer_helper.rb, line 5</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">bbcodeize</span>(<span class="ruby-identifier">text</span>, <span class="ruby-identifier">options</span> = <span class="ruby-constant">Hash</span>.<span class="ruby-identifier">new</span>)
+  <span class="ruby-constant">BBCodeizer</span>.<span class="ruby-identifier">bbcodeize</span>(<span class="ruby-identifier">text</span>, <span class="ruby-identifier">options</span>)
+<span class="ruby-keyword">end</span></pre>
+            </div><!-- bbcodeize-source -->
+            
+          </div>
+
+          
+
+          
+        </div><!-- bbcodeize-method -->
+
+      
+      </div><!-- public-instance-method-details -->
+    
+    </div><!-- 5Buntitled-5D -->
+  
+
+  </div><!-- documentation -->
+
+  <div id="validator-badges">
+    <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+    <p><small>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish
+      Rdoc Generator</a> 2</small>.</p>
+  </div>
+
+</body>
+</html>
+