README

raspell

An interface binding for the Aspell spelling checker.

== License

Copyright 2007, 2008 Cloudburst, LLC. Licensed under the GPL 2.0. See included LICENSE file. Portions copyright 2005 Matthias Veit, Biro Eszter and used with permission.  

The public certificate for the gem is here[http://rubyforge.org/frs/download.php/25331/evan_weaver-original-public_cert.pem]. 

If you use this software, please {make a donation}[http://blog.evanweaver.com/donate/], or {recommend Evan}[http://www.workingwithrails.com/person/7739-evan-weaver] at Working with Rails.

== Requirements

Raspell requires Aspell version 0.6 (http://www.aspell.net) and at least one Aspell dictionary. 

Mac: 
  sudo port install aspell aspell-dict-en

Ubuntu: 
  sudo apt-get install aspell libaspell-dev aspell-en
  
== Installation

Mac:
  sudo gem install raspell -- --with-opt-dir=/opt/local
  
Ubuntu:
  sudo gem install raspell
  
== Usage

Aspell lets you <tt>check</tt> words and <tt>suggest</tt> corrections. For example:
   
  require 'rubygems'
  require 'raspell'
  
  speller = Aspell.new("en_US")
  speller.suggestion_mode = Aspell::NORMAL
  
  string = "my haert wil go on"
  
  string.gsub(/[\w\']+/) do |word| 
    if !speller.check(word) 
      # word is wrong
      puts "Possible correction for #{word}:"
      puts speller.suggest(word).first
    end
  end

This outputs:

  Possible correction for haert:
  heart
  Possible correction for wil:
  Will

Note that <tt>suggest</tt> returns an array of suggestions even for words that are correctly spelled.

== Options

The most useful options are <tt>suggestion_mode</tt>, and the passthrough option <tt>ignore_case</tt>. Passthrough options have to be set as so:

  speller.set_option("ignore-case", "true")

See http://aspell.net/man-html/The-Options.html for a list of the passthrough options. 

== Reporting problems

The support forum is here[http://rubyforge.org/forum/forum.php?forum_id=13988].

Patches and contributions are very welcome. Please note that contributors are required to assign copyright for their additions to Cloudburst, LLC.

== Futher resources

* http://blog.evanweaver.com/articles/2007/03/10/add-gud-spelning-to-ur-railz-app-or-wharever