GeoExt3 workshop

Learn how to use GeoExt 3 in your ExtJS applications.

Want to do the workshop?

This assumes that Node.js is installed:

• Download the latest workshop-contents from this URL:
  • https://github.com/geoext/geoext3-ws/archive/master.zip
• Extract the zip-archive into a directory of your choice.
• You should find the following files and directories in the geoext3-ws-master-folder:
  • LICENSE.md
  • package.json
  • README.md
  • src/
• Install the dependencies of the workshop via npm install.
• Start the workshop server with npm start.
• Open http://localhost:4000.

Preparation steps for OSGeo-Live

If you do not have Node.js installed (e.g. if you work on a fresh OSGeo-Live), you will need to install it. Here are some example commands you need to issue in a terminal to get everything the workshop depends upon.

First, let's install nvm (Node Version Manager) which we use to manage installations of Node.js.:

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.1/install.sh | bash

Next, please close and reopen the terminal, so that the nvm script is available.

Afterwards issue the following in the terminal to install the lates v6.x Node.js and a matching npm utility:

nvm install v6

You can now follow the instructions above.

Example steps for a Linux-system

# Create a directory gx-ws and go there …
mkdir -p ~/gx-ws && cd ~/gx-ws
# … grab the zip-archive …
wget https://github.com/geoext/geoext3-ws/archive/master.zip
# … unzip the archive …
unzip master.zip
# … change into the extracted folder
cd geoext3-ws-master
# … install dependencies via npm
npm install
# … start the workshop server
npm start

Example steps for a Windows system

The steps below can be run on a Windows machine. They have been tested on Windows 10 with PowerShell v5.1, and Visual Studio 2017.

# create a C:\gx-ws directory
$wsFolder = "C:\gx-ws"
New-Item -Path $wsFolder -ItemType Directory
# download the zip-archive
$client = New-Object System.Net.WebClient
$client.DownloadFile("https://github.com/geoext/geoext3-ws/archive/master.zip", "$wsFolder/master.zip")
# unzip the archive
Expand-Archive -Path $wsFolder/master.zip -DestinationPath $wsFolder
# install the chocolatey package manager
# if you have Visual Studio 2010+ and the Nugetextension installed you can run the
# commands below, otherwise see how to install at https://www.chocolatey.org/install
Install-Package chocolatey -Force
# now install nodejs with chocolatey
choco install nodejs -y
# change into the extracted folder
cd "$wsFolder/geoext3-ws-master"
# install dependencies via npm
npm install
# start the workshop server
npm start

If gitbook fails to install try running the following separately:

npm install gitbook-cli -g

Library Versions

During the workshop you will work with the following JavaScript libraries or frameworks:

• OpenLayers (4.6.5): http://openlayers.org/
• ExtJS (v6.2.0, GPL): https://www.sencha.com/products/extjs/
• GeoExt3 (v3.1.0): http://geoext.github.io/geoext3/

Developing instructions

For developing and enhancing the work