== 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
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
) is private.
