Renamed CSS and layout to move from the old name (HC) to the new name
[selectricity] / README
1 ===============================================
2 === Depedendencies ============================
3 ===============================================
4
5 To use Selectricity, you'll need to install the following gems in
6 addition to rails and its dependencies:
7
8  * rmagick
9  * gruff
10
11 Also, you will need install the other applications installed first:
12
13  * imagemagick (http://www.imagemagick.org/)
14
15    On Ubuntu, install: imagemagick libmagick9-dev ruby1.8-dev libwmf-bin
16
17 ===============================================
18 === Contributors to Selectricity Include ======
19 ===============================================
20
21  * Benjamin Mako Hill <mako@atdot.cc>
22  * John Dong          <jdong@ubuntu.com>
23  * Justin Sharps      <jlsharps@mit.edu>
24
25 ===============================================
26 === Log =======================================
27 ===============================================
28
29 07/31/07
30 jlsharps: I've added a user authentication system known as
31 "acts_as_authenticated" to the code. The plugin is the the vendor/plugins 
32 directory. The two most noticeable changes are the AccountController and a 
33 redone User model. I've left the UserController in place for now, but the 
34 AccountController works in a different manner, so am switching over to that 
35 gradually. I saved the 5 lines or so in the old User model, overwrote 
36 it with the authenticated generator and then recopied the old stuff back in: 
37 has_many :elections and the name() method. The generator also creates its own 
38 migration file, but since we are using a create.sql file I adopted the 
39 migration file into a new users table in the create.sql file. I have yet to 
40 delete the old table because I haven't fully combed through the code yet and 
41 determined how many of the old attributes (such as first_name, last_name) may 
42 need to be retained. 
43 http://technoweenie.stikipad.com/plugins/show/Acts+as+Authenticated is the 
44 best site for documentation regarding acts_as_authenticaed. Also, currently
45 it only stores the user_id in the session, but i just found a guide to help 
46 me make it store the entire user object, so I'll do that while my battery 
47 charges.
48
49 08/03/07
50 Handy trick: use the command 'gem_server' from a shell to create a server at 
51 http://localhost:8008 that is an easy to navigate locally-hosted website with 
52 all the documentation on local gems you have in a easy to read format.
53
54 jlsharps: I added the Gruff plug-in today, which is viewable under the folder
55 vender/plugins/gruff.  I installed it directly using the Gruff plug-in and
56 included controller generate utility. The version 0.1.2, which doesn't seem to
57 be the latest version. I've looked into it and it see and it seems that the
58 latest version is 0.2.8. However, I wasn't sure how including a gem w/o a plugin 
59 would function in end-game rails so I just what I used for now. If you guys 
60 (mako of john) know how to do it, it'd probably be better to upgrade, but it 
61 didn't seem like the best use of my time right now.  I got the plug-in here:
62 http://topfunky.net/svn/plugins/gruff. You can get the gruff gem v 0.2.8 by 
63 typing "sudo gem install gruff", I believe it's also hosted on RubyForge. 
64
65 I created the GraphsController for Gruff methods to use. In Pollarize I put them 
66 in the ApplicationContorller file, so they would be accessible to all. While 
67 that it also an option here, it would also mean there wouldn't be much room for 
68 playing around because everything in the Application file has to be perfect or 
69 it seems to throw Error Code 500 (basically everything breaks). The show() 
70 is a sample sample provided with Gruff. 
71
72 Documentation is here:http://gruff.rubyforge.org/  Alternately, if you have the 
73 gem installed, you can use the ri command, or the above mentioned gem_server. 
74
75 If you guys want more helpful stuff here, let me know.
76
77
78
79
80

Benjamin Mako Hill || Want to submit a patch?