← Back to branch summary

~azzar1/unity/add-show-desktop-key

« back to all changes in this revision

Viewing changes to www/README

  • Committer: mattgiuca
  • Date: 2008-01-21 06:02:46 UTC
  • Revision ID: svn-v3-trunk0:2b9c9e99-6f39-0410-b283-7f802c844ae2:trunk:256
Changed the way IVLE's path is loaded into Python's sys.path. Now a file
"ivle.pth" is installed in Python's site packages which has the location of
the path. This replaces the method of using dispatch_handler.py.

* Removed dispatch_handler.py. No longer required.
* setup.py now automatically writes ivle.pth to Python's site packages.
* Updated README to indicate the new way to set up Apache. It's a lot simpler
  now, and you can run multiple IVLEs in the same server.

Hooray!

Show diffs side-by-side

added added

removed removed

Lines of Context:
www/README
13
13
Apache configuration
14
14
--------------------
15
15
 
 
16
IVLE should be installed into a place on the file system, and then there
 
17
should be a symlink created from Apache. Apache should symlink its IVLE
 
18
directory to the "www" directory, a subdirectory of the IVLE trunk.
 
19
 
16
20
The Apache conf file should have the following directives added to it, which
17
21
configures the site to direct all URLs to the main dispatcher (except for
18
22
files in the /media directory).
21
25
    # See src/README for instructions and explanation
22
26
    <Directory "/ivle-directory"> 
23
27
        SetHandler mod_python
24
 
        PythonHandler dispatch_handler
 
28
        PythonHandler dispatch
25
29
        #PythonDebug On
26
30
        Options FollowSymLinks
27
 
        PythonOption ivle.handlerpath "/ivle-directory"
28
31
    </Directory>
29
32
    <Directory "/ivle-directory/media"> 
30
33
        SetHandler None
31
34
    </Directory>
32
35
 
33
36
Where `ivle-directory` is the path to root directory of IVLE on the web
34
 
server.
 
37
server (the symlink which points to "www").
35
38
 
36
39
Uncomment `PythonDebug On` to turn on debugging.
37
40
 
38
41
Note that this disables directory listings across the whole site (which
39
42
essentially only affects the /media directory).
40
43
 
 
44
Python Site configuration
 
45
-------------------------
 
46
 
 
47
The setup install script automatically configures ivle.pth in the Python site
 
48
packages directory. This section is for if you run into trouble.
 
49
 
 
50
You need to set up IVLE as a Python site to allow importing of IVLE modules.
 
51
If this step is done improperly, you will see "ImportError: No module named
 
52
dispatch".
 
53
 
 
54
Place a file in the Python site packages directory
 
55
(ie. /usr/lib/python2.5/site-packages) called "ivle.pth". In it place a
 
56
single line containing the full path to the "www" directory inside
 
57
trunk in the installed location.
 
58
 
 
59
See http://docs.python.org/lib/module-site.html for information about
 
60
configuring .pth files.
 
61
 
41
62
Application configuration
42
63
-------------------------
43
64