diff --git a/README.md b/README.md index d46ce1f..7472c4f 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,117 @@ -# ravenclaw -Ravenna Cosmography Spatial Edition +# RavenC:LAW -Todo... +**Ravenna Cosmography: Locations, Alignments & Weblinks** + +An interactive spatial exploration platform for the 7th-century Ravenna Cosmography—a medieval geographic text describing places known to the Roman world. + +## Features + +- **Dual-map view**: Synchronized display of the Peutinger Map (historical) and modern geographic map +- **3,500+ ancient toponyms** from Books 1-5 of the Ravenna Cosmography +- **Hierarchical navigation**: Browse by Book → Region (Patria) → List → Place +- **Cross-references** to major ancient geography databases: + - [Pleiades](https://pleiades.stoa.org/) - Ancient place gazetteer + - [TP-Online](https://tp-online.ku.de/) - Peutinger Map digitization (Katholische Universität Eichstätt-Ingolstadt) + - [Talbert Roman Geography](https://www.cambridge.org/us/talbert/) - Cambridge database +- **Littoral itinerary visualization**: Book 5's 14-stage coastal circuit around the Mediterranean +- **Multiple symbology modes**: Color by region, by list sequence, or by primary source +- **Search**: Find places by toponym name +- **Direct source links**: Click toponyms to view the Schnetz edition PDF at the relevant page + +## Directory Color Coding + +The place directory uses colors to indicate data completeness: + +| Color | Meaning | +|-------|---------| +| 🟢 Green | Place matched in both TP-Online AND Pleiades | +| 🟠 Orange | TP-Online only (appears on Peutinger Map, no modern coordinates) | +| 🔵 Blue | Pleiades only (modern coordinates, not on Peutinger Map) | +| 🔴 Red | No coordinates available in either database | + +## Map Symbols + +- **Filled circles**: Places that appear on the Peutinger Map +- **Cross symbols (+)**: Places NOT on the Peutinger Map +- **Littoral stages**: Alternating black/white markers distinguish the 14 coastal circuit stages + +## Data Sources + +| Source | Description | +|--------|-------------| +| **Primary text** | Schnetz edition (1939-1940) of the Ravenna Cosmography | +| **Peutinger Map** | [TP-Online](https://tp-online.ku.de/) digitization by KU Eichstätt-Ingolstadt | +| **Geographic coordinates** | [Pleiades](https://pleiades.stoa.org/) ancient places gazetteer | +| **Base map** | [Digital Atlas of the Roman Empire](https://imperium.ahlfeldt.se/) (DARE) | +| **Historical boundaries** | Late Roman provinces/dioceses (AD 303), Euratlas polities (c. 600 AD) | + +## Data Files + +| File | Description | +|------|-------------| +| `ravenclaw.csv` | Main database of 3,500+ toponyms from Books 1-5 | +| `rc_littoral.csv` | Littoral (coastal) itinerary from Book 5 | +| `ku_tp_*.geojson` | Peutinger Map features (coastlines, rivers, mountains, etc.) | +| `*_paths.geojson` | Place sequence connections | +| `schnetz.pdf` | Schnetz edition of the Ravenna Cosmography | + +## Local Development + +1. Clone the repository: + ```bash + git clone https://github.com/leifuss/ravenclaw.git + cd ravenclaw + ``` + +2. Serve with any static file server: + ```bash + # Python 3 + python -m http.server 8000 + + # Node.js (npx) + npx serve . + ``` + +3. Open http://localhost:8000 in your browser + +## Browser Compatibility + +Tested on modern browsers (Chrome, Firefox, Safari, Edge). Requires JavaScript enabled. Mobile-responsive design with slide-out menu for smaller screens. + +## Version History + +### v.0.2.5 (December 2024) +- **Place Details Panel**: Sidebar panel shows detailed place information when clicking on map or directory +- **Simplified popups**: Map popups now show title only; full details appear in sidebar panel +- **Schnetz PDF links**: Fixed page offset (+14) for correct PDF navigation +- **Mobile improvements**: Panel and sidebar work properly on mobile devices +- **First-click fix**: Details panel now loads correctly on first map click + +### v.0.1.x - v.0.2.x +- Classical Roman styling theme (Cinzel/Crimson Text fonts, parchment colors) +- Mobile-responsive sidebar with hamburger menu +- Loading state overlay with spinner +- About and Feedback links in sidebar +- Improved CSV parsing for quoted fields +- UTF-8 BOM handling for popup titles + +## Citation + +If you use RavenC:LAW in your research, please cite: + +> Isaksen, L. (2024). RavenC:LAW: Ravenna Cosmography Locations, Alignments & Weblinks [Web application]. https://github.com/leifuss/ravenclaw + +## Contributing + +Feedback and contributions welcome! Please open an issue or contact: l.isaksen@exeter.ac.uk + +## License + +See [LICENSE](LICENSE) file for details. + +## Acknowledgments + +- Peutinger Map digitization: [TP-Online](https://tp-online.ku.de/) (Katholische Universität Eichstätt-Ingolstadt) +- Ancient places data: [Pleiades](https://pleiades.stoa.org/) +- Base map: [Digital Atlas of the Roman Empire](https://imperium.ahlfeldt.se/) +- Mapping platform: [ArcGIS Maps SDK for JavaScript](https://developers.arcgis.com/javascript/) diff --git a/index.html b/index.html index 52b9b8d..8b412c8 100644 --- a/index.html +++ b/index.html @@ -13,24 +13,222 @@ - - + + + + + + - + + +
+

+ + Ravenna Cosmography + +

+

+ Locations, Alignments & Weblinks + (RavenC:LAW beta v.0.2.5) +

+
@@ -1442,8 +1926,61 @@

- -

Place Directory

+

Place Directory

+ + +
+ About + Feedback +
+ + + + + +
+ Legend +
+

Directory Colors:

+
+ + TP-Online + Pleiades +
+
+ + TP-Online only +
+
+ + Pleiades only +
+
+ + No coordinates +
+
+

Map Symbols:

+
+ + Place on Peutinger Map +
+
+ + Place NOT on Peutinger Map +
+
+

Littoral Stages:

+
+ + + Alternating by stage +
+
+
diff --git a/ravenclaw.csv b/ravenclaw.csv index 6fccc97..1cb30d8 100644 --- a/ravenclaw.csv +++ b/ravenclaw.csv @@ -1,4 +1,4 @@ -rc_index_no,rc_book,rc_continent,rc_patria_original,rc_patria,rc_list_number_original,rc_list_number,weber_list_no,pp_page,schnetz_page,rc_toponym,weber_look_up_key,weber_no,tp_name_weber,tp_alt_name_weber,talbert_gridsquare,talbert_id,rc_name_weber,rc_name,rc_uri,rc_page,rc_itinerary,rc_itin_no,ku_id,on_tp,pleiades_id,ku_gridsquare,ku_name_lookup,talbert_name_lookup,pleiades_name_lookup,ku_uri_lookup,talbert_uri_lookup,pleiades_uri_lookup,rep_lat,rep_long,ku_x,ku_y,region_id,region,primary_source,other_sources +rc_index_no,rc_book,rc_continent,rc_patria_original,rc_patria,rc_list_number_original,rc_list_number,weber_list_no,pp_page,schnetz_page,rc_toponym,weber_look_up_key,weber_no,tp_name_weber,tp_alt_name_weber,talbert_gridsquare,talbert_id,rc_name_weber,rc_name,rc_uri,rc_page,rc_itinerary,rc_itin_no,ku_id,on_tp,pleiades_id,ku_gridsquare,ku_name_lookup,talbert_name_lookup,pleiades_name_lookup,ku_uri_lookup,talbert_uri_lookup,pleiades_uri_lookup,rep_lat,rep_long,ku_x,ku_y,region_id,region,primary_source,other_sources 1,2,Asia,India Dimirica Evilat,India Dimirica Evilat,1a,1a,1,40,15,Palanda,1 Palanda,,,,,,,,,,,,,FALSE,,,,,,,,,,,0,0,2.1,India Dimirica Evilat,Castorius (Roman),- 2,2,Asia,India Dimirica Evilat,India Dimirica Evilat,1a,1a,1,40,15,Sinna,1 Sinna,,,,,,,,,,,,0,FALSE,,,,,,,,,,,,,2.1,India Dimirica Evilat,Castorius (Roman),- 3,2,Asia,India Dimirica Evilat,India Dimirica Evilat,1a,1a,1,40,15,Bonogaris,1 Bonogaris,,,,,,,,,,,,0,FALSE,,,,,,,,,,,,,2.1,India Dimirica Evilat,Castorius (Roman),- diff --git a/rc_littoral.csv b/rc_littoral.csv index 496fc96..e7e5830 100644 --- a/rc_littoral.csv +++ b/rc_littoral.csv @@ -1,4 +1,4 @@ -stage,pleiades_id,pleiades_toponym,TP_gridsquare,Talbert_id,ku_id,ku_name_lookup,talbert_name_lookup,TP_symbol,TP_notes,TP_coastal,RC_peri_count,pp_page,schnetz_page,RC_peri_ref,RC_peri,RC itin,gg_ref,GG_peri,GG_itin,representative_latitude,representative_longitude,ku_x,ku_y +stage,pleiades_id,pleiades_toponym,TP_gridsquare,Talbert_id,ku_id,ku_name_lookup,talbert_name_lookup,TP_symbol,TP_notes,TP_coastal,RC_peri_count,pp_page,schnetz_page,RC_peri_ref,RC_peri,RC itin,gg_ref,GG_peri,GG_itin,representative_latitude,representative_longitude,ku_x,ku_y 1,393480,Ravenna,4B1,1140,153,Ravenna,Ravenna,yes,start of circuit,Ravenna,1,326,84,326.1,Ravenna,"Ravenna nobilissima, in qua licet idiota ego huius cosmographiae expositor Christo adiuvante genitus sum,",69.2,Ravenna,"Ravenna, in qua idem cosmographiae expositor huius licet indoctusimus Christi servus exortus sum",44.415718,12.196604,0.173224498,-0.015294238 1,,Caesena,,,0,,,,,,2,326,84,326.2,Caesarea,Caesarea,69.21,Cesarea,Cesarea,0,0,, 1,393404,Classis,,,,,,,,,3,326,84,326.3,Classis,Classis,70.1,Classis,Classis,44.3953243,12.21907269,,