getting started

documentation

  1. getting started
  2. installing
  3. user's manual
  4. zafu tutorials
  5. API
  6. data model
  7. skins
  8. videos
  9. secure (who can do what)
  10. extending zena
  11. zena 1.0

install zena

$ sudo gem install zena
$ zena myapp
$ cd myapp
$ rake zena:init RAILS_ENV=production

Here is what the last command does:

  1. create and migrate the database
  2. create a first website with hostname “localhost”
  3. start the application
  4. open the browser at the newly created site

A “zena” application is just a rails application which includes zena gem and uses zena’s routes.

learn how to add content

You can read the user’s manual to get you started or watch a video.

learn how to change the layout

The layout in zena is defined with zafu templates. Read the zafu tutorials or watch this video.

join the mailing-list

If you have any questions or remarks you can ask them on the mailing-list and we’ll be glad to help.

comments

  1. Saturday, November 22 2008 10:45 Fabio Cevasco

    §2 Initialize: Aso don’t forget to raname database_example.yml and edit it to be able to connect to the database…

  2. Saturday, November 22 2008 19:25 Gaspard Bucher

    Thanks for the comment. I updated the instructions.

  3. Sunday, December 13 2009 21:32 Iļja

    After $ zena myapp:
    ......................................
    create log/production.log
    create log/development.log
    create log/test.log
    applying template: /usr/lib/ruby/gems/1.8/gems/zena-0.15.1/lib/zena/deploy/template.rb
    The template [/usr/lib/ruby/gems/1.8/gems/zena-0.15.1/lib/zena/deploy/template.rb] could not be loaded. Error: /usr/local/lib/site_ruby/1.8/rubygems.rb:280:in `activate’: can’t activate rails (= 2.3.4, runtime) for [“zena-0.15.1”], already activated rails-2.3.5 for []

  4. Thursday, December 24 2009 11:01 Len Weincier

    I am getting the same error as Ilja :

    create log/test.log
    applying template: /Library/Ruby/Gems/1.8/gems/zena-0.15.1/lib/zena/deploy/template.rb
    The template [/Library/Ruby/Gems/1.8/gems/zena-0.15.1/lib/zena/deploy/template.rb] could not be loaded. Error: /Library/Ruby/Site/1.8/rubygems.rb:280:in `activate’: can’t activate rails (= 2.3.4, runtime) for [“zena-0.15.1”], already activated rails-2.3.5 for []

    Checked and everything is up to date ?

  5. Wednesday, January 06 2010 14:59 Gaspard Bucher

    Damn… this is stupid. I fixed the generator and released gem 0.15.2.

    Version 0.15.2 is a miny fix release. I cannot release the latest Sphinx support and other enhancements since these have not been thoroughly tested in production.

    By the way: I’m sorry it took me some time to notice these problems. The bug tracker: zena.lighthouseapp.com is watched more closely.

    Thanks for the feedback.

  6. Saturday, July 10 2010 02:31 Tim Bauman

    I get the similar errors to the ones other got in 0.15:
    rakefile zena_tasks.rake
    rake zena:assets OVERWRITE_ASSETS=true
    rake aborted!
    can’t activate rails (= 2.3.4, runtime) for [“zena-0.16.6”], already activated rails-2.3.8 for []
    /Users/Tim/myapp/Rakefile:10:in `require’
    (See full trace by running task with—trace)
    applied /usr/local/lib/ruby/gems/1.9.1/gems/zena-0.16.6/lib/zena/deploy/template.rb

  7. Sunday, July 11 2010 13:37 Gaspard Bucher

    Hi Tim,

    I pushed a new gem (0.16.7) that should solve this by requiring Rails 2.3.4 in “zena” command.

    By the way, I have a couple of tests left to fix these coming days and will release a beta version for the 1.0 branch.

  8. Monday, July 26 2010 15:32 Ollivier Robert

    Hello, Looking at the gem requirements, some things are not clear like does it support thin instead of mongrel? Is Passenger supported as well? What about using Bundler to automate this?

    Thanks, I’ll try to play with it soon. Any “upgrade” path from RadiantCMS for example?

  9. Friday, July 30 2010 21:21 Gaspard Bucher

    We are planning to use bundler when we migrate to Rails 3. A migration path from Radiant or other tools like Spip is an interesting idea. We have plans for regular tutorials and videos once the stable release is out. This could be interesting topics.

    Passenger is actually the prefered way to deploy Zena 1.x. We just need to update the capistrano tasks.

  10. leave a comment