bdRead is a backdraft program that uses the complete framework from library to build application, so, in addition to downloading the bdRead program, you'll need to download the entire backdraft project. Don't worry; we've made it super-easy to get going!
The backdraft project is organized into several independent repositories:
The primary repositories for bdRead, backdraft, bdLoad, bdBuild, 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. All things dojo start at http://dojotoolkit.org (the downloads page is here, instructions for how to checkout from the repo is here, and the dojo github mirrors are here).
We also maintain a rollup of all of our projects and dojo 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, once you've downloaded the prescribed software, you'll need to point an HTTP server at the root of the tree (that is, the directory that holds all the siblings). With that done, you can navigate to any of the demo's with your browser and see them work locally.
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.
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 bdRead repo is at https://github.com/altoviso/bdRead. The other backdraft subprojects are easy to locate from the ALTOVISO github page at https://github.com/altoviso
bdRead 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.
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.
A Fossil repository consists of a a single file. Decide where you'd like to store the bdRead repository and clone the official repository to that location. For example, if you decide to store the repository at ~/fossils, then execute the command...
Note that the destination directory (e.g., ~/fossils) must exist before you attempt to clone.
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/bdRead, then execute the commands...