Introduction

Overview

GET TO THIS SITE: bit.ly/45ge999

This beginner-level workshop is intended for anyone interested in overlaying and sharing historical spatial data in the web. This workshop builds on previous workshops in a series which use modern frameworks and applications including IIIF, Allmaps, geojson.io, Visual Studio Code, and Mapbox GL JS to move from a scanned digital map image, to publishing a georeferenced overlay and extracted historical data on a web map. Previous workshops:

The workshop aims to develop the fundamental knowledge and skills to begin sharing historical map overlays using web maps, while providing opportunities to ask questions along the way. There are two main sections: an introduction to web maps, and a hands-on where we will will learn to customize boilerplate code from within a source code editor to make an interactive map showing a historical map overlay and modern data, powered by Mapbox GL JavaScript library.

What You Will Build

Agenda

Time Section Objectives
0:00 Start Who is this for?
What will we be covering?
0:10 Introduction What is a Web Map?
Which web mapping platforms are best for me?
0:35 Set Up How do I set up my local environment?
How do I set up my Mapbox account?
0:45 Base Maps What’s important in a base map?
How do I add a base map?
0:55 Map Overlays What are my options for adding historical map overlays?
How do I add an XYZ tileset?
How do I add a transparency slider?
1:05 Map Data Which kinds of data can I add to my map?
How do I add a geojson layer?
How do I add a popup?
1:35 Publishing What options do I have for sharing my web map in the web?
How can I host my map with GitHub?
1:55 Next Steps Where do I go for help?
What are your ideas for continuing on?

Pre-Workshop Setup

Please install the latest version of Visual Studio Code (VS Code) for this workshop. More information can be found on the Set Up - Visual Studio Code Editor page.

While attendees can choose to use the web version of Visual Studio Code (VS Code) to complete the hands-on activites in this workshop, the Desktop installation of VS can be easily customizable for a range of work with text-based data and code – including starting an easy local server to view changes on the fly. We recommend downloading and installing on your computer the latest version of VS Code.

Aside from Visual Studio Code, the entirety of this workshop can be done with a modern web browser. We recommend having either Mozilla FireFox or Google Chrome installed before you attend.

Workshop Source Code

The content making up this workshop is being managed in GitHub, and we welcome suggestions for how to improve in the form of GitHub Issues. Please use Issues to let us know about things like grammatical errors, broken links, or other suggested updates.