← Back to branch summary

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

« back to all changes in this revision

Viewing changes to src/README

  • Committer: David Coles
  • Date: 2009-08-18 07:20:12 UTC
  • mto: This revision was merged to the branch mainline in revision 1318.
  • Revision ID: coles.david@gmail.com-20090818072012-y143flon5pvabsmw
Allow specification of a deadline when creating new projects.
Uses 'YYYY-MM-DD HH:mm:ss' as the format. Should be enforced by the web-ui.

Show diffs side-by-side

added added

removed removed

Lines of Context:
src/README
1
 
src directory - README
2
 
======================
3
 
 
4
 
This directory is the root of the IVLE web application proper. It is this
5
 
directory that should be installed into the web server to be executed.
6
 
Navigating to the place this directory is installed shall be the entrypoint
7
 
into the application.
8
 
 
9
 
Note that no files placed in this directory or its subdirectories will be
10
 
directly visible from the web, *except* those files placed in `/media` or its
11
 
subdirectories.
12
 
 
13
 
Apache configuration
14
 
--------------------
15
 
 
16
 
The Apache conf file should have the following directives added to it, which
17
 
configures the site to direct all URLs to the main dispatcher (except for
18
 
files in the /media directory).
19
 
 
20
 
    # IVLE directory configuration
21
 
    # See src/README for instructions and explanation
22
 
    <Directory "/ivle-directory"> 
23
 
        SetHandler mod_python
24
 
        PythonHandler dispatch_handler
25
 
        #PythonDebug On
26
 
        Options FollowSymLinks
27
 
        PythonOption ivle.handlerpath "/ivle-directory"
28
 
    </Directory>
29
 
    <Directory "/ivle-directory/media"> 
30
 
        SetHandler None
31
 
    </Directory>
32
 
 
33
 
Where `ivle-directory` is the path to root directory of IVLE on the web
34
 
server.
35
 
 
36
 
Uncomment `PythonDebug On` to turn on debugging.
37
 
 
38
 
Note that this disables directory listings across the whole site (which
39
 
essentially only affects the /media directory).
40
 
 
41
 
Special handling of media directory
42
 
-----------------------------------
43
 
 
44
 
One important exception: Apache must be configured so that the `/media`
45
 
directory and its subdirectories are served directly as-is, with no special
46
 
handling.
47
 
 
48
 
Files in the `/media` directory should be served with the standard MIME types
49
 
(eg. text/html for .html, image/png for .png). **No** server-side script
50
 
handling should take place in the media directory. That is, .py and .php files
51
 
should be simply served up as text/plain or whatever their default MIME type
52
 
is.
53
 
 
54
 
This simply means that the web server should NOT be configured to handle
55
 
scripts anywhere in the ivle directory, except for the above handling code.
56
 
 
57
 
Subdirectories
58
 
--------------
59
 
 
60
 
* /apps - Each plugin application has its own directory.
61
 
* /dispatch - Handler module for the top-level dispatch.
62
 
* /media - Contains files directly served by Apache (see above).
63
 
* /conf - Administrator configuration files (see /conf/README).