Textile Toolbar

Adds a handy Textile toolbar to any text area. The toolbar currently offers the following functions:

• Bold: select some text and click this button to make it bold.
• Italic: select some text and click this button to make it italic.
• Insert Hyperlink: select some text, click, enter URL, and link is inserted.
• Insert Image: click, enter image URL, and image is inserted at cursor.

A link to a Textile reference page is also shown beside the toolbar.

Installation

Add this line to your application's Gemfile:

gem 'textile_toolbar'

And then execute:

$ bundle

Or install it yourself as:

$ gem install textile_toolbar

Usage

Use the textile_area helper where you would normally use the text_area helper. Yep, it's that simple!

<%= text_area :article, :body %>      # plain old text area
<%= textile_area :article, :body %>   # text area with Textile toolbar

Form blocks are supported, letting you do this also:

<% form_for :article do |f| -%>
  <%= f.textile_area :body %>
<% end -%>

Any options that can be passed to text_area can also be passed to textile_area. For example, to set the width and height:

<%= textile_area :article, :body, :rows => 5, :cols => 10 %>

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

TODO

• Add specs for existing functionality
• Incorporate live preview? See http://jrm.cc/extras/live-textile-preview.php
• More buttons (check PHP bulletin board)
• Create Radiant extension for admin text areas
• Convert textile_toolbar.js to jQuery

Resources

Repository: http://github.com/pelargir/textile_toolbar/ Blog: http://matthewbass.com Author: Matthew Bass