== Zena
CMS based on Ruby on Rails, (c) Gaspard Bucher, teti.ch 2007-2009, licenced under MIT

This version of zena is *TOTALLY UNUSABLE* for the moment. It is the result of the slow migration from Rails 1.2.3 to Rails 2.x. You will need the latest rails edge with some patches which you can find here: http://github.com/gaspard/rails/tree/master.

== Creating the database
You need to set collation and charset to utf8 when creating the database. Example :
# create database zena DEFAULT CHARSET=utf8 COLLATE=utf8_general_ci;

== Development/testing
1. Create the database using a mysql client
   create database zena_dev DEFAULT CHARSET=utf8 COLLATE=utf8_general_ci;

2. Rename 'config/database_example.yml' to 'config/database.yml' and update it's content

3. Migrate the database and add initialize db (from within zena directory)
   rake zena:migrate

4. Create a first site or load fixtures
   rake zena:mksite HOST=localhost PASSWORD=secret LANG=en

5. Start server
   script/server

6. Connect to site 'http://localhost:3000'

7. Login with 'admin' and 'secret'

== Production
You should use capistrano to ease deployment. See 'config/delploy.rb'.

Manual deployment is done with the following commands:
1. Create the database with (using a mysql client)
   create database zena DEFAULT CHARSET=utf8 COLLATE=utf8_general_ci;
   
2. Create log directory
   mkdir log
   
3. Rename 'config/database_example.yml' to 'config/database.yml' and update it's content
   (change user, password if needed)
   
4. Migrate the database
   rake zena:migrate RAILS_ENV=production

4. Create a site
   rake zena:mksite HOST=example.com PASSWORD=secret LANG=en RAILS_ENV=production
   
5. Login user is 'admin', password is the one set on the line above.

== Create a new site
# rake zena:mksite HOST=example.com PASSWORD=secret RAILS_ENV=production

== Start
# ruby lib/upload_progress_server.rb start
# script/server -S config/mongrel_upload_progress.conf

== Stop
# ^C  (interrupt)
# ruby lib/upload_progress_server.rb stop


== Login
You can now login with 'admin' and the password you used to make the site.

== Dependencies

=== 1. Original in debian etch (might need to replace jpeg by libjpeg62)
  # aptitude install build-essential apache2 mysql-server libmagick9-dev gs-gpl libssl-dev gettext libgettext-ruby libreadline5 libreadline5-dev zlib1g-dev libncurses5 libncurses5-dev unzip liburi-perl libjpeg-dev subversion ssh sudo awstats

If you want to enable LateX (PDF generation)
tetex-bin tetex-extra latex-ucs

For math mode (inline formulas), you will need
latex dviutils gs-gpl imagemagick   # use 'dvips' if dviutils is not found. Use 'tetex' if 'latex' not found.

For xsl-fo pdf generation
xsltproc fop # (contrib sources needed on debian for 'fop')
             # use 'libxslt' if the package 'xsltproc' does not exist for your platform.

# ocaml-base-nox can be replaced by 'ocaml'
=== 2. To be installed by hand
ruby1.8.6
    # wget ftp://ftp.ruby-lang.org/pub/ruby/1.8/ruby-1.8.6.tar.gz
    # tar xzf ruby-1.8.6.tar.gz
    # cd ruby-1.8.6
    # ./configure --with-openssl
    # make && make install
rubygems
    # wget http://rubyforge.org/frs/download.php/45905/rubygems-1.3.1.tgz
    # tar xzf rubygems-1.3.1.tgz
    # cd rubygems-1.3.1
    # ruby setup.rb (if ruby is not found, log out and log back in)

ImageMagick (on Linux)
    # wget ftp://ftp.imagemagick.org/pub/ImageMagick/ImageMagick.tar.gz
    # tar xzf ImageMagick.tar.gz
    # cd ImageMagick-*
    # ./configure
    # make && make install
  
ImageMagick (on mac os X using macports)
    # sudo port install tiff -macosx imagemagick +q8 +gs +wmf

=== 3. install Gems

You can remove "--no-ri --no-rdoc" if you want the documentation
    # gem install querybuilder rake hoe gettext mongrel mongrel_cluster rmagick tzinfo syntax mongrel_upload_progress uuidtools daemons json capistrano yamltest ruby-debug --no-ri --no-rdoc

Versions:

 querybuilder >= 0.5.5
 uuidtools >= 2.x

=== Advised tools
monit (debian package to monitor your mongrel processes)


== Very experimental webDAV
Should not be used for production.

add this to nodes_controller macros:
  act_as_railsdav
  include Zena::WebDav

add this to 'config/environment.rb'
  require File.join(File.dirname(__FILE__), '../lib/webdav_adapter')

install railsdav
  # script/plugin install http://svn.liverail.net/svn/plugins/railsdav

install dependencies
  # sudo gem install mime-types, unicode