This Kiezatlas software described here is currently live at kiezatlas.berlin
Just contact me if you need more information on how to use or setup a Kiezatlas on your own.
Webpages on the Kiezatlas Website documenting the functionality or usage of the Kiezatlas can be found on the Kiezatlas website, e.g. Kiezatlas Orte API, Workshop-Agenda für Bezirksregionen/StadtteilkoordinatorInnen, Kiezatlas 2.0 Eigenschaften, Nutzerrollen im Kiezatlas.
Reporting Issues
If you experience any errors or want to give us some user feedback on the Kiezatlas web application please write an email to support@kiezatlas.de or create an Issue on github.com.
Software Overview
The Kiezatlas 2 web application is a DeepaMehta 4 Plugin (built on Apache Lucene, Neo4J and Jetty among others) and the module composing the new Kiezatlas Website through integrating the following applications and plugins. It builds on and our work of last year, especially on the
- dm4-kiezatlas module
- dm4-kiezatlas-etl module
- dm4-kiezatlas-angebote module
- dm4-kiezatlas-comments module
- dm4-geospatial module
- dm4-images module
- dm4-webpages module
- dm4-sign-up module
- dm4-thymeleaf module
It also builds on other open source software, such as
- jQuery
- jQueryUI
- SemanticUI CSS
- LeafletJS
- and on the Tile Map Service of www.mapbox.com.
Usage & Development
If you want to adapt this software make sure to have your development environment set up like described in the DeepaMehta Plugin Development Guide.
To install and setup hot-deployment for this plugin when having just downloaded and unzipped deepamehta, you could, for example configure your deepamehta bundle directory in the pom.xml
of this plugin. Therefore add a dm4.deploy.dir
path as a property to the pom.xml
in this directory. For example:
<properties>
<dm4.deploy.dir>/home/oscar/deepamehta-4.8.3/bundle-deploy</dm4.deploy.dir>
</properties>
To build the dm4-kiezatlas-website module successfully you'll need to build or install its dependencies into your local maven repository. This is due to the fact that we did not have the time to publish these bundles on maven central.
To do so, check out the following plugins source code from github and run mvn clean install
in all of them: dm4-kiezatlas, dm4-kiezatlas-etl, dm4-geospatial, dm4-thymeleaf, dm4-images, dm4-kiezatlas-angebote, dm4-webpages and dm4-sign-up.
After you have done that you can build and hot-deploy the sources of the dm4-kiezatlas-website plugin using the following two commands:
grunt
mvn clean package
Grunt here is used to concat and minify some of the javascript sources as well as our custom selection of semantic-ui css components. Maven compiles the java sources and builds the plugin as an OSGi bundle.
License
Thise source code is licensed under the GNU GPL 3.0. It comes with no warranty.