[Geotools-commits] CVS: website/help enduser.html,1.1.1.1,1.2

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 422-6466

Update of /cvsroot/geotools/website/help
In directory usw-pr-cvs1:/tmp/cvs-serv12149

Modified Files:
	enduser.html 
Log Message:
Spelling and grammar checked (loxnard)

Index: enduser.html
===================================================================
RCS file: /cvsroot/geotools/website/help/enduser.html,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -w -C2 -d -r1.1.1.1 -r1.2
*** enduser.html	2001/11/28 22:09:54	1.1.1.1
--- enduser.html	2001/11/29 10:14:12	1.2
***************
*** 1,224 ****
! <!doctype html public "-//w3c//dtd html 4.0 transitional//en">
! <html>
! <head>
!    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
!    <meta name="GENERATOR" content="Mozilla/4.75 [en] (X11; U; Linux 2.2.16-22 i686) [Netscape]">
! </head>
! <body>

! <h1>
! Getting Started as an End User:</h1>

! <h2>
! Prerequisites:</h2>
! This document assumes no knowledge of Java or for that matter any GIS skills.
! You will, however, need at least some knowledge of HTML in order to put
! maps onto your web site.
! You will also need some map data of your own, preferably in ESRI(tm)
! Shapefile format.&nbsp; (Though you can get started with the data provided
! with the demos).
! &nbsp;
! <h2>
! Things to get:</h2>
! You should download the latest copy of the GeoTools examples and demos
! package. This comes in a file named demos.zip.&nbsp; At the time of writing
! this is version 1.1 which can be downloaded from the main GeoTools <a href="http://sourceforge.net/project/showfiles.php?group_id=4091">download
! site.</a>
! Dont worry about all of the other files that are available there for
! the moment, you will only really need them if you go on to become either
! a solution builder or a developer.
! A web browser which fully supports Java 1.1, for example Netscape 4.06
! or later, and Internet Explorer 5 or later.&nbsp; (Make sure with both
! that if you download it you include the option to include Java as many
! recent releases default to not including it)
! &nbsp;
! &nbsp;
! <h2>
! Trying the examples:</h2>
! Hopefully you now have a copy of demos.zip and a Java enabled web browser, 
! so let's run quickly through getting the demos running.
! First, unpack the zip archive using your favourite archive tool.&nbsp;
! If you have no access to any tool on your operating system for dealing
! with zip files then submit a <a href="http://sourceforge.net/tracker/?group_id=4091">support
! request </a>and we will look at getting the files to you in another format.
! Once you have unpacked it you should have a file called readme.html
! and a directory called demonstrations.
! Open the readme.html file in your browser and click on view under Example
! 1, this will open one of the pages in the demonstrations folder which,
! after a short pause, should display a fairly plain map of the US.
! If the map fails to appear then take a look at the<a href="#trouble">
! trouble shooting</a> section at the end of this page.
! Assuming that you have got a map on the screen then try using the three
! buttons at the bottom of the map.
! Click on the zoom button and then drag a box out on a part of the map.
! The map will zoom in to the area you selected.&nbsp; Click the pan button
! and then click and hold the left mouse button over the map to drag the
! map around.&nbsp; Finally, click the reset button to return the view to one
! showing the whole of the US.
! You can go back to the readme.html page and try some of the other examples
! if you want to see some more examples of GeoTools in action.
! &nbsp;
! <h2>
! Exploring the files:</h2>
! OK, so how do the above demos work and what files are being used to get
! them working?
! Each demo needs 5 files:
! <ul>
! <li>
! a html file - This holds the content of the web page and provides some
! information to the applet which will show the map.</li>

! <li>
! a class file - This controls the layout of the map and its controls.</li>

! <ul>
! <li>
! geotools.jar - The main archive which provides all of the mapping capabilities</li>

! <li>
! collections.jar - A support library written by Sun that GeoTools uses</li>

! <li>
! a zip file - This holds the map information used by the map applet</li>
! </ul>
! </ul>
! In the case of Example 1, the files that it needs are
! <p>demonstrations\Example1.html
! <br>demonstrations\Example1.class
! <br>demonstrations\jars\geotools.jar
! <br>demonstrations\jars\collections.jar
! <br>demonstrations\maps\statepop.zip
! <p>Taking a look at each file in turn, the first is the web page itself.&nbsp;
! If you open it up in an editor you will see that for the main part it is
! just like any other html page, the interesting part is the section marked
! out in the applet tag:
! <p>&lt;APPLET ARCHIVE="jars/geotools.jar,jars/collections.jar" CODE="Example1.class"&nbsp;
! WIDTH="430" HEIGHT="270" ALIGN="BOTTOM">
! <br>&lt;PARAM NAME="shapefile" VALUE="maps/statepop">
! <br>&lt;/APPLET>
! <p>Pulling this apart we see that it first states that an applet is to
! be used.&nbsp; The<b> archive</b> tag provides the location of the two
! support libraries - geotools.jar and collections.jar.
! <br>The <b>code</b> tag gives the name of the class file to use whilst
! the width, height and align tags say how big the applet should be.
! <p>Next there is one param tag.  This is a parameter used by the applet.  
! In this case it is named '<b>shapefile'</b> and takes the value of the
! location of the map file to use.  Note that the .zip extension is not given.
! <p>Finally, the applet tag is closed and the rest of the page is just standard
! html.
! <p>The geotools.jar and collections.jar file are just library files and
! are required by every GeoTools applet.  There is nothing you need to change
! with these files.
! <p>If you open the statepop.zip file using an archive tool you will see
! that it actually contains three files, a .shp, a .shx and a .dbf file.&nbsp;
! GeoTools only needs the .shp file and .dbf file but most shapefiles have
! all three and later versions of GeoTools may make use of the .shx file
! (which is an index) so it's good to have it available.
! <br>&nbsp;
! <h2>
! Putting your own map on the web</h2>
! Assuming that you have a shapefile of your own that you want to put onto
! a web site, how do you go about it?
! <p>Start with example 1 as this is the easiest to set up:
! <br>Make a copy of Example1.html called, say, MyMap.html
! <br>Put your shapefile files into the maps directory (you can either put
! the three separate file there or archive them into a single zip file).
! <br>Change the param tag in MyMap.html so that the value is set to the
! name and location of your shapefile
! <p>Open the html page in your browser and your map should appear.
! <p>GeoTools requires no server side support so, provided all of the files
! needed are placed onto your web site, the map should be available for all
! to see.
! <br>&nbsp;
! <h2>
! Modifying the more advanced demos</h2>
! The next three demos, example 2, 3 and 4, each introduce additional features
! to make the maps more interesting.
! <br>Example 2 adds one more parameter which allows the map to show tooltips.  
! These are small boxes which pop up to provide information about the feature
! under the mouse cursor.
! <p>If you look at the applet tag for Example 2 you will see the following:
! <p>&lt;APPLET ARCHIVE="jars/geotools.jar,jars/collections.jar" CODE="Example2.class"&nbsp;
! WIDTH="430" HEIGHT="270" ALIGN="BOTTOM">
! <br>&lt;PARAM NAME="shapefile" VALUE="maps/statepop">
! <br>&lt;PARAM NAME="tooltip" VALUE="STATE_NAME">
! <br>&lt;/APPLET>
! <p>The new parameter has the name - tooltip and its value is set to the
! name of a column of data which can be found in the .dbf file, in this
! case STATE_NAME.
! <br>If you know the names of any of the columns in your maps .dbf file
! then try changing this parameter to show tooltips on your map.&nbsp; Note
! that the applet tag now has CODE set to Example2.class.  You cannot just
! go and add a tooltip param tag to the Example1 html file as that applet
! is not set up to display them.
! <p>Example 3 extends the concept in a similar way, this time the name of
! a numeric column is given and GeoTools uses thiis to shade the map in
! <p>&lt;APPLET ARCHIVE="jars/geotools.jar,jars/collections.jar" CODE="Example3.class"&nbsp;
! WIDTH="430" HEIGHT="270" ALIGN="BOTTOM">
! <br>&lt;PARAM NAME="shapefile" VALUE="maps/statepop">
! <br>&lt;PARAM NAME="shadeby" VALUE="UNEMPLOY">
! <br>&lt;PARAM NAME="tooltip" VALUE="STATE_NAME">
! <br>&lt;/APPLET>
! <p>In this case, unemployment.&nbsp; One interesting feature of this applet
! is that if you double click on the key you will be shown a box which allows
! you to change the way the shading is performed.
! <br>Again, if you know the name of a numeric column in your shapefile then
! you can edit the param tags so that your map is shaded using that data.
! <p>Example 4 doesn't add any new parameters but instead includes an additional
! control widget which makes it possible to set zoom levels.
! <p>The final demo in the package at the time of writing is the GraphApplet
! demo which shows some of the more interactive capabilities of GeoTools. 
! Try taking a look at the param tags in that demo and see if you can work
! out how to use your own data in the applet.
! <br>&nbsp;
! <h2>
! Creating custom applets</h2>
! Now you may be happy with one of the applets provided as is in the demos
! package, in which case there is nothing more for you to do, just place
! the files on a web site and publish your maps.&nbsp; But what if none of
! the applets quite do what you are looking for?&nbsp; Perhaps you want to
! display more than one map layer in the viewer or perhaps you want some
! other form of interactivity, perhaps linking to a different kind of graph.&nbsp;
! If so then you have three options open to you:
! <br>First, go to the applet listings page at:
! <br><a href="http://geotools.sourceforge.net/demos.php">http://geotools.sourceforge.net/demos.php</a>
! <br>Many of these can be configured using param tags and may do what you
! need.
! <p>If none of them are appropriate then your second option is to get someone,
! possibly us, to put together a custom applet that does what you need.&nbsp;
! If you represent a wealthy corporation with a budget burning a hole in your
! pocket then you can commision us to build a custom solution.  If not, then
! one of us should be able to help you out in our spare time.
! <p>Your final option is to take the plunge and learn some Java so that
! you can put custom solutions together yourself.  If you want to do that
! then you will need to read the next getting started introduction, for <a href="solutionBuilder.html">solution
! builders.</a>
! <br>&nbsp;
! <h2>
! <a NAME="trouble"></a>Trouble shooting and getting help</h2>
! If none of the applets seem to be working for you at all then submit a
! support request to the Geotools Sourceforge web site.  Try to state what
! OS you are using and the version of the web browser you are using.&nbsp;
! If you know how, then it would also be helpful if you can send a copy of
! any messages which appear in your browser's Java console.
! <p>To submit a support request, go the the projects development home page
! at:
! <br><a href="http://sourceforge.net/projects/geotools/">http://sourceforge.net/projects/geotools/</a>
! <p>Then pick the 'support' option from the list across the top of the page.
! On the next page, choose submit.
! <br>You do not need to be a member on sourceforge to use this form.  However,
! if you are then you will be able to use the sourceforge site to track your
! request more closely.
! <p>Pick 'Getting Started' from the category list and then provide a summary
! and any other details you can think of.
! <p>If you can get some of the applets to work but are having problems with
! some aspects of them or with setting things up the way you want them then
! you have two options.  The first is to use the support request form as above,
! but giving details of what your problem is.  The second is to look at the
! geotools-discussion archive to see if your problem has come up before.  If
! not then feel free to join the list and post your query for all to pick
! over.
! <p>For details on the mailing list archive and to sign up as a subscriber
! go to <a href="http://lists.sourceforge.net/lists/listinfo/geotools-discussion">geotools-discussion</a>
! </body>
! </html>
--- 1,206 ----
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
! <HTML>

! <HEAD>
! 	<META HTTP-EQUIV="Content-Type" CONTENT="text/html;CHARSET=iso-8859-1">
! 	<META NAME="GENERATOR" Content="Visual Page 2.0 for Windows">
! 	<META NAME="Author" Content="Linda Oxnard">
! 	<TITLE>untitled</TITLE>
! </HEAD>

! <BODY>

! <H1>Getting Started as an End User:</H1>
! <H2>Prerequisites:</H2>
! This document assumes no knowledge of Java or, for that matter, any GIS skills. 
! You will, however, need at least some knowledge of HTML in order to put maps onto your web site. 
! You will also need some map data of your own, preferably in ESRI(tm) Shapefile format.&nbsp; (Though you can get
! started with the data provided with the demos). 
! &nbsp;
! <H2>Things to get:</H2>
! You should download the latest copy of the GeoTools examples and demos package. This comes in a file named demos.zip.&nbsp;
! At the time of writing, this is version 1.1 which can be downloaded from the main GeoTools <A HREF="http://sourceforge.net/project/showfiles.php?group_id=4091">download
! site.</A>

! Don't worry about all of the other files that are available there, for the moment. You will only really need
! them if you go on to become either a solution builder or a developer.

! You should also have a web browser which fully supports Java 1.1, for example Netscape 4.06 or later, and Internet
! Explorer 5 or later.&nbsp; (Make sure with both that, if you download it, you select the option to include Java,
! as many recent releases default to not including it) 
! &nbsp; 
! &nbsp;
! <H2>Trying the examples:</H2>
! Hopefully, you now have a copy of demos.zip and a Java-enabled web browser. So let's run quickly through getting
! the demos running.

! First, unpack the zip archive using your favourite archive tool.&nbsp; If you have no access to any tool on
! your operating system for dealing with zip files, then submit a <A HREF="http://sourceforge.net/tracker/?group_id=4091">support
! request </A>and we will look at getting the files to you in another format.
! 
! Once you have unpacked it, you should have a file called readme.html and a directory called 'demonstrations'.
! 
! Open the readme.html file in your browser and click on 'view' under Example 1. This will open one of the pages
! in the demonstrations folder which, after a short pause, should display a fairly plain map of the US.
! 
! If the map fails to appear, then take a look at the<A HREF="#trouble"> trouble shooting</A> section at the end
! of this page.
! 
! Assuming that you have got a map on the screen, then try using the three buttons at the bottom of the map. 
! Click on the 'zoom' button and then drag a box out on a part of the map. The map will zoom in to the area you
! selected.&nbsp; Click the 'pan' button and then click and hold the left mouse button over the map to drag the map
! around.&nbsp; Finally, click the 'reset' button to return the view to one showing the whole of the US.
! 
! You can go back to the readme.html page and try some of the other examples if you want to see some more examples
! of GeoTools in action. 
! &nbsp;
! <H2>Exploring the files:</H2>
! OK, so how do the above demos work and what files are being used to get them working? 
! Each demo needs 5 files:
! 
! <UL>
! 	<LI>an html file - This holds the content of the web page and provides some information to the applet which will
! 	show the map.
! 	<LI>a class file - This controls the layout of the map and its controls.
! 	<UL>
! 		<LI>geotools.jar - The main archive which provides all of the mapping capabilities
! 		<LI>collections.jar - A support library written by Sun that GeoTools uses
! 		<LI>a zip file - This holds the map information used by the map applet
! 	</UL>
! </UL>
! 
! In the case of Example 1, the files that it needs are:
! 
! demonstrations\Example1.html 
! demonstrations\Example1.class 
! demonstrations\jars\geotools.jar 
! demonstrations\jars\collections.jar 
! demonstrations\maps\statepop.zip
! 
! Taking a look at each file in turn, the first is the web page itself.&nbsp; If you open it up in an editor you
! will see that, for the main part, it is just like any other html page. The interesting part is the section marked
! out in the applet tag:
! 
! &lt;APPLET ARCHIVE=&quot;jars/geotools.jar,jars/collections.jar&quot; CODE=&quot;Example1.class&quot;&nbsp;
! WIDTH=&quot;430&quot; HEIGHT=&quot;270&quot; ALIGN=&quot;BOTTOM&quot;&gt; 
! &lt;PARAM NAME=&quot;shapefile&quot; VALUE=&quot;maps/statepop&quot;&gt; 
! &lt;/APPLET&gt;
! 
! Pulling this apart, we see that it first states that an applet is to be used.&nbsp; The archive tag provides
! the location of the two support libraries - geotools.jar and collections.jar. 
! The code tag gives the name of the class file to use, whilst the width, height and align
! tags say how big the applet should be.
! 
! Next there is one param tag. This is a parameter used by the applet. In this case, it is named 'shapefile'
! and takes the value of the location of the map file to use. Note that the '.zip' extension is not given.
! 
! Finally, the applet tag is closed and the rest of the page is just standard html.
! 
! The geotools.jar and collections.jar file are just library files and are required by every GeoTools applet.
! There is nothing you need to change with these files.
! 
! If you open the statepop.zip file using an archive tool, you will see that it actually contains three files:
! .shp, .shx and .dbf.&nbsp; GeoTools only needs the .shp and .dbf files but most shapefiles have all three and
! later versions of GeoTools may make use of the .shx file (which is an index), so it's good to have it available.
! 
! &nbsp;
! <H2>Putting your own map on the web</H2>
! Assuming that you have a shapefile of your own that you want to put onto a web site, how do you go about it?
! 
! Start with example 1, as this is the easiest to set up: 
! Make a copy of Example1.html called, for example, MyMap.html 
! Put your shapefile files into the maps directory (you can either put the three separate files there or archive
! them into a single .zip file). 
! Change the param tag in MyMap.html so that the value is set to the name and location of your shapefile.
! 
! Open the html page in your browser and your map should appear.
! 
! GeoTools requires no server-side support so, provided all of the files needed are placed onto your web site,
! the map should be available for all to see. 
! &nbsp;
! <H2>Modifying the more advanced demos</H2>
! The next three demos, examples 2, 3 and 4, each introduce additional features to make the maps more interesting.
! 
! Example 2 adds one more parameter which allows the map to show tooltips (these are small boxes which pop up to
! provide information about the feature under the mouse cursor).
! 
! If you look at the applet tag for Example 2, you will see the following:
! 
! &lt;APPLET ARCHIVE=&quot;jars/geotools.jar,jars/collections.jar&quot; CODE=&quot;Example2.class&quot;&nbsp;
! WIDTH=&quot;430&quot; HEIGHT=&quot;270&quot; ALIGN=&quot;BOTTOM&quot;&gt; 
! &lt;PARAM NAME=&quot;shapefile&quot; VALUE=&quot;maps/statepop&quot;&gt; 
! &lt;PARAM NAME=&quot;tooltip&quot; VALUE=&quot;STATE_NAME&quot;&gt; 
! &lt;/APPLET&gt;
! 
! The new parameter has the name tooltip and its value is set to the name of a column of data which can
! be found in the .dbf file, in this case STATE_NAME. 
! If you know the names of any of the columns in your map's .dbf file, then try changing this parameter to show tooltips
! on your map.&nbsp; Note that the applet tag now has CODE set to Example2.class. You cannot just add
! a tooltip param tag to the Example1 html file, as that applet is not set up to display them.
! 
! Example 3 extends the concept in a similar way. This time, the name of a numeric column is given and GeoTools
! uses this to shade the map in. In this case, the column UNEMPLOY is used which represents unemployment.
! 
! &lt;APPLET ARCHIVE=&quot;jars/geotools.jar,jars/collections.jar&quot; CODE=&quot;Example3.class&quot;&nbsp;
! WIDTH=&quot;430&quot; HEIGHT=&quot;270&quot; ALIGN=&quot;BOTTOM&quot;&gt; 
! &lt;PARAM NAME=&quot;shapefile&quot; VALUE=&quot;maps/statepop&quot;&gt; 
! &lt;PARAM NAME=&quot;shadeby&quot; VALUE=&quot;UNEMPLOY&quot;&gt; 
! &lt;PARAM NAME=&quot;tooltip&quot; VALUE=&quot;STATE_NAME&quot;&gt; 
! &lt;/APPLET&gt;
! 
! One interesting feature of this applet is that, if you double click on the key, you will be shown a box which
! allows you to change the way the shading is performed. 
! Again, if you know the name of a numeric column in your shapefile then you can edit the param tags so that
! your map is shaded using that data.
! 
! Example 4 doesn't add any new parameters, but instead includes an additional control widget which makes it possible
! to set zoom levels.
! 
! The final demo in the package, at the time of writing, is the GraphApplet demo which shows some of the more
! interactive capabilities of GeoTools. Try taking a look at the param tags in that demo and see if you can
! work out how to use your own data in the applet. 
! &nbsp;
! <H2>Creating custom applets</H2>
! You may be happy with one of the applets provided as is in the demos package, in which case there is nothing
! more for you to do, just place the files on a web site and publish your maps.&nbsp; But what if none of the applets
! quite do what you are looking for?&nbsp; Perhaps you want to display more than one map layer in the viewer, or
! perhaps you want some other form of interactivity, perhaps linking to a different kind of graph.&nbsp; If so, then
! you have three options open to you: 
! First, go to the applet listings page at: 
! <A HREF="http://geotools.sourceforge.net/demos.php">http://geotools.sourceforge.net/demos.php</A> 
! Many of these can be configured using param tags and may do what you need.
! 
! If none of them are appropriate, then your second option is to get someone, possibly us, to put together a custom
! applet that does what you need.&nbsp; If you represent a wealthy corporation with a budget burning a hole in your
! pocket, then you can commision us to build a custom solution. If not, then one of us should be able to help you
! out in our spare time.
! 
! Your final option is to take the plunge and learn some Java so that you can put custom solutions together yourself.
! If you want to do that, then you will need to read the next 'getting started' introduction, for <A HREF="solutionBuilder.html">solution
! builders.</A> 
! &nbsp;
! <H2><A NAME="trouble"></A>Trouble shooting and getting help</H2>
! If none of the applets seem to be working for you at all, then submit a support request to the Geotools SourceForge
! web site. Try to state what OS you are using and the version of the web browser you are using.&nbsp; If you know
! how, then it would also be helpful if you can send a copy of any messages which appear in your browser's Java console.
! 
! To submit a support request, go the the projects development home page at: 
! <A HREF="http://sourceforge.net/projects/geotools/">http://sourceforge.net/projects/geotools/</A>
! 
! Pick the 'support' option from the list across the top of the page. On the next page, choose 'submit'. 
! You do not need to be a member on SourceForge to use this form. However, if you are then you will be able to use
! the SourceForge site to track your request more closely.
! 
! Pick 'Getting Started' from the category list and then provide a summary and any other details you can think
! of.
! 
! If you can get some of the applets to work but are having problems with some aspects of them, or with setting
! things up the way you want them, then you have two options. The first is to use the support request form as above,
! but giving details of what your problem is. The second is to look at the geotools-discussion archive to see if
! your problem has come up before. If not, then feel free to join the list and post your query for all to pick over.
! 
! For details on the mailing list archive, and to sign up as a subscriber, go to <A HREF="http://lists.sourceforge.net/lists/listinfo/geotools-discussion">geotools-discussion</A>
! 
! </BODY>
! 
! </HTML>
\ No newline at end of file

[Geotools-commits] CVS: website/help enduser.html,1.1.1.1,1.2

Toolkit for working with and mapping geospatial data

[Geotools-commits] CVS: website/help enduser.html,1.1.1.1,1.2