parity-RedCloth 4.2.9

data/lib/redcloth/textile_doc.rb

@@ -0,0 +1,113 @@
+module RedCloth
+  class TextileDoc < String
+    #
+    # Accessors for setting security restrictions.
+    #
+    # This is a nice thing if you're using RedCloth for
+    # formatting in public places (e.g. Wikis) where you
+    # don't want users to abuse HTML for bad things.
+    #
+    # If +:filter_html+ is set, HTML which wasn't
+    # created by the Textile processor will be escaped.
+    # Alternatively, if +:sanitize_html+ is set, 
+    # HTML can pass through the Textile processor but
+    # unauthorized tags and attributes will be removed.
+    #
+    # If +:filter_styles+ is set, it will also disable
+    # the style markup specifier. ('{color: red}')
+    #
+    # If +:filter_classes+ is set, it will also disable
+    # class attributes. ('!(classname)image!')
+    #
+    # If +:filter_ids+ is set, it will also disable
+    # id attributes. ('!(classname#id)image!')
+    #
+    attr_accessor :filter_html, :sanitize_html, :filter_styles, :filter_classes, :filter_ids
+
+    #
+    # Deprecated accessor for toggling hard breaks.
+    #
+    # Traditional RedCloth converted single newlines
+    # to HTML break tags, but later versions required
+    # +:hard_breaks+ be set to enable this behavior.
+    # +:hard_breaks+ is once again the default.
+    #
+    attr_accessor :hard_breaks
+
+    # Accessor for toggling lite mode.
+    #
+    # In lite mode, block-level rules are ignored.  This means
+    # that tables, paragraphs, lists, and such aren't available.
+    # Only the inline markup for bold, italics, entities and so on.
+    #
+    #   r = RedCloth.new( "And then? She *fell*!", [:lite_mode] )
+    #   r.to_html
+    #   #=> "And then? She <strong>fell</strong>!"
+    #
+    attr_accessor :lite_mode
+
+    #
+    # Accessor for toggling span caps.
+    #
+    # Textile places `span' tags around capitalized
+    # words by default, but this wreaks havoc on Wikis.
+    # If +:no_span_caps+ is set, this will be
+    # suppressed.
+    #
+    attr_accessor :no_span_caps
+    
+    # 
+    # If +:auto_link+ is set, plaintext urls will be
+    # turned into anchor elements.
+    #   
+    #   r = RedCloth.new( "Welcome http://zombo.com/", [:auto_link] )
+    #   r.to_html
+    #   #=> "<p>Welcome <a href="http://zombo.com/">http://zombo.com/</a></p>"
+    #   
+    attr_accessor :auto_link_urls
+
+    # Returns a new RedCloth object, based on _string_, observing 
+    # any _restrictions_ specified.
+    #
+    #   r = RedCloth.new( "h1. A *bold* man" )
+    #     #=> "h1. A *bold* man"
+    #   r.to_html
+    #     #=>"<h1>A <b>bold</b> man</h1>"
+    #
+    def initialize( string, restrictions = [] )
+      restrictions.each { |r| method("#{r}=").call( true ) }
+      super( string )
+    end
+
+    #
+    # Generates HTML from the Textile contents.
+    #
+    #   RedCloth.new( "And then? She *fell*!" ).to_html
+    #     #=>"<p>And then? She <strong>fell</strong>!</p>"
+    #
+    def to_html( *rules )
+      apply_rules(rules)
+  
+      to(RedCloth::Formatters::HTML)
+    end
+
+    #
+    # Generates LaTeX from the Textile contents.
+    #
+    #   RedCloth.new( "And then? She *fell*!" ).to_latex
+    #     #=> "And then? She \\textbf{fell}!\n\n"
+    #
+    def to_latex( *rules )
+      apply_rules(rules)
+  
+      to(RedCloth::Formatters::LATEX)
+    end
+
+    private
+    def apply_rules(rules)
+      rules.each do |r|
+        method(r).call(self) if self.respond_to?(r)
+      end
+    end
+  end
+end

data/lib/redcloth/version.rb

@@ -0,0 +1,34 @@
+module RedCloth
+  module VERSION
+    MAJOR = 4
+    MINOR = 2
+    TINY  = 9
+    RELEASE_CANDIDATE = nil
+
+    STRING = [MAJOR, MINOR, TINY, RELEASE_CANDIDATE].compact.join('.')
+    TAG = "REL_#{[MAJOR, MINOR, TINY, RELEASE_CANDIDATE].compact.join('_')}".upcase.gsub(/\.|-/, '_')
+    FULL_VERSION = "#{[MAJOR, MINOR, TINY, RELEASE_CANDIDATE].compact.join('.')}"
+    
+    class << self
+      def to_s
+        STRING
+      end
+      
+      def ==(arg)
+        STRING == arg
+      end
+    end
+  end
+  
+  NAME = "RedCloth"
+  GEM_NAME = NAME
+  URL  = "http://redcloth.org/"
+  description = "Textile parser for Ruby."
+
+  if RedCloth.const_defined?(:EXTENSION_LANGUAGE)
+    SUMMARY = "#{NAME}-#{VERSION::FULL_VERSION}-#{EXTENSION_LANGUAGE}"
+  else
+    SUMMARY = "#{NAME}-#{VERSION::FULL_VERSION}"
+  end
+  DESCRIPTION = SUMMARY + " - #{description}\n#{URL}"
+end

data/lib/redcloth.rb

@@ -0,0 +1,45 @@
+# If this is a frozen gem in Rails 2.1 and RedCloth 3.x was already
+# loaded by Rails' ActionView::Helpers::TextHelper, the user will get
+# "redcloth_scan.bundle: Class is not a module (TypeError)"
+# This hack is to work around that Rails loading problem.  The problem
+# appears to be fixed in Edge Rails [51e4106].
+Object.send(:remove_const, :RedCloth) if Object.const_defined?(:RedCloth) && RedCloth.is_a?(Class)
+
+require 'rbconfig'
+begin
+  conf = Object.const_get(defined?(RbConfig) ? :RbConfig : :Config)::CONFIG
+  prefix = conf['arch'] =~ /mswin|mingw/ ? "#{conf['MAJOR']}.#{conf['MINOR']}/" : ''
+  lib = "#{prefix}redcloth_scan"
+  require lib
+rescue LoadError => e
+  e.message << %{\nCouldn't load #{lib}\nThe $LOAD_PATH was:\n#{$LOAD_PATH.join("\n")}}
+  raise e
+end
+
+require 'redcloth/version'
+require 'redcloth/textile_doc'
+require 'redcloth/formatters/base'
+require 'redcloth/formatters/html'
+require 'redcloth/formatters/latex'
+
+module RedCloth
+  
+  # A convenience method for creating a new TextileDoc. See
+  # RedCloth::TextileDoc.
+  def self.new( *args, &block )
+    RedCloth::TextileDoc.new( *args, &block )
+  end
+  
+  # Include extension modules (if any) in TextileDoc.
+  def self.include(*args)
+    RedCloth::TextileDoc.send(:include, *args)
+  end
+  
+end
+
+begin
+  require 'erb'
+  require 'redcloth/erb_extension'
+  include ERB::Util
+rescue LoadError
+end

data/lib/tasks/pureruby.rake

@@ -0,0 +1,17 @@
+# Apparently this file gets loaded by Rails. Only want to define the pureruby
+# task in the context of RedCloth compilation (echoe loaded).
+
+if Gem::Specification.const_defined?(:PLATFORM_CROSS_TARGETS)
+  Gem::Specification::PLATFORM_CROSS_TARGETS << "pureruby"
+
+  task 'pureruby' do
+    reset_target 'pureruby'
+  end
+
+  if target = ARGV.detect do |arg| 
+    # Hack to get the platform set before the Rakefile evaluates
+      Gem::Specification::PLATFORM_CROSS_TARGETS.include? arg
+    end
+    reset_target target
+  end
+end

data/redcloth.gemspec

@@ -0,0 +1,54 @@
+# -*- encoding: utf-8 -*-
+redcloth_dir = Dir.pwd =~ /redcloth\/tmp/ ? File.expand_path("../../../..", Dir.pwd) : File.expand_path("..", __FILE__)
+$LOAD_PATH.unshift File.join(redcloth_dir, 'lib')
+require "redcloth/version"
+
+Gem::Specification.new do |s|
+  s.name        = "parity-RedCloth"
+  s.version     = RedCloth::VERSION.to_s
+  s.authors     = ["Jason Garber", "why the lucky stiff", "Ola Bini", "Jimish Jobanputra"]
+  s.description = "Textile parser for Ruby with auto_link support."
+  s.summary     = RedCloth::SUMMARY
+  s.email       = "jimish@desidime.com"
+  s.homepage    = "http://redcloth.org"
+  s.rubyforge_project = "redcloth"
+
+  s.rubygems_version   = "1.3.7"
+  s.default_executable = "redcloth"
+
+  s.files            = Dir['.gemtest', '.rspec', 'CHANGELOG', 'COPYING', 'Gemfile', 'README.rdoc', 'Rakefile', 'doc/**/*', 'bin/**/*', 'lib/**/*', 'redcloth.gemspec', 'spec/**/*', 'tasks/**/*']
+  s.test_files       = Dir['spec/**/*']
+  s.executables      = ['redcloth']
+  s.extra_rdoc_files = ["README.rdoc", "COPYING", "CHANGELOG"]
+  s.rdoc_options     = ["--charset=UTF-8", "--line-numbers", "--inline-source", "--title", "RedCloth", "--main", "README.rdoc"]
+  s.require_paths   += ["lib/case_sensitive_require", "ext"]
+
+  s.files -= Dir['lib/redcloth.jar']
+  s.files -= Dir['lib/**/*.dll']
+  s.files -= Dir['lib/**/*.bundle']
+  s.files -= Dir['lib/**/*.so']
+
+  s.platform = RUBY_PLATFORM[/java/] || 'ruby'
+  case s.platform.to_s
+  when /java/
+    s.files += ['lib/redcloth_scan.jar']
+  else # MRI or Rubinius
+    s.files += %w[attributes inline scan].map {|f| "ext/redcloth_scan/redcloth_#{f}.c"}
+    s.files += ["ext/redcloth_scan/redcloth.h"]
+    s.extensions = Dir['ext/**/extconf.rb']
+  end
+
+  s.add_development_dependency('bundler', '~> 1.9.1')
+  s.add_development_dependency('rake', '~> 10.0.3')
+  s.add_development_dependency('rspec', '~> 2.4')
+  s.add_development_dependency('diff-lcs', '~> 1.1.2')
+
+  # Have to load these even though they're only needed for
+  # gem packaging. Otherwise, Bundler complains that they're
+  # not installed even though they're not required.
+  # See https://github.com/carlhuda/bundler/issues/issue/1021
+  s.add_development_dependency('rvm', '~> 1.2.6')
+  s.add_development_dependency('rake-compiler', '~> 0.7.1')
+
+  s.license = "MIT"
+end

data/spec/benchmark_spec.rb

@@ -0,0 +1,15 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe "Benchmarking", :type => :formatter do
+  version = RedCloth::VERSION.is_a?(Module) ? RedCloth::VERSION::STRING : RedCloth::VERSION
+  platform = RedCloth.const_defined?(:EXTENSION_LANGUAGE) ? RedCloth::EXTENSION_LANGUAGE : (version < "4.0.0" ? "ruby-regex" : "C")
+  
+  it "should not be too slow" do
+    # puts "Benchmarking version #{version} compiled in #{platform}..."
+    fixtures.each do |name, doc|
+      if doc['html']
+        RedCloth.new(doc['in']).to_html
+      end
+    end
+  end
+end

data/spec/custom_tags_spec.rb

@@ -0,0 +1,50 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+module FigureTag
+  def fig( opts )
+    label, img = opts[:text].split('|').map! {|str| str.strip}
+
+    html  = %Q{<div class="img" id="figure-#{label.tr('.', '-')}">\n}
+    html << %Q{  <a class="fig" href="/images/#{img}">\n}
+    html << %Q{    <img src="/images/thumbs/#{img}" alt="Figure #{label}" />\n}
+    html << %Q{  </a>\n}
+    html << %Q{  <p>Figure #{label}</p>\n}
+    html << %Q{<div>\n}
+  end
+end
+
+describe "custom tags" do
+  it "should recognize the custom tag" do
+    input  = %Q{The first line of text.\n\n}
+    input << %Q{fig. 1.1 | img.jpg\n\n}
+    input << %Q{The last line of text.\n}
+    r = RedCloth.new input
+    r.extend FigureTag
+
+    html  = %Q{<p>The first line of text.</p>\n}
+    html << %Q{<div class="img" id="figure-1-1">\n}
+    html << %Q{  <a class="fig" href="/images/img.jpg">\n}
+    html << %Q{    <img src="/images/thumbs/img.jpg" alt="Figure 1.1" />\n}
+    html << %Q{  </a>\n}
+    html << %Q{  <p>Figure 1.1</p>\n}
+    html << %Q{<div>\n}
+    html << %Q{<p>The last line of text.</p>}
+    
+    r.to_html.should == html
+  end
+
+  it "should fall back if custom tag isn't defined" do
+    r = RedCloth.new %Q/fig()>[no]{color:red}. 1.1 | img.jpg/
+    
+    r.to_html.should == "<p>fig()>[no]{color:red}. 1.1 | img.jpg</p>"
+  end
+  
+  it "should not call just regular string methods" do
+    r = RedCloth.new "next. "
+    r.extend FigureTag
+
+    html  = "<p>next. </p>"
+
+    r.to_html.should == html
+  end
+end

data/spec/erb_spec.rb

@@ -0,0 +1,10 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe "ERB helper" do
+  it "should add a textile tag to ERB" do
+    template = %{<%=t "This new ERB tag makes is so _easy_ to use *RedCloth*" %>}
+    expected = %{<p>This new <span class="caps">ERB</span> tag makes is so <em>easy</em> to use <strong>RedCloth</strong></p>}
+    
+    ERB.new(template).result.should == expected
+  end
+end

data/spec/extension_spec.rb

@@ -0,0 +1,26 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+# http://www.ralree.info/2006/9/13/extending-redcloth
+module RedClothSmileyExtension
+  def refs_smiley(text)
+    text.gsub!(/(\s)~(:P|:D|:O|:o|:S|:\||;\)|:'\(|:\)|:\()/) do |m|
+      bef,ma = $~[1..2]
+      filename = "/images/emoticons/"+(ma.unpack("c*").join('_'))+".png"
+      "#{bef}<img src='#{filename}' title='#{ma}' class='smiley' />"
+    end
+  end
+end
+
+RedCloth.send(:include, RedClothSmileyExtension)
+
+describe RedClothSmileyExtension do
+  
+  it "should include the extension" do
+    input  = %Q{You're so silly! ~:P}
+
+    html  = %Q{<p>You&#8217;re so silly! <img src='/images/emoticons/58_80.png' title=':P' class='smiley' /></p>}
+
+    RedCloth.new(input).to_html(:textile, :refs_smiley).should == html
+  end
+  
+end