Installing UnicodeUtils¶ ↑
The easiest way to install UnicodeUtils is with RubyGems:
$ gem install unicode_utils
Manual installation¶ ↑
Two kinds of files must be installed:
-
The library code. All files under
lib/
andlib/unicode_utils/
with suffix.rb
. The whole tree underlib/
must be on the load path. -
The compiled Unicode data files under
cdata/
. UnicodeUtils loads them from theUnicodeUtils::CDATA_DIR
directory, which is defined inread_cdata.rb
.
The best strategy is to copy the library files to Ruby's
sitelibdir
. You can get that by running:
$ ruby -r rbconfig -e "puts Config::CONFIG['sitelibdir']"
Then copy all files under cdata/
to
<sitelibdir>/unicode_utils
. And last but not least,
change the definition of CDATA_DIR
in
<sitelibdir>/unicode_utils/read_cdata.rb
to
File.absolute_path(File.dirname(_\FILE\_))
.
In fact, UnicodeUtils comes with an install.rb script that does all that:
$ ruby install.rb install
or:
$ ruby install.rb install /some/other/dir