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

« back to all changes in this revision

Viewing changes to src/README

• browse files at revision 30
• compare with another revision
• download diff
• download tarball
• view history from revision 30

• reverse the comparison (30 to 1099.1.41)
• stop comparing with revision 1099.1.41

Show diffs side-by-side

added

removed

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).

• Older »

Loggerhead is a web-based interface for Breezy
Version: 2.0.1