Please keep in mind, I’m not developing the editor for almost 3 years, I’m not here for technical support, the sources are at GitHub (github.com/aprilchild) and even though there’s no license specified in the code, it’s sort of like MIT. In other words – you’re hereby free to do whatever you’d like with it. Including commercial use. I don’t mind, have fun:).

P.S. – something’s cooking, something far better than this old Amy Editor. In the same field, but …

First you should set your server machine environment, that is set its locale. Launch the command locale -a to get a list of all supported locales. Here’s what my Mac box says:


iMac:/usr/local/pgsql/bin postgres$ locale -a
..
..
cs_CZ
cs_CZ.ISO8859-2
cs_CZ.UTF-8
..
..

sk_SK.UTF-8
sl_SI
sl_SI.ISO8859-2
sl_SI.UTF-8
sr_YU
sr_YU.ISO8859-2
sr_YU.ISO8859-5
sr_YU.UTF-8
sv_SE
sv_SE.ISO8859-1
sv_SE.ISO8859-15
sv_SE.UTF-8
tr_TR
tr_TR.ISO8859-9
tr_TR.UTF-8
uk_UA
uk_UA.ISO8859-5
uk_UA.KOI8-U
uk_UA.UTF-8
..
..
C
POSIX


You should find your UTF-8 language there. I was looking for cs_CZ.UTF-8. Once found and confirmed, you should set it up to be your primary locale. Run locale and see what is your actual setting.


iMac:/usr/local/pgsql/bin postgres$ locale
LANG="cs_CZ.UTF-8"
LC_COLLATE="cs_CZ.UTF-8"
LC_CTYPE="cs_CZ.UTF-8"
LC_MESSAGES="cs_CZ.UTF-8"
LC_MONETARY="cs_CZ.UTF-8"
LC_NUMERIC="cs_CZ.UTF-8"
LC_TIME="cs_CZ.UTF-8"
LC_ALL="cs_CZ.UTF-8"


In order to change it (if it’s different than required), I’ve added the following to the ~/.bash_login file (this may vary on your system, consult Google for how to setup default locale on you machine).


iMac:/usr/local/pgsql/bin postgres$ vim ~/.bash_login

export LC_CTYPE=cs_CZ.UTF-8
export LANG=cs_CZ.UTF-8
export LANGUAGE=cs_CZ.UTF-8


Now you need to initialize postgres datadir with appropriate locale. In my case:


-- initialize
/usr/local/pgsql/bin/initdb --locale=cs_CZ.UTF-8 /usr/local/pgsql/data
-- and to create a database use:
createdb -E UTF8 test


You are almost done, now install tsearch2 support to you database by running the tsearch2.sql script.

Final step is to download my tsearch2-utf8-czech package and follow the instructions (you basically edit and launch the install.sql script on your database and test.sql to test tsearch2 support).

Download the tsearch2-utf8-czech package (includes tsearch2.sql script and ispell dictionaries). All examples of use and configuration are included in the packages.

Links: Tsearch2 page, Tsearch2 information in Czech.

Compiled on: iMac 2.16 GHz, Intel Core 2 Duo, Mac OS X 10.4.9, Ruby 1.8.5 (2006-12-25 patchlevel 12) [i686-darwin8.8.1], PostgreSQL 8.1.8

Prerequisities: PostgreSQL installed from source (compiled – not difficult, and compiles smoothly), Ruby installed

• 1. get the PL/Ruby package by Guy Decoux.
• 2. ungzip the archive (double click will do, command-line fans – do whatever you like:-)
• 3. in Terminal enter the plruby-0.5.0 directory
• 4. type ruby extconf.rb --with-safe-level=0
• 5. type make
• 6. type sudo make install
• 7. now PL/Ruby is installed, we need to create some PostgreSQL hook before starting to write our stored procedures/functions in Ruby.
• 8. enter the template1 database, which is used as template for newly created databases. type psql template1
• 9. type create function plruby_call_handler() returns language_handler as '/usr/local/lib/ruby/site_ruby/1.8/i686-darwin8.8.1/plruby.bundle' language 'C';
• 10. create language inside the database create language 'plruby' handler plruby_call_handler lancompiler 'PL/Ruby';
• 11. quit the console \q, you are set.

Now you might want to create new database that will include PL/Ruby language. If you want to add Ruby support to existing database, simply repeat steps 9 to 11 for your database.

Let’s see some action, we will write one simple stupid function used as multiplier, written in Ruby. *Sorry folks, I don’t know how to disable typographic apostrophes in Wordpres, you have to replace ` to ‘ in the commands.*


psql template1
Welcome to psql 8.1.8, the PostgreSQL interactive terminal.

template1=# create database rubytest;
CREATE DATABASE
template1=# \c rubytest
You are now connected to database "rubytest".
rubytest=# create or replace function ruby_multiply(integer) returns integer as 'return 2*args[0].to_i' language 'plruby';
CREATE FUNCTION
rubytest=# select ruby_multiply(2);
ruby_multiply
----------
4
(1 row)


More to be found at: Installing untrusted PL/Ruby for PostgreSQL and PL/Ruby loves RubyGems and DRb by Robby Russel, and official PL/Ruby project homepage.