Annotation of /branches/WIP-pyshapelib-bramz/Extensions/umn_mapserver/README


UMN MapServer Extension for Thuban
===================================

   *** ATTENTION: ***

   The installation instructions here are detailed, so I hope everybody
   can install the extension. People who are experienced will know
   most of the commands, but everybody should be able to use
   this extension.


Summary
--------------------

This extension for Thuban allows you to handle UMN MapServer .map-files.


Requirements
--------------------

To use the UMN MapServer extension you need:

    UMN MapServer python-mapscript

The extension was tested with UMN MapServer 4.0 and 4.2, 
older versions may not work.


Installation
--------------------

1. You need to build and install python-mapscript if you haven't installed yet.

    Download the UMN MapServer (http://mapserver.gis.umn.edu/dload.html)
    or use one on your system. The mapscript is included in the source package.

    Unpack and compile the UMN MapServer with optional proj and gdal support.
    A detailed install instruction can be found on the UMN MapServer Homepage.
    (http://mapserver.gis.umn.edu/doc40/unix-install-howto.html)

    Go to the directory where the UMN MapServer source code tar-ball exists:

        tar -zxf mapserver-4.2.0.tar.gz

    Go to the new created directory:

        cd mapserver-4.2.0 

    Configure an make the UMN MapServer

        ./configure --with-gdal --with-proj
        make

    Now we can compile and install the python mapscript

        cd mapscript/python/
        python setup.py build

    Some errors are ok during the build of python mapscript

    At last we musst install mapscript as root.

        python setup.py install

2. Add the umn_mapserver extension import statement to ~/.thuban/thubanstart.py
    if you run thuban directly from the source directory the statement is:

        import Extensions.umn_mapserver.mf_import

    More about how to use an extension 
    see README in thuban/Examples/simple_extensions.

3. Start Thuban and use the extension.


Usage
--------------------

The usage of the extension is very intuitive, so you will see what you can do
while you are using the extension ;)
1	jschuengel	2241
2			UMN MapServer Extension for Thuban
3			===================================
4
5			* ATTENTION: *
6
7			The installation instructions here are detailed, so I hope everybody
8			can install the extension. People who are experienced will know
9			most of the commands, but everybody should be able to use
10			this extension.
11
12
13
14			Summary
15			--------------------
16
17			This extension for Thuban allows you to handle UMN MapServer .map-files.
18
19
20
21			Requirements
22			--------------------
23
24			To use the UMN MapServer extension you need:
25
26			UMN MapServer python-mapscript
27
28			The extension was tested with UMN MapServer 4.0 and 4.2,
29			older versions may not work.
30
31
32
33			Installation
34			--------------------
35
36			1. You need to build and install python-mapscript if you haven't installed yet.
37
38			Download the UMN MapServer (http://mapserver.gis.umn.edu/dload.html)
39			or use one on your system. The mapscript is included in the source package.
40
41			Unpack and compile the UMN MapServer with optional proj and gdal support.
42			A detailed install instruction can be found on the UMN MapServer Homepage.
43			(http://mapserver.gis.umn.edu/doc40/unix-install-howto.html)
44
45			Go to the directory where the UMN MapServer source code tar-ball exists:
46
47			tar -zxf mapserver-4.2.0.tar.gz
48
49			Go to the new created directory:
50
51			cd mapserver-4.2.0
52
53			Configure an make the UMN MapServer
54
55			./configure --with-gdal --with-proj
56			make
57
58			Now we can compile and install the python mapscript
59
60			cd mapscript/python/
61			python setup.py build
62
63			Some errors are ok during the build of python mapscript
64
65			At last we musst install mapscript as root.
66
67			python setup.py install
68
69			2. Add the umn_mapserver extension import statement to ~/.thuban/thubanstart.py
70			if you run thuban directly from the source directory the statement is:
71
72			import Extensions.umn_mapserver.mf_import
73
74			More about how to use an extension
75			see README in thuban/Examples/simple_extensions.
76
77			3. Start Thuban and use the extension.
78
79
80
81			Usage
82			--------------------
83
84			The usage of the extension is very intuitive, so you will see what you can do
85			while you are using the extension ;)
Name	Value
svn:eol-style	native
svn:keywords	Author Date Id Revision