Table of contents

• OGT web app
  • About OGT project
  • Published contributions
• Preview
• Built with
• Getting Started
  • Install requirements
  • Setup on local system
  • Config app env
• Contributing and contact
• License

OGT web map

• OGT website

This is the repository of the OGT project's web map. The web map, based on OpenStreetMap and Leaflet, shows places of Gestapo terror and places of remembrance. Additional information can be displayed for each place and the places are linked to each other and to perpetrators and victims. Further information can be found in a glossary and visualizations of the data from Wikidata can be embedded.

The data is retrieved from Wikidata via Laravel with SPARQL. Laravel serves as a full-stack framework. The frontend was developed with Vue.js and Vuetify.

The OGT project repository is mirrored from the private TIB GitLab to public GitHub TIB Hannover.

About OGT project

The project aims both to research the activities of the Gestapo with regard to its locations and infrastructure and to make available digitally the existing knowledge about the crimes of the Gestapo and the later memory of them. A four-dimensional map, in conjunction with a Wikidata, serves to record archive, literature and other source material, evaluate it for research purposes and publish it as an interactive internet presence. The project further develops the open source prototype of the research database into a public resource that can be used and supplemented by memorials and educational institutions in Lower Saxony as well as by researchers, students and other interested parties.

• OGT @ TIB projects
• OGT @ TIB project overview
• OGT @ Wikidata:WikiProjects

Published contributions

• Zenodo – Surveillance and Terror - the Gestapo as an Instrument of the Nazi Regime (only DE)
• Zenodo – project presentation for conference "Digital Memory - Digital History - Digital Mapping. Transformations of Memory Cultures and Holocaust Education" (only DE)
• Zenodo – Excerpt from the project application (only DE)
• BuB – Library and Information Forum – Making Gestapo crimes digitally visible (only DE)
• TIB press release Traces of the past: making Gestapo crimes digitally visible

Preview

Go directly to the OGT website and try it out!

Built with

• Laravel, a free and open-source PHP web framework (repository).

• PHPUnit, a unit testing framework for PHP (repository).

• Laravel Envoy, a tool for executing common tasks to run on remote servers (repository).

• Composer, an application-level dependency manager for PHP (repository).

  • See composer.json for more information.

• Vue.js, an open-source model–view–viewmodel front end JavaScript framework (repository).

• Vuetify, a Vue UI Library (repository).

• Leaflet, a JavaScript library for mobile-friendly interactive maps (repository).

• OpenStreetMap, a free, open geographic database.

• npm, a package manager for JavaScript (repository).

  • See package.json for more information.

• Wikidata, a collaboratively edited multilingual knowledge graph.

• SPARQL, a RDF query language.

Getting Started

Instructions for setting up the project website on local system using Docker. To get a local copy up and running follow these steps.

Install requirements

Software you need to run the OGT website:

• Docker
• Docker Compose
• Git (optional, if you prefer downloading the project zip package)

Setup on local system

1. Clone the repository

   git clone https://github.com/TIBHannover/ogt-web-map.git 

   or download zip package from GitHub and unzip into a directory.

2. Build and start Docker containers

   cd ogt-api/
   cp .env.example .env
   docker compose -f compose.local.yml build
   docker compose -f compose.local.yml up -d
   npm install

3. Compile assets for development

   # To compile assets once
   npm run dev
   
   # Or to watch for changes during development
   npm run watch

   Open OGT-website in browser, default: http://localhost:8000

Config app env

See .env.example for more variables.

variable	value	description
APP_ENV	local	App configured for local. Features that are for testing or still in planning are disabled.
APP_ENV	testing	Features that are for testing or still in planning are enabled.
APP_ENV	production	Features that are for testing or still in planning are disabled.

Contribute and contact

Thank you for considering contributing to the OGT project. If you have any questions or suggestions, or if you discover a security vulnerability, please send an e-mail to: 📬 [email protected]

All security vulnerabilities will be promptly addressed.

Partners

License

The OGT project is open-sourced software distributed under the GNU GPLv3 License. See LICENSE for more information.