[ANN] RedCloth 2.0 -- A Textile Humane Web Text Generator

ruby-talk
1

h1. RedCloth

h2. Humane text for Ruby

RedCloth is a module for using Textile in Ruby. Textile is a text
format. A very simple text format. Another stab at making readable
text that can be converted to HTML.

Textile is © 2003 Dean Allen. All rights reserved. You can read more
"here":http://www.textism.com/tools/textile/.

RedCloth is also based on PyTextile, which is: Copyright © 2003, “Mark
Pilgrim”:http://diveintomark.org/. All rights reserved. You can read
more about PyTextile “here”:http://diveintomark.org/projects/pytextile/.

h2. About Version 2.0

Last year, a new version of Textile was released for PHP. This 2.0
version allowed specification of style attributes and element
alignments. Below, is a header element with a green font coloring added.

  h2{color:green}. This is a title

You can also add elements ids, classes, and language settings.

  h2(class)
  h2(#id)
  h2[language]

RedCloth 2.0 has been completely recoded and tested with Ruby versions
1.8.0 and 1.6.8. There are some outstanding bugs with using RedCloth in
1.6.8, but I’m pushing it out the door anyway. Hopefully, I can get
some further revisions up in the coming weeks.

http://www.textpattern.com/help/?item=attributesh2. Installing RedCloth

To install RedCloth via raa-install:

  raa-install -i redcloth

Or “download
RedCloth”:http://prdownloads.sourceforge.net/yaml4r/redcloth-2.0.tar.gz
and simply run the install.rb like so:

  ruby install.rb config
  ruby install.rb setup
  sudo ruby install.rb install

h2. Using RedCloth

The RedCloth class is an extension of Ruby’s String class. Use it like
you would a String:

  >> r = RedCloth.new "*strong text* and _emphasized text_"
  => "*strong text* and _emphasized text_"
  >> r.gsub!( 'text', 'words' )
  => "*strong words* and _emphasized words_"

To generate HTML from your RedCloth object, use the @RedCloth#to_html@
method:

  >> r.to_html
  => "
strong words and emphasized words
"

h2. The Textile language

See the “Textile home page”:http://www.textism.com/tools/textile/ for
details on the Textile language.