Skip to content

thealtres/thealtres-vis

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 

Repository files navigation

thealtres-vis

DOI

This project contains source code and data for the "Visualization" section of the Thealtres project website. The Thealtres project is a digital humanities project which aims at comparing theater in Alsatian with popular theater in German and French. For more information, visit the project website.

The goal of the thealtres-vis project is to create a user-friendly, appealing visualization UI for data of the Thealtres project, enabling users to easily view, filter, search and analyze trends across thousands of French, German and Alsatian plays. The web app was originally developed by Enzo Doyen as part of an internship under the supervision of Pablo Ruiz Fabo.

This project is based on the original Thealtres project website, created with Hugo. The web app was developed using TypeScript and leverages some JS libraries such as Tom Select (for dropdown search), Leaflet (for map visualization of location and setting data), D3.js (for custom charts) and JSZip (for downloading data).

Project structure

This repository contains two main folders: scripts/json_conversion and website.

The scripts/json_conversion folder contains original, annotated CSV data of the Thealtres project. A Python script (json_conversion.py) was created to convert the data to the JSON format in order to integrate it to the website. The following data types are made available: char_data, play_data, author_data, publisher_data, location_data, setting_data.

The website folder contains source for the Thealtres project website and was forked from https://git.unistra.fr/thealtres/thealtres.pages.unistra.fr. Uses Hugo v0.101.0.

Usage

git clone https://github.com/thealtres/thealtres-vis.git

json_conversion.py

  1. cd thealtres-vis/scripts/json_conversion
  2. python json_conversion.py <data_type> <inp_filename> <out_filename>

E.g., if you want to convert char_data.csv to char_data.json and place that file directly inside the corresponding website folder:

python json_conversion.py char_data csv/char_data.csv ../../website/static/json/char_data.json

website

  1. cd thealtres-vis/website
  2. hugo serve
  3. Open http://localhost:1313

Screenshots

image Main view.

image Geolocated publisher locations and play settings.