[Commits] r692 - in sandbox/docsrc: . advanced primers tutorials
commits at geoext.org
commits at geoext.org
Tue May 12 22:45:55 CEST 2009
Author: dwins
Date: 2009-05-12 22:45:55 +0200 (Tue, 12 May 2009)
New Revision: 692
Added:
sandbox/docsrc/advanced/
sandbox/docsrc/advanced/custom-theming.rst
sandbox/docsrc/advanced/geoext-extensions.rst
sandbox/docsrc/advanced/index.rst
sandbox/docsrc/advanced/production-deployment.rst
Modified:
sandbox/docsrc/docs.rst
sandbox/docsrc/downloads.rst
sandbox/docsrc/primers/index.rst
sandbox/docsrc/tutorials/control-button-tutorial.rst
sandbox/docsrc/tutorials/index.rst
sandbox/docsrc/tutorials/mappanel-tutorial.rst
sandbox/docsrc/tutorials/quickstart.rst
Log:
Continue reorg
Added: sandbox/docsrc/advanced/custom-theming.rst
===================================================================
--- sandbox/docsrc/advanced/custom-theming.rst (rev 0)
+++ sandbox/docsrc/advanced/custom-theming.rst 2009-05-12 20:45:55 UTC (rev 692)
@@ -0,0 +1,5 @@
+==============
+Custom Theming
+==============
+
+You can theme GeoExt!
Added: sandbox/docsrc/advanced/geoext-extensions.rst
===================================================================
--- sandbox/docsrc/advanced/geoext-extensions.rst (rev 0)
+++ sandbox/docsrc/advanced/geoext-extensions.rst 2009-05-12 20:45:55 UTC (rev 692)
@@ -0,0 +1,5 @@
+================
+Extending GeoExt
+================
+
+You can extend GeoExt!
Added: sandbox/docsrc/advanced/index.rst
===================================================================
--- sandbox/docsrc/advanced/index.rst (rev 0)
+++ sandbox/docsrc/advanced/index.rst 2009-05-12 20:45:55 UTC (rev 692)
@@ -0,0 +1,12 @@
+===============
+Advanced Topics
+===============
+
+To get the most out of GeoExt, you can tune it to your specific situation and theme it to integrate with your site. Topics of interest include:
+
+.. toctree::
+ :maxdepth: 2
+
+ production-deployment
+ custom-theming
+ geoext-extensions
Added: sandbox/docsrc/advanced/production-deployment.rst
===================================================================
--- sandbox/docsrc/advanced/production-deployment.rst (rev 0)
+++ sandbox/docsrc/advanced/production-deployment.rst 2009-05-12 20:45:55 UTC (rev 692)
@@ -0,0 +1,5 @@
+=====================
+Production Deployment
+=====================
+
+You can deploy GeoExt in production!
Modified: sandbox/docsrc/docs.rst
===================================================================
--- sandbox/docsrc/docs.rst 2009-05-12 19:55:16 UTC (rev 691)
+++ sandbox/docsrc/docs.rst 2009-05-12 20:45:55 UTC (rev 692)
@@ -2,16 +2,13 @@
Documentation
===============
-Tutorials
+Getting Started
---------
-Explore the :doc:`tutorials <tutorials/index>` to learn more about how
-to do you what want with GeoExt.
+* **Jump in** with :doc:`tutorials/index` to get you up and running
+* **Ramp up** with :doc:`primers/index` to learn the core concepts behind GeoExt
+* **Dig deeper** with :doc:`advanced/index` to leverage the full power of GeoExt
-* Jump in: :doc:`tutorials/quickstart`
-* Ramp up: :ref:`core-concepts`
-* In depth for the more advanced: :ref:`advanced-concepts`
-
.. toctree::
:hidden:
@@ -21,18 +18,17 @@
Examples
--------
-* `Feature Grid <./examples/feature-grid.html>`_
+* Using a `Feature Grid <./examples/feature-grid.html>`_ to display geospatial data in a tabular format
-* `Map Panel <./examples/mappanel.html>`_
+* Using a `Map Panel <./examples/mappanel.html>`_ to embed an interactive map in a web page
-* `Popups <./examples/popup.html>`_
+* Using `Popups <./examples/popup.html>`_ to provide more detailed information about features on a map
-* `WMS Capabilities <./examples/wms-capabilities.html>`_
+* Using `WMS Capabilities <./examples/wms-capabilities.html>`_ to find the available layers from a web mapping service.
-* `Zoom Chooser <./examples/wms-capabilities>`_
+* Using a `Zoom Chooser <./examples/wms-capabilities>`_ to help users navigate the map.
-
Library Reference
-----------------
@@ -45,11 +41,10 @@
lib/index
-GeoExt Developer Documentation
-------------------------------
+Participating in the GeoExt Community
+-------------------------------------
-How GeoExt is developed, style guide, information about the community
-and how to get involved.
+GeoExt is an Open Source project, and anyone can be a part. If you want to get involved, keep reading!
.. toctree:
Modified: sandbox/docsrc/downloads.rst
===================================================================
--- sandbox/docsrc/downloads.rst 2009-05-12 19:55:16 UTC (rev 691)
+++ sandbox/docsrc/downloads.rst 2009-05-12 20:45:55 UTC (rev 692)
@@ -4,5 +4,5 @@
Since GeoExt is still in a pre-release state, no minified build is available. You can still get the development version using svn::
- svn export http://svn.geoext.org/core/trunk/geoext/lib/ GeoExt/
+ svn export http://svn.geoext.org/core/trunk/geoext/ GeoExt/
Modified: sandbox/docsrc/primers/index.rst
===================================================================
--- sandbox/docsrc/primers/index.rst 2009-05-12 19:55:16 UTC (rev 691)
+++ sandbox/docsrc/primers/index.rst 2009-05-12 20:45:55 UTC (rev 692)
@@ -2,8 +2,30 @@
Core Concepts
=============
+:doc:`ext-primer`
+=================
+
.. toctree::
:maxdepth: 2
+ :hidden:
ext-primer
+
+Pointers on getting started with ExtJS with an emphasis on important concepts in GeoExt derived from ExtJS.
+
+- :ref:`ext-basic-layout` (put panels in a viewport)
+- :ref:`ext-trees`
+- :ref:`ext-grid-store` (records from reader)
+- :ref:`ext-events` in Ext from a GeoExt perspective
+
+:doc:`openlayers-primer`
+========================
+
+.. toctree::
+ :maxdepth: 2
+ :hidden:
+
openlayers-primer
+
+Essential OpenLayers concepts for working with GeoExt.
+
Modified: sandbox/docsrc/tutorials/control-button-tutorial.rst
===================================================================
--- sandbox/docsrc/tutorials/control-button-tutorial.rst 2009-05-12 19:55:16 UTC (rev 691)
+++ sandbox/docsrc/tutorials/control-button-tutorial.rst 2009-05-12 20:45:55 UTC (rev 692)
@@ -6,7 +6,7 @@
Okay, so now you know how to :doc:`add a map to a web page <mappanel-tutorial>` and load some data into it. Your users can drag and zoom to their hearts' content. You even followed the :doc:`layertree-tutorial` so they could switch between different datasets. (You did follow that tutorial, right?) But now you want to do more than just view some pretty pictures. You want to let your users analyze data, or get more info about particular features on your map, or just draw things. Basically, you want to give them some **tools**\ .
-.. note:: This tutorial makes heavy use of the OpenLayers mapping library. If you're not familiar with it, you might want to take a look at the :doc:`openlayers-primer` before moving forward.
+.. note:: This tutorial makes heavy use of the OpenLayers mapping library. If you're not familiar with it, you might want to take a look at the :doc:`/primers/openlayers-primer` before moving forward.
OpenLayers Controls
===================
@@ -98,3 +98,4 @@
}
});
+All right, you've got all you need to add and activate tools to help users get the most out of your maps.
Modified: sandbox/docsrc/tutorials/index.rst
===================================================================
--- sandbox/docsrc/tutorials/index.rst 2009-05-12 19:55:16 UTC (rev 691)
+++ sandbox/docsrc/tutorials/index.rst 2009-05-12 20:45:55 UTC (rev 692)
@@ -10,42 +10,9 @@
.. toctree::
quickstart
-
-.. _core-concepts:
-Core Concepts
-=============
-
-Primer: Ext
------------
-
-Pointers on getting started w/ Ext with an emphasis on
-important concepts in GeoExt derived from Ext. :doc:`start tutorial<ext-primer>`.
-
-- :ref:`ext-basic-layout` (put panels in a viewport)
-- :ref:`ext-trees`
-- :ref:`ext-grid-store` (records from reader)
-- :ref:`ext-events` in Ext from a GeoExt perspective
-
-.. toctree::
- :hidden:
-
- ext-primer
-
-
-Primer: OpenLayers
-------------------
-
-Essential OpenLayers concepts for use in GeoExt
-
-.. toctree::
- :maxdepth: 2
-
- openlayers-primer
-
-
Map in a Panel
---------------
+==============
GeoExt.MapPanel, dissected.
@@ -56,7 +23,7 @@
Layer Tree and Map Panel
-------------------------
+========================
Working with OpenLayers layers and the Ext TreePanel
@@ -67,7 +34,7 @@
Configuring map tools
----------------------
+=====================
Working with OpenLayers Controls and Ext Button to create elements for
user interaction.
@@ -78,7 +45,7 @@
control-button-tutorial
Remote features
----------------
+===============
Fetching features and displaying in grid. Covers working OpenLayers
Vector Feature with Ext Store and Grid
Modified: sandbox/docsrc/tutorials/mappanel-tutorial.rst
===================================================================
--- sandbox/docsrc/tutorials/mappanel-tutorial.rst 2009-05-12 19:55:16 UTC (rev 691)
+++ sandbox/docsrc/tutorials/mappanel-tutorial.rst 2009-05-12 20:45:55 UTC (rev 692)
@@ -1,3 +1,5 @@
+.. highlight:: javascript
+
============================
``MapPanel`` Tutorial
============================
@@ -9,11 +11,7 @@
A Basic MapPanel
================
-Taking a look at the example code from the quickstart tutorial, we can see a very basic map configuration:
-
- .. code-block::
- javascript
- :linenos:
+Taking a look at the example code from the quickstart tutorial, we can see a very basic map configuration::
var map = new OpenLayers.Map();
var layer = new OpenLayers.Layer.WMS(
@@ -65,6 +63,13 @@
columns: [{name: 'name', heading: 'Name'}]
});
+.. highlight:: html
+
+
+In the HTML, you'll need to add a ``div`` for the grid panel to render itself in::
+
+ <div id='layerlist'></div>
+
More information on the :class:`Ext.grid.GridPanel` is available from the `ExtJS API documentation <http://extjs.com/deploy/dev/docs/?class=Ext.grid.GridPanel>`_.
.. note:: This code is only meant as an example to demonstrate the map panel's integration with Ext. An :class:`Ext.tree.TreePanel` with :class:`GeoExt.tree.LayerNode`\ s is a a much nicer way to display the layers in a map, with optional support for hiding/showing layers and reordering. The TreePanel approach is discussed in the :doc:`layertree-tutorial`.
Modified: sandbox/docsrc/tutorials/quickstart.rst
===================================================================
--- sandbox/docsrc/tutorials/quickstart.rst 2009-05-12 19:55:16 UTC (rev 691)
+++ sandbox/docsrc/tutorials/quickstart.rst 2009-05-12 20:45:55 UTC (rev 692)
@@ -125,6 +125,7 @@
</body>
</html>
+And that's it! You now have all of GeoExt, ready to bring your geospatial data to life. Go forth and prosper!
Going Further
=============
More information about the Commits
mailing list