= DESCRIPTION:

CMS with super natural powers, based on Ruby on Rails

website: http://zenadmin.org
licence: MIT

= Getting started

sudo gem install zena

zena new myapp

cd myapp

zena init

You can now visit http://localhost:3000 (user = admin, password = admin)

These commands do the following:

1. Install the zena gem and dependencies
2. Create an empty application
3. …
4. Create the database, migrate, create the ‘localhost’ website in ‘production’ environment and start server.

The ‘zena init’ task does the following:

rake db:create RAILS_ENV=production

zena migrate

zena mksite LANG=en RAILS_ENV=production PASSWORD=admin HOST=localhost

script/server -e production

Read more: http://zenadmin.org/documentation

== Details

Have a look at the generator used by ‘zena’ command:

http://github.com/zena/zena/blob/master/config/zena.rb

=== Production

You should use capistrano to ease deployment. See ‘config/delploy.rb’.

=== Create a new site

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)

=== Install MySQL on Lion (with rbenv: remove the sudo)
http://stackoverflow.com/questions/6340174/mysql-gem-on-osx-10-7-lion