This is the git repository for Dave Nelson’s version of Goldberg — the rapid website framework for Ruby on Rails.

About this version

This version has been packaged as a git Rails plugin, rather than as a generator gem. This should make it easy to include Goldberg as a submodule in your own project. See Usage, below.

This version also fixes many issues for Rails 2.1 compatibility.

Prerequisites

• Rails 2.1 (gem install rails)
• RedCloth (gem install RedCloth)

Usage

This is an example of how you would set up a Rails website that you plan to manage with git, with Goldberg as a submodule.

$ rails -d mysql mysite
$ cd mysite
$ git-init
$ git-submodule add git://github.com/urbanus/goldberg.git vendor/plugins/goldberg

The above assumes MySQL, but you can use other supported databases (SQLite, PostgreSQL etc.). Also we’re skipping some steps, like appropriate .gitignore entries for your log/ directory and others — that’s up to you.

Set up your config/database.yml appropriately then continue…

$ rake goldberg:install
$ rake goldberg:theme[snooker]

The first command above will bootstrap your Goldberg environment, including migrating and populating your database with a default setup.

The second runs a little bit of generator code to put Goldberg’s assets (images, stylesheets, javascripts) into public/ and to put a default application.html.erb into your site. Available themes include “ewnf”, “goldberg”, “snooker” and “spoiled_brat”.

And that’s it: now you should be ready to run script/server and use your site.

Contact

The main point of contact for the Goldberg project is the discussion group:

Ruby on Rails: Goldberg

You can contact me directly by email (urbanus at 240gl dot org), but I would consider it a courtesy if you would limit your inquiries to issues that actually require my attention. If you just need help please go to the group first.