Skip to content
This repository has been archived by the owner on Oct 23, 2020. It is now read-only.

Showcase for the use of geographical coordinates in the frontend of Deutsche Digitale Bibliothek

License

Notifications You must be signed in to change notification settings

Deutsche-Digitale-Bibliothek/ddblabs-mapshowcase

Repository files navigation

ddb map-showcase

API showcase for a map-based search

Requirements

  • Python (2.7.x)
  • Python Setuptools
  • Python Virtualenv (optional)
  • PostgreSQL Server (9.x)
  • Postgis (2.x)
  • BASH-like Shell env

Getting started

  • create a new postgis-enabled database on your Postgres server
  • (optional) transform the GeoJSON file (assets/database.json) to SQL (using GDAL/ogr2ogr)
  • import the generated or sample SQL (database-sample.sql) into the new database
  • create a python virtual environment
    • virtualenv $venvpath
  • $venvpath/bin/pip install <directory containing this file>
  • edit the $configfile (development.ini/production.ini)
    • change your sqlalchemy.url parameter to match you local DB environment
    • enter your DDB API OAuthkey
    • change logging options
    • change nominatim service url
    • change nominatim service contactadress (email)
  • serve your new ddb application via a WSGI server (e.g. apache+mod_wsgi or waitress via pserve script)
    • $venvpath/bin/pserve $configfile

Documentation

The documentation for this project is served as ReStructered textfiles. They have to be processed by sphinx to get the HTML rendered version and code documentation from docstrings. Since sphinx is already install as a dependency, you need to load your virtualenv and call make.

  • source $venvpath/bin/activate
  • cd docs
  • make clean && make html

The resulting documentation is located at: doc/_build/html/index.html

Links

About

Showcase for the use of geographical coordinates in the frontend of Deutsche Digitale Bibliothek

Resources

License

Stars

Watchers

Forks

Packages

No packages published