Changes between Version 4 and Version 5 of internet_rights_workshop/setup


Ignore:
Timestamp:
Jan 18, 2009, 3:55:00 PM (11 years ago)
Author:
Jamie McClelland
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • internet_rights_workshop/setup

    v4 v5  
    44The [wiki:internet_rights_workshop collaborative democracy workshop] uses a web application to facilitate its process.  That web application is under regular development, and we welcome contributions and collaboration from interested developers.  This page describes how to set up a development environment.  It often assumes you're running a debian-derived variant of the GNU/Linux operating system.  If you have another development environment you'd like to see documented, feel free to add instructions for that environment here.
    55
    6 == setting up the dependencies ==
     6== Debian GNU/Linux ==
     7
     8=== setting up the dependencies ===
    79
    810Make sure you have installed subversion, php5, sqlite, and a web server of your choice (most folks use apache, but there are lots of other ways to go).  On a debian-derived system, you could do:
     
    1214}}}
    1315
    14 == check out a working copy of the software ==
     16=== check out a working copy of the software ===
    1517
    1618This example puts the software in `/srv/ir`, but you can put it wherever makes sense to you (remember that the web server should be able to get to it).
     
    2426(note that the subversion repository's TLS certificate is currently signed by the [wiki:mfpl_certificate_authority May First/People Link certificate authority], and has an SHA1 fingerprint of `1D:88:9F:17:15:A1:B1:B6:11:FD:A5:67:08:D9:89:68:BD:C8:D0:DD`)
    2527
    26 == setting up a name-based virtual host ==
     28=== setting up a name-based virtual host ===
    2729
    2830pick a virtual host name where this software will run, and bind it to a local loopback IP address that your web server is listening on.  I've chosen the name `ir.test`, and i'm binding to 127.0.2.1:
     
    7981}}}
    8082
    81 == Create the sqlite database ==
     83=== Create the sqlite database ===
    8284
    8385The sqlite database needs to be in a directory writable by the web server.  Here's a way to do that with debian:
     
    8991}}}
    9092
    91 == Setting up the configuration ==
     93=== Setting up the configuration ===
    9294
    9395Now you need to configure the web application:
     
    99101Edit the contents of `/srv/ir/conf.php` to point to the correct source directory, and the actual database you've set up.  You'll need to set an end time for your workshop, and choose distinct group and monkey passwords for each room you've designated.
    100102
    101 == Testing it out ==
     103=== Testing it out ===
    102104
    103105Point your web browser at http://ir.test/ and run with it!
    104106
    105 == Following the development ==
     107=== Following the development ===
    106108
    107109As changes get pushed into the repository, you'll want to keep up with them.  You can bring your local working copy up-to-date with:
     
    111113}}}
    112114
    113 == Committing changes ==
     115=== Committing changes ===
    114116
    115117The above setup gives you the ability to follow the course of development and to make changes to your working copy.  If you've made changes that you think should be part of the main development branch, you'll need a commit access to the svn repository.  If you don't have that access already, [/newticket open a ticket] requesting access to the MF/PL SVN repo.  You'll need an SSH key for this.  Once you've been granted access, switch your local working copy over to access the repository via ssh instead of https:
     
    127129}}}
    128130svn will pop up an editor for you to write notes about the changes you're making.  This helps everyone else (and yourself, two months from now!) understand the intent behind the changes.
     131
     132== Microsoft Windows ==
     133
     134This is a start for the Windows documentation. The first step is to download [http://www.wampserver.com/ Wamp Server] (which provides Apache, PHP, and MySQL). You won't actually need MySQL, however, I still think this package is probably the easiest was to get Apache and PHP and it should come with Sqlite support built-in.
     135
     136To use subversion, you can download [http://tortoisesvn.tigris.org/ Tortoise SVN].
     137
     138== Macintosh ==
     139
     140This is a start for the Macintosh documentation. The first step is to download [http://www.mamp.info Mamp Server] (which provides Apache, PHP, and MySQL). You won't actually need MySQL, however, I still think this package is probably the easiest was to get Apache and PHP and it should come with Sqlite support built-in.