
BlueCloth
=========

Version 0.99a - 2004/04/11

Original version by John Gruber <http://daringfireball.net/>.  
Ruby port by Michael Granger <http://www.deveiate.org/>.

BlueCloth is a Ruby implementation of [Markdown][1], a text-to-HTML conversion
tool for web writers. To quote from the project page: Markdown allows you to
write using an easy-to-read, easy-to-write plain text format, then convert it to
structurally valid XHTML (or HTML).

It borrows a naming convention and several helpings of interface from
[Redcloth][2], [Why the Lucky Stiff][3]'s processor for a similar text-to-HTML
conversion syntax called [Textile][4].


Installation
------------

You can install this module either by running the included `install.rb` script,
or by simply copying `lib/bluecloth.rb` to a directory in your load path.


Dependencies
------------

BlueCloth uses the `StringScanner` class from the `strscan` library, which
comes with Ruby 1.8.x and later, or may be downloaded from the RAA for earlier
versions.


Example Usage
-------------

The BlueCloth class is a subclass of Ruby's String, and can be used thusly:

    bc = BlueCloth::new( str )
    puts bc.to_html

This `README` file is an example of Markdown syntax. The sample program
`bluecloth` in the `bin/` directory can be used to convert this (or any other)
file with Markdown syntax into HTML:

    $ bin/bluecloth README > README.html


Acknowledgements
----------------

This library is a port of the canonical Perl one, and so owes most of its
functionality to its author, John Gruber. The bugs in this code are most
certainly an artifact of my porting it and not an artifact of the excellent code
from which it is derived.


Author/Legal
------------

Original version:  
Copyright (c) 2003-2004 John Gruber  
<http://daringfireball.net/>  
All rights reserved.

Ruby version:  
Copyright (c) 2004 The FaerieMUD Consortium

BlueCloth is free software; you can redistribute it and/or modify it under the
terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.

BlueCloth is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE.  See the GNU General Public License for more details.



  [1]: http://daringfireball.net/projects/markdown/
  [2]: http://www.whytheluckystiff.net/ruby/redcloth/
  [3]: http://www.whytheluckystiff.net/
  [4]: http://www.textism.com/tools/textile/


$Id: README 9 2004-04-12 05:29:37Z deveiant $  
$URL: svn+ssh://cvs.faeriemud.org/var/svn/BlueCloth/trunk/README $
