The hosts.yml file [06.08.2008]

This is a fairly major change, and requires some explanation.

As Blueprint is now being used by developers other than Inventive Labs, anyone might potentially want to create custom blueprint modules. Previously these were all in the core Blueprint repository; this update has moved them into separate repositories. The 'Page' and 'Search' blueprint modules are the only ones that come with Blueprint core. The rest of the core modules have been moved to http://canister.inventivelabs.com.au/blueprints/core.

You can add your own repository for custom blueprints. The mechanism for this is the new config/hosts.yml file, which replaces Rails' built-in database.yml file. You'll need to create this file -- you can base it off the hosts.sample.yml file in the same directory. Define your site and blueprint repositories (you should probably retain the 'core' blueprints repository), and set up your databases as you previously did for databases.yml.

Once this is done, you need to follow a one-off upgrade path:

rm -rf app
svn up
rake blueprint:upgrade:all

One of the benefits of this change is that you no longer need to enter the 'Repository root' for a site when running rake site:retrieve.