textile_toolbar 0.5

data/CHANGELOG

@@ -0,0 +1,4 @@
+10/22/08 - Automated asset copying into Rails project [Matthew Bass]
+           Updated documentation [Matthew Bass]
+
+8/21/08 - Initial version [Matthew Bass]

data/MIT-LICENSE

@@ -0,0 +1,16 @@
+Copyright (c) 2007-2008 Matthew Bass (http://matthewbass.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software
+and associated documentation files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
+BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README

@@ -0,0 +1,56 @@
+= 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
+
+Install the gem directly:
+
+  sudo gem install pelargir-textile_toolbar --source=http://gems.github.com
+  
+Or install the gem in your Rails project as a plugin:
+  
+  script/plugin install git://github.com/pelargir/textile_toolbar.git
+
+Or clone the project:
+
+  git clone git://github.com/pelargir/textile_toolbar.git
+
+Then copy the required image and JS files into your Rails project
+
+  rake textile_toolbar:install
+
+== 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 %>
+
+== Resources
+
+Repository: http://github.com/pelargir/textile_toolbar/
+Blog: http://matthewbass.com
+Author: Matthew Bass
+
+Extraction work sponsored by Terralien

data/Rakefile

@@ -0,0 +1,22 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the textile_toolbar plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the textile_toolbar plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'textile_toolbar'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/TODO

@@ -0,0 +1,4 @@
+- 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

data/deleted_files

@@ -0,0 +1,14 @@
+# Generated by the asset_copier plugin
+# http://github.com/pelargir/asset_copier
+#
+# Files that have been removed from the plugin and should also be removed from
+# any Rails projects that use the plugin should be listed here, one entry
+# per line. For example:
+#
+#   public/javascripts/foo.js
+#   app/views/foo/bar.erb.html
+#
+# Adding the paths above to this file would ensure that foo.js and bar.erb.html
+# both get removed from the target Rails project the next time the plugin's
+# files are copied over.
+

data/files/public/javascripts/textile_toolbar.js

@@ -0,0 +1,39 @@
+function surround_selection(text_area, prefix, suffix) {
+	text_area = $(text_area);
+	if (document.selection) { //IE support
+		text_area.focus();
+		sel = document.selection.createRange();
+		if (sel.text != "")
+			sel.text = prefix + sel.text + suffix;
+	} else if (text_area.selectionStart || text_area.selectionStart == '0') { //Mozilla/Firefox/Netscape 7+ support		
+		var startPos = text_area.selectionStart;
+		var endPos = text_area.selectionEnd;
+		selected_text = text_area.value.substring(startPos, endPos);
+		if (selected_text != "")
+			text_area.value = text_area.value.substring(0, startPos) + prefix + selected_text + suffix +
+										    text_area.value.substring(endPos, text_area.value.length);
+	}
+}
+
+function insert_at_selection(text_area, value) {
+	text_area = $(text_area);
+	if (document.selection) { //IE support
+		text_area.focus();
+		document.selection.createRange().text = value;
+	} else if (text_area.selectionStart || text_area.selectionStart == '0') { //Mozilla/Firefox/Netscape 7+ support		
+		var startPos = text_area.selectionStart;
+		var endPos = text_area.selectionEnd;
+		text_area.value = text_area.value.substring(0, startPos) + value +
+										  text_area.value.substring(endPos, text_area.value.length);
+	}	
+}
+
+function insert_hyperlink(text_area) {
+	url = prompt("Enter URL for hyperlink:", "http://");
+	surround_selection(text_area, '"', '":' + url);
+}
+
+function insert_image(text_area) {
+	url = prompt("Enter URL for image:", "http://");
+	insert_at_selection(text_area, '!' + url + '!');
+}

data/init.rb

@@ -0,0 +1,8 @@
+require 'textile_toolbar'
+require 'textile_toolbar/asset_copier'
+
+if RAILS_ENV == "development"
+  TextileToolbar::AssetCopier.copy "textile_toolbar"
+else
+  TextileToolbar::AssetCopier.warn "textile_toolbar"
+end

data/install.rb

@@ -0,0 +1,20 @@
+# Generated by the asset_copier plugin
+# http://github.com/pelargir/asset_copier
+
+require 'rake'
+ 
+begin
+  puts "============================================================="
+  puts "Attempting to install required files into your application..."
+  puts "============================================================="
+  RAKE_FILE = File.expand_path(File.join(File.dirname(__FILE__), 'tasks', 'asset_copier.rake'))
+  load RAKE_FILE
+  
+  Rake::Task['textile_toolbar:install'].invoke
+  puts "=========================================================="
+  puts "Success!"
+  puts "=========================================================="
+rescue Exception => ex
+  puts "FAILED TO INSTALL REQUIRED FILES.  PLEASE RUN rake textile_toolbar:install."
+  puts "EXCEPTION: #{ex}"
+end

data/lib/textile_toolbar.rb

@@ -0,0 +1,34 @@
+module TextileToolbar
+  def textile_area(object_name, method, options={})
+    disable = options.delete(:disable) || {}
+    toolbar = textile_toolbar(options[:id] || "#{object_name}_#{method}", disable)
+    "<div class=\"textile_toolbar\">#{toolbar}</div>" <<
+    "<div class=\"textile_area\">#{text_area(object_name, method, options)}</div>"
+  end
+  
+  def textile_toolbar(id, disable)
+    html = javascript_include_tag("textile_toolbar")
+    html << link_to_function(image_tag("textile_toolbar/bold.png", :size => "23x22", :alt => "Make selection bold"), "surround_selection('#{id}', '*', '*')")
+    html << "&nbsp;"
+    html << link_to_function(image_tag("textile_toolbar/italic.png", :size => "23x22", :alt => "Make selection italic"), "surround_selection('#{id}', '_', '_')")
+    html << "&nbsp;"
+    html << link_to_function(image_tag("textile_toolbar/underline.png", :size => "23x22", :alt => "Make selection underlined"), "surround_selection('#{id}', '+', '+')")
+    html << "&nbsp;"
+    html << link_to_function(image_tag("textile_toolbar/hyperlink.png", :size => "23x22", :alt => "Make hyperlink"), "insert_hyperlink('#{id}')")
+    html << "&nbsp;"
+    unless disable == :image
+      html << link_to_function(image_tag("textile_toolbar/image.png", :size => "23x22", :alt => "Insert image"), "insert_image('#{id}')")
+      html << "&nbsp;&nbsp;"
+    end
+    html << "<small>" << link_to("Textile", "http://hobix.com/textile/", :target => "_blank") << "&nbsp;enabled</small>"
+  end
+  
+  module FormBuilder
+    def textile_area(method, options={})
+      @template.textile_area(@object_name, method, options)
+    end
+  end
+end
+
+ActionView::Base.send :include, TextileToolbar
+ActionView::Helpers::FormBuilder.send :include, TextileToolbar::FormBuilder

data/tasks/asset_copier.rake

@@ -0,0 +1,11 @@
+# Generated by the asset_copier plugin
+# http://github.com/pelargir/asset_copier
+
+require File.expand_path(File.dirname(__FILE__) + '/../lib/textile_toolbar/asset_copier')
+
+namespace :textile_toolbar do
+  desc "Install files required by textile_toolbar"
+  task :install do  
+    TextileToolbar::AssetCopier.copy "textile_toolbar"
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,7 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+require 'mocha'
+require 'action_controller'
+
+require File.expand_path(File.dirname(__FILE__) + '/../lib/textile_toolbar')

data/test/textile_toolbar_test.rb

@@ -0,0 +1,18 @@
+require File.expand_path(File.dirname(__FILE__) + '/test_helper')
+
+class TextileToolbarTest < Test::Unit::TestCase
+  include TextileToolbar
+  include ActionView::Helpers::TagHelper
+  include ActionView::Helpers::AssetTagHelper
+  include ActionView::Helpers::JavaScriptHelper
+  include ActionView::Helpers::UrlHelper
+  include ActionView::Helpers::FormHelper
+  
+  context "textile_area" do
+    should "render text area" do
+      assert textile_area(:article, :body).include?("<textarea")
+      assert textile_area(:article, :body).include?("</textarea>")
+    end
+  end
+end
+

data/textile_toolbar.gemspec

@@ -0,0 +1,33 @@
+Gem::Specification.new do |s|
+  s.name     = "textile_toolbar"
+  s.version  = "0.5"
+  s.date     = "2008-08-21"
+  s.summary  = "Adds a handy Textile toolbar to any text area."
+  s.email    = "pelargir@gmail.com"
+  s.homepage = "http://github.com/pelargir/textile_toolbar"
+  s.description = "Adds a handy Textile toolbar to any text area."
+  s.has_rdoc = true
+  s.authors  = ["Matthew Bass"]
+  s.files    = [
+    "CHANGELOG",
+    "deleted_files",
+    "files/public/images/textile_toolbar/bold.png",
+    "files/public/images/textile_toolbar/hyperlink.png",
+    "files/public/images/textile_toolbar/image.png",
+    "files/public/images/textile_toolbar/italic.png",
+    "files/public/javascripts/textile_toolbar.js",
+		"init.rb",
+		"install.rb",
+		"lib/textile_toolbar.rb",
+    "MIT-LICENSE",
+    "Rakefile",
+		"README",
+		"tasks/asset_copier.rake",
+		"test/test_helper.rb",
+		"test/textile_toolbar_test.rb",
+		"textile_toolbar.gemspec",
+    "TODO"
+		]
+  s.rdoc_options = ["--main", "README"]
+  s.extra_rdoc_files = ["README"]
+end

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification 
+name: textile_toolbar
+version: !ruby/object:Gem::Version 
+  version: "0.5"
+platform: ruby
+authors: 
+- Matthew Bass
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-08-21 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: Adds a handy Textile toolbar to any text area.
+email: pelargir@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- CHANGELOG
+- deleted_files
+- files/public/images/textile_toolbar/bold.png
+- files/public/images/textile_toolbar/hyperlink.png
+- files/public/images/textile_toolbar/image.png
+- files/public/images/textile_toolbar/italic.png
+- files/public/javascripts/textile_toolbar.js
+- init.rb
+- install.rb
+- lib/textile_toolbar.rb
+- MIT-LICENSE
+- Rakefile
+- README
+- tasks/asset_copier.rake
+- test/test_helper.rb
+- test/textile_toolbar_test.rb
+- textile_toolbar.gemspec
+- TODO
+has_rdoc: true
+homepage: http://github.com/pelargir/textile_toolbar
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.4
+signing_key: 
+specification_version: 3
+summary: Adds a handy Textile toolbar to any text area.
+test_files: []
+