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.
    In some cases gdal is not necessary and mapscript can install without gdal support.
    A detailed install instruction can be found on the UMN MapServer Homepage.
    (http://mapserver.gis.umn.edu)

    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 warnings 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	jschuengel	2248	In some cases gdal is not necessary and mapscript can install without gdal support.
43	jschuengel	2241	A detailed install instruction can be found on the UMN MapServer Homepage.
44	jschuengel	2248	(http://mapserver.gis.umn.edu)
45	jschuengel	2241
46			Go to the directory where the UMN MapServer source code tar-ball exists:
47
48			tar -zxf mapserver-4.2.0.tar.gz
49
50			Go to the new created directory:
51
52			cd mapserver-4.2.0
53
54			Configure an make the UMN MapServer
55
56			./configure --with-gdal --with-proj
57			make
58
59			Now we can compile and install the python mapscript
60
61			cd mapscript/python/
62			python setup.py build
63
64	jschuengel	2248	Some warnings are ok during the build of python mapscript
65	jschuengel	2241
66			At last we musst install mapscript as root.
67
68			python setup.py install
69
70			2. Add the umn_mapserver extension import statement to ~/.thuban/thubanstart.py
71			if you run thuban directly from the source directory the statement is:
72
73			import Extensions.umn_mapserver.mf_import
74
75			More about how to use an extension
76			see README in thuban/Examples/simple_extensions.
77
78			3. Start Thuban and use the extension.
79
80
81
82			Usage
83			--------------------
84
85			The usage of the extension is very intuitive, so you will see what you can do
86			while you are using the extension ;)
Name	Value
svn:eol-style	native
svn:keywords	Author Date Id Revision