Module: RedRug

Includes:
Versionize
Defined in:
lib/red_rug.rb

Overview

RedRug provides a simplified interface to the functionality of the Redcarpet gem for Markdown handling, intended to provide convenience in execution of common tasks. At present, only HTML output is supported.

To begin using RedRug in your code, require it. Example:

require 'red_rug'

Class Method Summary collapse

Class Method Details

.from_file(filename, output_format = 'html') ⇒ Object

The filename argument is a string consisting of the name of a file, including path information as necessary.

The output_format argument is an output format supported by RedRug via to_* methods, indicated in lower case letters. When no output_format is specified, it defaults to HTML.

Example, assuming a file file.md containing only #foo on the first line:

RedRug.from_file('/usr/home/username/file.md', 'html')
=> "<h1>foo</h1>\n"

It depends on the implementation of the to_* method it calls.



65
66
67
68
69
70
 
# File 'lib/red_rug.rb', line 65

def self.from_file(filename, output_format='html')
  case output_format
  when 'html'
    to_html(IO.read filename)
  end
end

.to_html(markdown_string, options = Hash.new) ⇒ Object

The markdown_string argument is a string containing text using Markdown formatting recognized by Redcarpet. The method returns an HTML formatted version of the string. It depends on the Redcarpet implementation, which adds a newline at the end of the output string.

Example:

RedRug.to_html('#foo')
=> "<h1>foo</h1>\n"



38
39
40
41
42
43
44
45
 
# File 'lib/red_rug.rb', line 38

def self.to_html(markdown_string, options=Hash.new)
  unless options.has_key? :escape_html
    options[:escape_html] = false
  end

  markdown = Redcarpet::Markdown.new Redcarpet::Render::HTML.new(options)
  markdown.render(markdown_string)
end