Malawi Atlas

This repository contains the code for the Malawi Atlas web application and the GeoServer styles.

How to run:

• Clone the repository. the switch --recurse-submodules also downloads the GeoExt3 library as a git submodule.

  git clone --recurse-submodules https://github.com/ZGIS/malawi_atlas_public.git

• (if you forgot the --recurse-submodules flag, you can download the submodule like this):

  git submodule update --init --recursive

• navigate to the webapp directory:

  cd webapp

• Download the Sencha CMD commandline tool

• Download Sencha Ext JS 6.2.0 from here. Then run:

  sencha app install --framework=C:/sencha/sdks/ext-6.2.0
  
  # for development
  sencha app watch
  
  # for building the website
  sencha app build

Tested with Sencha Cmd v6.6 and Ext JS 6.2 (GPL).

Code Fomatting

The code of the website is formatted using the default settings of Prettier. See Makefile for the exact settings.

Code Conventions

The xtype attribute for own components shall start with ma which stand for "Malawi Atlas". This makes sure that there is no confusion with already existing xtypes.

Notes

The directory notes contains documentation and experiences.

Vector Images

The directory vector_images contains the original graphic files that can be used to create PNG files.

Changing Layers

All layers are defined in webapp/resources/config.json.

Sphinx Documenation

The folder docs contains the documentation which uses Sphinx generator. Installation on Ubuntu 18.04:

# install sphinx
pip3 install -U Sphinx

# install rtd theme
pip3 install sphinx_rtd_theme

Build HTML

# html
make html

For creating PDFs it is necessary to un-comment the latex_elements settings:

# install rinoh PDF builder
pip3 install rinohtype

# build
sphinx-build -b rinoh . _build/rinoh

The docs can directly pushed to the webserver using the push_docs.sh script.

Getting Started with Ext JS and OpenLayers

This command creates a new Ext JS application with classic mode only:

sencha \
    -sdk /PATH/TO/EXT/ext-6.2.0 \
    generate app -ext -classic \
    MalawiAtlas .

These links contain the documentation for the required libraries, components:

• OpenLayers 4.6.5
• OpenLayers 4.6.5 examples
• GeoExt 3.1
• Ext JS 6.2
• Ext JS 6.2 examples "Kitchen Sink"