Download Instructions

In addition to bdBuild, you'll also need to download bdLoad and bdParse since bdBuild depends on these libraries.

The primary repositories for bdBuild, bdLoad, and bdParse are fossil repositories hosted at bdframework.org. More about this in a moment. To make things easy for github fans, we maintain github mirrors for all of our projects at https://github.com/altoviso.

We also maintain a rollup of all of our projects on github here. This makes it super-easy to quickly set up an experimental environment.

All of our demos are constructed with the expectation that the individual projects are siblings of each other. The rollup is organized as such, so of you have any doubts, make sure your local tree looks like this.

Lastly, bdBuild is a node.js program; therefore, you must have a functioning version of node.js installed. All things node start at http://nodejs.org.

Super-Easy

Go to https://github.com/altoviso/Open-Source-Project-Rollup. If you understand how to use github, then just clone the repo and you'll have everything you need to experiment. If you've never used github and don't want to learn, then look for the big "Downloads" button a few lines down on the right side of the page. Press this button and select the archive that works best for your environment. Once the download completes, unpack the archive to your local disk and you're done.

Github

The rollup may be slightly out of date. If you want the latest and greatest and/or want to contribute, then you should clone one of the official repos. For github...

The Fossil Repository

bdBuild uses Fossil for its primary repository. Fossil is a distributed software configuration management (SCM) system that includes a distributed ticket system; it's the same software that's used to manage the highly popular SQLite project. You can navigate to the fossil repository by selecting the repo menu item. When you do, you'll see the menu expand to include timeline, files, leaves, branches, tags, and tickets menu items that will allow you to navigate into the repository.

You can learn about Fossil at http://www.fossil-scm.org. Here are the minimum steps required to clone backdraft with Fossil.

  1. Install Fossil on your machine. Binaries are available for Windows, Linux, and OS X at http://www.fossil-scm.org/download.html. A FreeBSD port is available at /usr/ports/devel/fossil. If you are using some other system, see http://www.fossil-scm.org/index.html/doc/tip/www/build.wiki for details about how to build Fossil on your machine.

  2. A Fossil repository consists of a a single file. Decide where you'd like to store the bdBuild repository and clone the official repository to that location. For example, if you decide to store the repository at ~/fossils, then execute the command...

    > fossil clone http://bdframework.org/bdBuild/repo ~/fossils/bdBuild.fossil

    Note that the destination directory (e.g., ~/fossils) must exist before you attempt to clone.

  3. Finally, open the repository and extract the latest version to a local directory tree. For example, if you decide to open the repository at ~/dev/bdBuild, then execute the commands...

    > cd ~/dev/bdBuild > cd fossil open ~/fossils/bdBuild.fossil