[mapserver-commits] r11998 - branches/branch-6-0/docs/en
trunk/docs/en
svn at osgeo.org
svn at osgeo.org
Fri Aug 5 04:26:25 EDT 2011
Author: havatv
Date: 2011-08-05 01:26:25 -0700 (Fri, 05 Aug 2011)
New Revision: 11998
Modified:
branches/branch-6-0/docs/en/introduction.txt
trunk/docs/en/introduction.txt
Log:
Reduced line lengths to below 80 by breaking lines - introduction
Modified: branches/branch-6-0/docs/en/introduction.txt
===================================================================
--- branches/branch-6-0/docs/en/introduction.txt 2011-08-05 08:12:14 UTC (rev 11997)
+++ branches/branch-6-0/docs/en/introduction.txt 2011-08-05 08:26:25 UTC (rev 11998)
@@ -21,8 +21,9 @@
MapServer Overview
-------------------------------------------------------------------------------
-MapServer is a popular Open Source project whose purpose is to display dynamic
-spatial maps over the Internet. Some of its major features include:
+MapServer is a popular Open Source project whose purpose is to display
+dynamic spatial maps over the Internet. Some of its major features
+include:
* support for display and querying of hundreds of raster, vector, and database
formats
@@ -89,18 +90,20 @@
supported, this is discussed further below in `Adding data to your site`_.
.. seealso::
- :ref:`Vector Input Reference <vector>` and :ref:`Raster Input Reference <raster>`
+ :ref:`Vector Input Reference <vector>` and :ref:`Raster Input
+ Reference <raster>`
* **HTML Pages** - the interface between the user and MapServer .
- They normally sit in Web root. In it's simplest form, MapServer can be called
- to place a static map image on a html page. To make the map interactive,
- the image is placed in an html form on a page.
+ They normally sit in Web root. In it's simplest form, MapServer can
+ be called to place a static map image on a html page. To make the
+ map interactive, the image is placed in an html form on a page.
- :term:`CGI` programs are 'stateless', every request they get is new and they don't
- remember anything about the last time that they were hit by your application.
- For this reason, every time your application sends a request to MapServer,
- it needs to pass context information (what layers are on, where you are on
- the map, application mode, etc.) in hidden form variables or URL variables.
+ :term:`CGI` programs are 'stateless', every request they get is new
+ and they don't remember anything about the last time that they were
+ hit by your application. For this reason, every time your
+ application sends a request to MapServer, it needs to pass context
+ information (what layers are on, where you are on the map,
+ application mode, etc.) in hidden form variables or URL variables.
A simple MapServer :ref:`cgi` application may include two html pages:
@@ -109,13 +112,14 @@
on another page or be replaced by passing the initialization information
as variables in a URL.
- * **Template File** - controls how the maps and legends output by MapServer
- will appear in the browser. By referencing MapServer CGI variables in the
- template html, you allow MapServer to populate them with values related to
- the current state of your application (e.g. map image name, reference image
- name, map extent, etc.) as it creates the html page for the browser to read.
- The template also determines how the user can interact with the MapServer
- application (browse, zoom, pan, query).
+ * **Template File** - controls how the maps and legends output by
+ MapServer will appear in the browser. By referencing MapServer
+ CGI variables in the template html, you allow MapServer to
+ populate them with values related to the current state of your
+ application (e.g. map image name, reference image name, map
+ extent, etc.) as it creates the html page for the browser to
+ read. The template also determines how the user can interact with
+ the MapServer application (browse, zoom, pan, query).
.. seealso::
:ref:`template`
@@ -487,9 +491,12 @@
* defined within a :ref:`CLASS` object
-* the `LABELITEM` parameters in the :ref:`LAYER` object can be used to specify an attribute in the data to be used for labeling. The label is displayed by the `FONT`, declared in the :ref:`FONTSET` file (set in the :ref:`MAP` object). The :ref:`FONTSET` file contains references to the available font names.
-`ENCODING` describes which encoding is used in the file (see
-:ref:`LABELENCODING`).
+* the `LABELITEM` parameters in the :ref:`LAYER` object can be used to
+specify an attribute in the data to be used for labeling. The label
+is displayed by the `FONT`, declared in the :ref:`FONTSET` file (set
+in the :ref:`MAP` object). The :ref:`FONTSET` file contains
+references to the available font names. `ENCODING` describes which
+encoding is used in the file (see :ref:`LABELENCODING`).
An example :ref:`LABEL` object that references one of the above fonts might
look like:
@@ -556,7 +563,8 @@
always relative to the main .map file.
Here are some potential uses:
-* :ref:`LAYER` s can be stored in files and included to any number of applications
+* :ref:`LAYER` s can be stored in files and included to any number of
+ applications
* :ref:`STYLE` s can also be stored and included in multiple applications
The following is an example of using mapfile :ref:`includes
@@ -631,12 +639,14 @@
Get Demo Running
...............................................................................
-Download the `MapServer Demo <http://maps.dnr.state.mn.us/mapserver_demos/workshop-5.0.zip>`__.
-UnZip it and follow the directions in ReadMe.txt. You will need to move the
-demo files to their appropriate locations on your HTTP server, and modify the
-Map File and html pages to reflect the paths and URLs of your server. Next,
-point your browser to init.html and hit the 'initialize button'. If you get
-errors, verify that you have correctly modified the demo files.
+Download the `MapServer Demo
+<http://maps.dnr.state.mn.us/mapserver_demos/workshop-5.0.zip>`__.
+UnZip it and follow the directions in ReadMe.txt. You will need to
+move the demo files to their appropriate locations on your HTTP
+server, and modify the Map File and html pages to reflect the paths
+and URLs of your server. Next, point your browser to init.html and
+hit the 'initialize button'. If you get errors, verify that you have
+correctly modified the demo files.
Making the Site Your Own
-------------------------------------------------------------------------------
@@ -646,12 +656,12 @@
geographic data layers. (You will probably want to delete the existing layers
or set their status to OFF.)
-Unless you are adding layers that fall within the same geographic area as the
-demo, modify :ref:`MAP` EXTENT
-to match the extent of your data. To determine the extent of your data, you can
-use `ogrinfo <http://www.gdal.org/ogrinfo.html>`__.
-If you have access to a GIS, you could use that as well. The :ref:`MAP` EXTENT needs to
-be in the units of your output projection.
+Unless you are adding layers that fall within the same geographic area
+as the demo, modify :ref:`MAP` EXTENT to match the extent of your
+data. To determine the extent of your data, you can use `ogrinfo
+<http://www.gdal.org/ogrinfo.html>`__. If you have access to a GIS,
+you could use that as well. The :ref:`MAP` EXTENT needs to be in the
+units of your output projection.
If you add geographic data layers of different projections, you will need to
modify your Map File to add a :ref:`PROJECTION` block to the :ref:`map`
@@ -671,11 +681,11 @@
support spatially enabled databases such as
`PostgreSQL-PostGIS <http://postgis.refractions.net/>`__,
`Geography Markup Language (GML) <http://en.wikipedia.org/wiki/Geography_Markup_Language>`__,
-`MapInfo <http://www.mapinfo.com/>`__, delimited text files, and more formats with
-:ref:`ogr`.
+`MapInfo <http://www.mapinfo.com/>`__, delimited text files, and more
+formats with :ref:`ogr`.
-See the :ref:`Vector Data reference <vector>` for examples on how to add different
-geographic data sources to your MapServer project.
+See the :ref:`Vector Data reference <vector>` for examples on how to
+add different geographic data sources to your MapServer project.
Raster Data
...............................................................................
@@ -804,7 +814,8 @@
Documentation
...............................................................................
-* Official MapServer documentation lives here on this :ref:`site <documentation>`.
+* Official MapServer documentation lives here on this :ref:`site
+ <documentation>`.
* User contributed documentation exists on the MapServer `Wiki
<http://trac.osgeo.org/mapserver/wiki/>`__.
@@ -841,19 +852,37 @@
Tutorial
...............................................................................
-Perry Nacionales built a great `Tutorial <http://hypnos.cbs.umn.edu/tutorial/>`__ on how to build a MapServer application. You are invited to extend the collection of examples if you see cases that are missing.
+Perry Nacionales built a great `Tutorial
+<http://hypnos.cbs.umn.edu/tutorial/>`__ on how to build a MapServer
+application. You are invited to extend the collection of examples if
+you see cases that are missing.
Test Suite
...............................................................................
-Download the `MapServer Test Suite <http://noah.dnr.state.mn.us/mapserver_demos/tests46/>`__
-for a demonstration of some MapServer functionality.
+Download the `MapServer Test Suite
+<http://noah.dnr.state.mn.us/mapserver_demos/tests46/>`__ for a
+demonstration of some MapServer functionality.
Books
...............................................................................
-`Web Mapping Illustrated <http://www.oreilly.com/catalog/webmapping/>`__ , a new book by Tyler Mitchell that describes well and provides real-world examples for the use of Web mapping concepts, Open Source GIS software, MapServer, Web services, and PostGIS.
+`Web Mapping Illustrated
+<http://www.oreilly.com/catalog/webmapping/>`__\, a book by Tyler
+Mitchell that describes well and provides real-world examples for the
+use of Web mapping concepts, Open Source GIS software, MapServer, Web
+services, and PostGIS.
-`Mapping Hacks <http://www.oreilly.com/catalog/mappinghks/>`__ , by Schuyler Erle, Rich Gibson, and Jo Walsh, creatively demonstrates digital mapping tools and concepts. MapServer only appears in a handful of the 100 hacks, but many more are useful for concepts and inspiration.
+`Mapping Hacks <http://www.oreilly.com/catalog/mappinghks/>`__\, by
+Schuyler Erle, Rich Gibson, and Jo Walsh, creatively demonstrates
+digital mapping tools and concepts. MapServer only appears in a
+handful of the 100 hacks, but many more are useful for concepts and
+inspiration.
-`Beginning MapServer: Opensource GIS Development <http://www.apress.com/book/bookDisplay.html?bID=443>`__ , by Bill Kropla, is a new book focusing on MapServer. So new, I haven't seen it yet. According to the publisher, it covers installation and configuration, basic MapServer topics and features, incorporation of dynamic data, advanced topics, MapScript, and the creation of an actual application.
+`Beginning MapServer: Opensource GIS Development
+<http://www.apress.com/book/bookDisplay.html?bID=443>`__\, by Bill
+Kropla, is a new book focusing on MapServer. So new, I haven't seen
+it yet. According to the publisher, it covers installation and
+configuration, basic MapServer topics and features, incorporation of
+dynamic data, advanced topics, MapScript, and the creation of an
+actual application.
Modified: trunk/docs/en/introduction.txt
===================================================================
--- trunk/docs/en/introduction.txt 2011-08-05 08:12:14 UTC (rev 11997)
+++ trunk/docs/en/introduction.txt 2011-08-05 08:26:25 UTC (rev 11998)
@@ -21,8 +21,9 @@
MapServer Overview
-------------------------------------------------------------------------------
-MapServer is a popular Open Source project whose purpose is to display dynamic
-spatial maps over the Internet. Some of its major features include:
+MapServer is a popular Open Source project whose purpose is to display
+dynamic spatial maps over the Internet. Some of its major features
+include:
* support for display and querying of hundreds of raster, vector, and database
formats
@@ -89,18 +90,20 @@
supported, this is discussed further below in `Adding data to your site`_.
.. seealso::
- :ref:`Vector Input Reference <vector>` and :ref:`Raster Input Reference <raster>`
+ :ref:`Vector Input Reference <vector>` and :ref:`Raster Input
+ Reference <raster>`
* **HTML Pages** - the interface between the user and MapServer .
- They normally sit in Web root. In it's simplest form, MapServer can be called
- to place a static map image on a html page. To make the map interactive,
- the image is placed in an html form on a page.
+ They normally sit in Web root. In it's simplest form, MapServer can
+ be called to place a static map image on a html page. To make the
+ map interactive, the image is placed in an html form on a page.
- :term:`CGI` programs are 'stateless', every request they get is new and they don't
- remember anything about the last time that they were hit by your application.
- For this reason, every time your application sends a request to MapServer,
- it needs to pass context information (what layers are on, where you are on
- the map, application mode, etc.) in hidden form variables or URL variables.
+ :term:`CGI` programs are 'stateless', every request they get is new
+ and they don't remember anything about the last time that they were
+ hit by your application. For this reason, every time your
+ application sends a request to MapServer, it needs to pass context
+ information (what layers are on, where you are on the map,
+ application mode, etc.) in hidden form variables or URL variables.
A simple MapServer :ref:`cgi` application may include two html pages:
@@ -109,13 +112,14 @@
on another page or be replaced by passing the initialization information
as variables in a URL.
- * **Template File** - controls how the maps and legends output by MapServer
- will appear in the browser. By referencing MapServer CGI variables in the
- template html, you allow MapServer to populate them with values related to
- the current state of your application (e.g. map image name, reference image
- name, map extent, etc.) as it creates the html page for the browser to read.
- The template also determines how the user can interact with the MapServer
- application (browse, zoom, pan, query).
+ * **Template File** - controls how the maps and legends output by
+ MapServer will appear in the browser. By referencing MapServer
+ CGI variables in the template html, you allow MapServer to
+ populate them with values related to the current state of your
+ application (e.g. map image name, reference image name, map
+ extent, etc.) as it creates the html page for the browser to
+ read. The template also determines how the user can interact with
+ the MapServer application (browse, zoom, pan, query).
.. seealso::
:ref:`template`
@@ -487,9 +491,12 @@
* defined within a :ref:`CLASS` object
-* the `LABELITEM` parameters in the :ref:`LAYER` object can be used to specify an attribute in the data to be used for labeling. The label is displayed by the `FONT`, declared in the :ref:`FONTSET` file (set in the :ref:`MAP` object). The :ref:`FONTSET` file contains references to the available font names.
-`ENCODING` describes which encoding is used in the file (see
-:ref:`LABELENCODING`).
+* the `LABELITEM` parameters in the :ref:`LAYER` object can be used to
+specify an attribute in the data to be used for labeling. The label
+is displayed by the `FONT`, declared in the :ref:`FONTSET` file (set
+in the :ref:`MAP` object). The :ref:`FONTSET` file contains
+references to the available font names. `ENCODING` describes which
+encoding is used in the file (see :ref:`LABELENCODING`).
An example :ref:`LABEL` object that references one of the above fonts might
look like:
@@ -556,7 +563,8 @@
always relative to the main .map file.
Here are some potential uses:
-* :ref:`LAYER` s can be stored in files and included to any number of applications
+* :ref:`LAYER` s can be stored in files and included to any number of
+ applications
* :ref:`STYLE` s can also be stored and included in multiple applications
The following is an example of using mapfile :ref:`includes
@@ -631,12 +639,14 @@
Get Demo Running
...............................................................................
-Download the `MapServer Demo <http://maps.dnr.state.mn.us/mapserver_demos/workshop-5.0.zip>`__.
-UnZip it and follow the directions in ReadMe.txt. You will need to move the
-demo files to their appropriate locations on your HTTP server, and modify the
-Map File and html pages to reflect the paths and URLs of your server. Next,
-point your browser to init.html and hit the 'initialize button'. If you get
-errors, verify that you have correctly modified the demo files.
+Download the `MapServer Demo
+<http://maps.dnr.state.mn.us/mapserver_demos/workshop-5.0.zip>`__.
+UnZip it and follow the directions in ReadMe.txt. You will need to
+move the demo files to their appropriate locations on your HTTP
+server, and modify the Map File and html pages to reflect the paths
+and URLs of your server. Next, point your browser to init.html and
+hit the 'initialize button'. If you get errors, verify that you have
+correctly modified the demo files.
Making the Site Your Own
-------------------------------------------------------------------------------
@@ -646,12 +656,12 @@
geographic data layers. (You will probably want to delete the existing layers
or set their status to OFF.)
-Unless you are adding layers that fall within the same geographic area as the
-demo, modify :ref:`MAP` EXTENT
-to match the extent of your data. To determine the extent of your data, you can
-use `ogrinfo <http://www.gdal.org/ogrinfo.html>`__.
-If you have access to a GIS, you could use that as well. The :ref:`MAP` EXTENT needs to
-be in the units of your output projection.
+Unless you are adding layers that fall within the same geographic area
+as the demo, modify :ref:`MAP` EXTENT to match the extent of your
+data. To determine the extent of your data, you can use `ogrinfo
+<http://www.gdal.org/ogrinfo.html>`__. If you have access to a GIS,
+you could use that as well. The :ref:`MAP` EXTENT needs to be in the
+units of your output projection.
If you add geographic data layers of different projections, you will need to
modify your Map File to add a :ref:`PROJECTION` block to the :ref:`map`
@@ -671,11 +681,11 @@
support spatially enabled databases such as
`PostgreSQL-PostGIS <http://postgis.refractions.net/>`__,
`Geography Markup Language (GML) <http://en.wikipedia.org/wiki/Geography_Markup_Language>`__,
-`MapInfo <http://www.mapinfo.com/>`__, delimited text files, and more formats with
-:ref:`ogr`.
+`MapInfo <http://www.mapinfo.com/>`__, delimited text files, and more
+formats with :ref:`ogr`.
-See the :ref:`Vector Data reference <vector>` for examples on how to add different
-geographic data sources to your MapServer project.
+See the :ref:`Vector Data reference <vector>` for examples on how to
+add different geographic data sources to your MapServer project.
Raster Data
...............................................................................
@@ -804,7 +814,8 @@
Documentation
...............................................................................
-* Official MapServer documentation lives here on this :ref:`site <documentation>`.
+* Official MapServer documentation lives here on this :ref:`site
+ <documentation>`.
* User contributed documentation exists on the MapServer `Wiki
<http://trac.osgeo.org/mapserver/wiki/>`__.
@@ -841,19 +852,37 @@
Tutorial
...............................................................................
-Perry Nacionales built a great `Tutorial <http://hypnos.cbs.umn.edu/tutorial/>`__ on how to build a MapServer application. You are invited to extend the collection of examples if you see cases that are missing.
+Perry Nacionales built a great `Tutorial
+<http://hypnos.cbs.umn.edu/tutorial/>`__ on how to build a MapServer
+application. You are invited to extend the collection of examples if
+you see cases that are missing.
Test Suite
...............................................................................
-Download the `MapServer Test Suite <http://noah.dnr.state.mn.us/mapserver_demos/tests46/>`__
-for a demonstration of some MapServer functionality.
+Download the `MapServer Test Suite
+<http://noah.dnr.state.mn.us/mapserver_demos/tests46/>`__ for a
+demonstration of some MapServer functionality.
Books
...............................................................................
-`Web Mapping Illustrated <http://www.oreilly.com/catalog/webmapping/>`__ , a new book by Tyler Mitchell that describes well and provides real-world examples for the use of Web mapping concepts, Open Source GIS software, MapServer, Web services, and PostGIS.
+`Web Mapping Illustrated
+<http://www.oreilly.com/catalog/webmapping/>`__\, a book by Tyler
+Mitchell that describes well and provides real-world examples for the
+use of Web mapping concepts, Open Source GIS software, MapServer, Web
+services, and PostGIS.
-`Mapping Hacks <http://www.oreilly.com/catalog/mappinghks/>`__ , by Schuyler Erle, Rich Gibson, and Jo Walsh, creatively demonstrates digital mapping tools and concepts. MapServer only appears in a handful of the 100 hacks, but many more are useful for concepts and inspiration.
+`Mapping Hacks <http://www.oreilly.com/catalog/mappinghks/>`__\, by
+Schuyler Erle, Rich Gibson, and Jo Walsh, creatively demonstrates
+digital mapping tools and concepts. MapServer only appears in a
+handful of the 100 hacks, but many more are useful for concepts and
+inspiration.
-`Beginning MapServer: Opensource GIS Development <http://www.apress.com/book/bookDisplay.html?bID=443>`__ , by Bill Kropla, is a new book focusing on MapServer. So new, I haven't seen it yet. According to the publisher, it covers installation and configuration, basic MapServer topics and features, incorporation of dynamic data, advanced topics, MapScript, and the creation of an actual application.
+`Beginning MapServer: Opensource GIS Development
+<http://www.apress.com/book/bookDisplay.html?bID=443>`__\, by Bill
+Kropla, is a new book focusing on MapServer. So new, I haven't seen
+it yet. According to the publisher, it covers installation and
+configuration, basic MapServer topics and features, incorporation of
+dynamic data, advanced topics, MapScript, and the creation of an
+actual application.
More information about the mapserver-commits
mailing list