@@ -2,9 +2,7 @@ A simple plugin for creating URL-friendly permalinks (slugs) from attributes. -Uses the the [`unicode` library](http://www.yoshidam.net/Ruby.html) (`gem install unicode`) if available. - -Falls back to `iconv` from the Ruby standard library if `unicode` can't be loaded, but note that this library is [inconsistent between platforms](http://blade.nagaokaut.ac.jp/cgi-bin/scat.rb/ruby/ruby-talk/243426). +Uses [`ActiveSupport::Multibyte::Handlers::UTF8Handler`](http://api.rubyonrails.org/classes/ActiveSupport/Multibyte/Handlers/UTF8Handler.html) (part of Rails since 1.2) rather than `iconv` (which is [inconsistent between platforms](http://blade.nagaokaut.ac.jp/cgi-bin/scat.rb/ruby/ruby-talk/243426)) for normalization/decomposition. ## Usage @@ -63,4 +61,4 @@ Originally extracted from [Mephisto](http://mephistoblog.com) by [technoweenie]( Conditions added by [Pat Nakajima](http://github.com/nakajima/permalink_fu/). -[Henrik Nyh](http://github.com/technoweenie/permalink_fu/) made various fixes, including the addition of the [slugalizer](http://github.com/henrik/slugalizer) library (originally by [Christoffer Sawicki](http://termos.vemod.net)). +[Henrik Nyh](http://github.com/technoweenie/permalink_fu/) replaced `iconv` with `ActiveSupport::Multibyte`. README.markdown @@ -1,30 +1,19 @@ -$LOAD_PATH << "#{File.dirname(__FILE__)}/../vendor" - begin - require 'slugalizer' + require "active_support" rescue LoadError - - message = "Couldn't load 'unicode' library! Falling back to iconv, which has issues: see README!" - defined?(RAILS_DEFAULT_LOGGER) ? RAILS_DEFAULT_LOGGER.warn(message) : STDERR.puts(message) - - require 'iconv' - class Iconv - def self.slugalize(string) - s = Iconv.iconv('ascii//translit//IGNORE', 'utf-8', string).to_s - s.gsub!(/[^\w -]+/, '') # strip unwanted characters - s.strip! # ohh la la - s.downcase! - s.gsub!(/[ -]+/, '-') # separate by single dashes - s - end - end - + require "rubygems" + require "active_support" end module PermalinkFu + def self.escape(str) - object = Object.const_defined?(:Slugalizer) ? Slugalizer : Iconv - object.slugalize(str) + s = ActiveSupport::Multibyte::Handlers::UTF8Handler.normalize(str.to_s, :kd) + s.gsub!(/[^\w -]+/, '') # strip unwanted characters + s.strip! # ohh la la + s.downcase! + s.gsub!(/[ -]+/, '-') # separate by single dashes + s end def self.included(base) lib/permalink_fu.rb vendor/slugalizer.rb b500524e014fa099659c9505598243cad5cec456 Henrik N henrik@nyh.se http://github.com/henrik/permalink_fu/commit/fcbf49e7085a024c87394aacd2970d75af2a6317 fcbf49e7085a024c87394aacd2970d75af2a6317 2008-06-03T02:22:39-07:00 2008-06-03T02:22:39-07:00 Replace Slugalizer/iconv with ActiveSupport::Multibyte. Gives us cross-platform-reliable slugalizing without external dependencies (beyond ActiveSupport). a31f1c1fa10648719d4869c2e08d069b8d28e1bc Henrik N henrik@nyh.se