X-Git-Url: https://projects.mako.cc/source/selectricity/blobdiff_plain/24d7ecbc8af868040b1195acd1ed308b8b83e984..f0b41c2a66b9696a55e0bca008e215118b341ce5:/README diff --git a/README b/README index 84e08c5..4e94cc9 100644 --- a/README +++ b/README @@ -9,25 +9,32 @@ course, we'd sure like it if you would send fixes back to us and tell us about cool stuff you do with our software! The best way to get Selectricity is just to download it from our source -source repository. You'll need the Git version control system or -source control manager to check it. You can get it here: +tree. At the moment, we're hosting our code at Gitorious which is a +free software hosting provider. You can download Gitorious at the +project page by following detailed instructions at Gitorious: - http://git-scm.com/ + http://gitorious.org/selectricity -Once you have it, getting the source code is pretty easy. You just need -to check out a branch with a command like this: - git clone http://projects.mako.cc/source/selectricity/.git +=============================================== +=== Getting Help and Contributing ============= +=============================================== + +If you have a question, you can always email the core team at: + + team@selectricity.org -By default, this will create a working copy with the latest -*development* version of our code. If you want the latest production -version (i.e., what we're running on the site), you need to switch to -the live version of the software which is kept in a branch called -"live." Once you cloned the repository above, you can switch into the -directory (i.e., run "cd selectricity") and then run the following -command: +If you want to get involved in development, want to discuss +selectricity, or want to participate, please subscribe to our mailing +list here: - git checkout -b live origin/live + http://mailman.mit.edu/mailman/listinfo/selectricity + +In terms of bugs and documentation, we current plan to build this out in +our Gitorious wiki so feel free to get started with your own efforts +along these lines there: + + http://gitorious.org/selectricity/pages/Home =============================================== @@ -35,7 +42,8 @@ command: =============================================== To use Selectricity, you'll need to install the following gems in -addition to Ruby on Rails, MySQL, and its dependencies: +addition to Ruby on Rails (gem:rails), MySQL (gem:mysql), and its +dependencies: * rmagick * gruff (http://nubyonrails.com/pages/gruff) @@ -51,7 +59,8 @@ Also, you will need install the other applications installed first: * imagemagick (http://www.imagemagick.org/) On Ubuntu, you can install install the dependencies with: - apt-get install imagemagick libmagick9-dev ruby1.8-dev libwmf-bin + apt-get install imagemagick libmagick9-dev ruby1.8-dev libwmf-bin rdoc \ + libopenssl-ruby1.8 libreadline-ruby1.8 libmysqlclient15-dev Our server configuration uses Mongrel (installed from gems) behind an Apache2 load balancing proxy using mod_proxy. @@ -60,6 +69,7 @@ You'll also need to have a MTA installed. We use Postfix and have not tried it with any other system. Presumably though, anything that provides '/usr/bin/sendmail' should work. + =============================================== === Contributors to Selectricity Include ====== =============================================== @@ -68,6 +78,7 @@ provides '/usr/bin/sendmail' should work. * John Dong * Justin Sharps + ===================================== === XML-RPC INFO == ======================================