zena / zena

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

== 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

=== 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