Hieraki

From DreamHost

Installing Hieraki for Ruby on Rails

Hieraki is collaborative authoring tool used to document many of the ruby websites. It is a work in progress and might be buggy -- but even with limited functionality, it's still a great app.

From the Hieraki site:

Hieraki is an open source, wiki-like system that allows you to organize documents (such as tutorials for instance) in a highly structured fashion. Thus, Hieraki is ideal for applications where you want to impose a degree of structure that resembles most a file web browser.

After you get the default Ruby page to show (confirming everything else is working) you should back up a few files, namely .htaccess and database.yml as you'll be accidentally overwriting them in a few steps

[server]$ cp public/.htaccess public/htaccess.bak
[server]$ cp config/database.yml config/database.yml.bak

Use SVN to grab the necessary files from the SVN repository

[server]$ svn export -r 130 svn://hieraki.org/hieraki/trunk hieraki130

Don't have svn? Or would you rather use a stable release? Try the following:

[server]$ wget http://rubyforge.org/frs/download.php/5502/hieraki-1.0.2.tgz

[server]$ tar -zxf hieraki-1.0.2.tgz

The second command will unpack the .tgz, and because of the way the .tgz file was made, you'll find the files in a folder named hieraki-1.0.2. (LouisStAmour)

---

Browse around inside the directory and you'll see that you now have a slew of files in a directory called hieraki130/ that look curiously familiar. Copy all of these files on top of your current Ruby on Rails installation

[server]$ cp -rf hieraki130/* /home/yourname/rails.yoursite.com/

[server]$ mv public/htaccess.bak public/.htaccess
[server]$ mv config/database.yml.bak config/database.yml

Now either use phpMyAdmin or shell to create the table structure for hieraki

[server]$ mysql -h mysql.yourhostname.com -u yourname -p
[server]$ use yourdatabase;
[server]$ source db/mysql.sql;

That should get you going. Navigate to your site and with any sort of luck you'll have it up and running in no time. That encapsulates everything I know about making Hieraki work on Dreamhost. I've got even more experience making it not work that I'd be more than happy to share.