zena

= 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