@openhistoricalmap/map-styles 0.9.2 → 0.9.3

package/historical/Historical-Style-Documentation.md

@@ -0,0 +1,34 @@
+# Documentation of Cartography of Historical Style
+## OpenHistoricalMap Design Principles
+GreenInfo Network and OpenHistoricalMap's cartographic journey for the main historical style began many years ago with cataloging, reviewing, and analyzing some historical styles as inspiration. There were many considerations when reviewing old maps and how they could and would be applied to a brand new style for an OHM base map. In particular, we considered the below heavily:<br>
+
+**1. Design for time, geography, and zoom level:** First and foremost, we needed to consider that the OpenHistoricalMap's main style would require a well thought out design that worked across all of time, and all geographies, across history. The cartographic choices would not simply be an attempt to style 1930’s America or 1700’s Japan, for example. While the map would be depicting history, the map style ultimately needed to work as a modern interactive map that had to _globally_  have a style that also worked across all zoom levels. From city streets to states to continents, a basic style would need to work for all of these scenarios <br><Br>
+**2. An ever-expanding data landscape:** Similar to OpenStreetMap, the amount and variety of types of data is _massive_. the cartographic choices made for the main style would also need to coherently work across different types of data (... across time, across geographies, across zoom levels). Most maps - historical or modern - have a single purpose and are designed thoughtfully to support that particular purpose. With OpenHistorical map's purpose effectively being "design for all-things", it also meant that limiting the amount of data - the number of types of information displayed - would also need to be a consistent conversation in the beginning of the design work for the style, but also alongside the growth of the main style, as ever changing data additions would mean that OHM would need to have some kind of flexibility as well as rigidity to not have TOO many data layers shown in the single main style. <br>
+<br>
+## OHM Historical Style History and Context
+After some time, we settled on an aesthetic inspiration coming from Alexander Gross's 1950 Highway Map.<br>
+<br>
+
+<img src="https://github.com/user-attachments/assets/ccae22bd-2da9-487f-b8fd-2b7cd64b1bce" alt="1950 highway map of United States, by Alexander Gross. Zoomed in to area near the Great Lakes to showcase the aesthetic. Blue lakes, white-ish land color" width="900">
+<img src="https://github.com/user-attachments/assets/00fbb9d8-e3e7-44b0-a0b7-bb13eccb7003" alt="1950 highway map of United States, by Alexander Gross. Zoomed in to area near San Francisco, highlighting the roadways and rail in black and red lines" width="900">
+<br><br>
+This seemed like a great inspiration for initial cartography. While Gross' map of course focused on highlighting highways, for the OHM style, we were inspired by the overall map, and liked how Gross used a handful of bright colors alongside a minimal amount of basic layers. Of particular inspirational was the dusty, dusky, blue-gray water; the warm off-white land color; and the bright colors and stark contrast of the highways against the light background. <br>
+<br>
+<img src="https://github.com/user-attachments/assets/5e4a891c-fbea-4c8b-9978-97120eceeeb4" alt="first draft of OHM style, bringing in some colors similar to Gross map.">
+<br>
+This first iterations of the OHM style brought in the inspiration from Boss' map into all data elements globally, at every zoom level. Highways, for example, were given a rust red color to make them stand out, as was very typical with vintage maps of this era. We pulled the water color almost directly from the 1950 Alexander Gross map posted above. This was a great starting point to get the OHM cartography ball rolling.
+
+Using Maputnik, we applied this style to OHM data and began to test the cartography across different locations, zoom levels, and times throughout history. As the style was reviewed, it became clear that the strong focus on highways and car-centric roads was _not_ great for all locations across all times. We toned down the saturation of water and shifted all roads to white. Roads were still differentiated by width, cases, and shield symbols and labels. This gave us more of a basic cartographic palette to work with, and allowed us to emphasize a variety of types of data, not simply transportation layers.
+
+After some time with this new iteration of the style, some OHM users and contributors expressed how they were missing the color differences for road types, and thought these differences had done a nice job of differentiating the types of roadways in the application. We created a few new options, returning to applying color to roads, but desaturated from our original designs - and settled on this symbology:
+<img src="https://github.com/user-attachments/assets/057e258f-cf55-4332-92b4-0f69150013cc" alt="Map showing the aforementioned design changes.">
+
+Interestingly, and maybe not surprisingly, the evolution of the OHM style started to pull away from the 1950s historical map style aesthetically, and more towards a modern interactive map style: this is largely because modern mapping simply requires us to consider a lot more data when doing so in an interactive map. We have to be able to find the right way to balance all of our layers’ symbologies more equally, which is where we are in our current approach. The below shows the style today:
+<img src="https://github.com/user-attachments/assets/a94fe3ba-7266-4ecb-b27f-1781491bfa69" alt="OHM map today, showing the UK. The water color is brighter, the land color is a little lighter in color. Rail lines cross the map.">
+<img src="https://github.com/user-attachments/assets/26cf161d-4a6c-4383-88c1-4355c015187d" alt="The map is zoomed into london, showcasing a lot of data at the ground level, such as shops and parks. Orange highways and white roads criss cross the map. The water color is brighter, the land color is a little lighter in color. Rail lines cross the map.">
+
+## OHM Cartography Today, and in the Future
+The current map's design still is inspired by and pulls from the original inspiration from Boss, and it also has gone through design choices in order to ensure new data or increases in data still showcase a balanced design. The data balancing is always the crux of shifting cartographic choices, and this is always where design shifts will lie in the future of OHM's cartography. Looking ahead, there also will always be new opportunities to bring in design influence from historical maps, **and** we must continue to balance the main style's data needs. 
+
+For more vintage inspired styles, check out OHM's other styles. These allow for much more "historical style inspiration" in their aesthetics, largely _because_ there is far less data shown on the map. If those maps had to have the same amount of data as OHM's main style, the aesthetics would not remain the same.
+

package/historical/historical.json

@@ -21,10 +21,19 @@
       "tiles": [
         "https://vtiles.staging.openhistoricalmap.org/maps/ne/{z}/{x}/{y}.pbf"
       ]
+    },
+    "osm_land": {
+      "type": "vector",
+      "tiles": [
+        "https://vtiles.openhistoricalmap.org/maps/osm_land/{z}/{x}/{y}.pbf"
+      ],
+      "minzoom": 0,
+      "maxzoom": 22,
+      "scheme": "xyz"
     }
   },
-  "sprite": "https://www.openhistoricalmap.org/map-styles/main/main_spritesheet",
-  "glyphs": "https://www.openhistoricalmap.org/map-styles/fonts/{fontstack}/{range}.pbf",
+  "sprite": "http://localhost:8888/historical/historical_spritesheet",
+  "glyphs": "http://localhost:8888/fonts/{fontstack}/{range}.pbf",
   "layers": [
     {
       "id": "background",
@@ -48,7 +57,7 @@
     {
       "id": "land",
       "type": "fill",
-      "source": "osm",
+      "source": "osm_land",
       "source-layer": "land",
       "minzoom": 0,
       "maxzoom": 24,
@@ -304,8 +313,6 @@
             "rgba(238, 229, 178, 1)",
             "basin",
             "rgba(144, 204, 203, 1)",
-            "wetland",
-            "rgba(227, 233, 226, 1)",
             "salt_pond",
             "rgba(236, 240, 241, 1)",
             "mud",
@@ -358,21 +365,6 @@
         ]
       }
     },
-    {
-      "id": "landuse_areas_z12_glacier-outline",
-      "type": "line",
-      "source": "osm",
-      "source-layer": "landuse_areas",
-      "minzoom": 9,
-      "maxzoom": 24,
-      "filter": ["==", ["get", "type"], "glacier"],
-      "layout": {"visibility": "visible"},
-      "paint": {
-        "line-color": "rgba(180, 211, 218, 1)",
-        "line-dasharray": [2, 2],
-        "line-width": ["interpolate", ["linear"], ["zoom"], 9, 1, 14, 1.5]
-      }
-    },
     {
       "id": "landuse_areas_z12_food_and_farming",
       "type": "fill",
@@ -559,7 +551,7 @@
       "type": "fill",
       "source": "osm",
       "source-layer": "water_areas",
-      "minzoom": 8,
+      "minzoom": 0,
       "maxzoom": 24,
       "layout": {"visibility": "visible"},
       "paint": {
@@ -574,6 +566,26 @@
         ]
       }
     },
+    {
+      "id": "water_areas-ne",
+      "type": "fill",
+      "source": "ne",
+      "source-layer": "water_areas",
+      "minzoom": 0,
+      "maxzoom": 8,
+      "layout": {"visibility": "visible"},
+      "paint": {
+        "fill-color": [
+          "interpolate",
+          ["linear"],
+          ["zoom"],
+          0,
+          "rgba(185, 228, 228, 1)",
+          10,
+          "rgba(126, 218, 218, 1)"
+        ]
+      }
+    },
     {
       "id": "landuse_areas_z12_watercover",
       "type": "fill",
@@ -599,40 +611,42 @@
             "rgba(144, 204, 203, 1)",
             "swimming_pool",
             "rgba(144, 204, 203, 1)",
+            "wetland",
+            "rgba(228, 242, 227, 1)",
             "transparent"
           ]
         ]
       }
     },
     {
-      "id": "landuse_areas_z11_wetland_watercover",
+      "id": "wetlands_z11-pattern",
       "type": "fill",
       "source": "osm",
       "source-layer": "landuse_areas",
       "minzoom": 11,
       "maxzoom": 24,
-      "filter": ["all", ["==", "type", "wetland"]],
+      "filter": ["==", ["get", "type"], "wetland"],
       "layout": {"visibility": "visible"},
-      "paint": {"fill-color": "rgba(228, 242, 227, 1)"}
+      "paint": {
+        "fill-color": "rgba(255, 255, 255, 1)",
+        "fill-pattern": {
+          "stops": [[12, "cattails_space_60px"], [14, "cattails_space_70px"]]
+        }
+      }
     },
     {
-      "id": "water_areas-ne",
-      "type": "fill",
-      "source": "ne",
-      "source-layer": "water_areas",
-      "minzoom": 0,
-      "maxzoom": 8,
+      "id": "landuse_areas_z12_glacier-outline",
+      "type": "line",
+      "source": "osm",
+      "source-layer": "landuse_areas",
+      "minzoom": 9,
+      "maxzoom": 24,
+      "filter": ["==", ["get", "type"], "glacier"],
       "layout": {"visibility": "visible"},
       "paint": {
-        "fill-color": [
-          "interpolate",
-          ["linear"],
-          ["zoom"],
-          0,
-          "rgba(185, 228, 228, 1)",
-          10,
-          "rgba(126, 218, 218, 1)"
-        ]
+        "line-color": "rgba(180, 211, 218, 1)",
+        "line-dasharray": [2, 2],
+        "line-width": ["interpolate", ["linear"], ["zoom"], 9, 1, 14, 1.5]
       }
     },
     {
@@ -671,22 +685,6 @@
         "fill-outline-color": "rgba(226, 223, 215, 1)"
       }
     },
-    {
-      "id": "wetlands_z11-pattern",
-      "type": "fill",
-      "source": "osm",
-      "source-layer": "landuse_areas",
-      "minzoom": 11,
-      "maxzoom": 24,
-      "filter": ["==", ["get", "type"], "wetland"],
-      "layout": {"visibility": "visible"},
-      "paint": {
-        "fill-color": "rgba(255, 255, 255, 1)",
-        "fill-pattern": {
-          "stops": [[12, "cattails_space_60px"], [14, "cattails_space_70px"]]
-        }
-      }
-    },
     {
       "id": "water_lines_stream_no_name",
       "type": "line",
@@ -1064,7 +1062,7 @@
       "type": "fill",
       "source": "osm",
       "source-layer": "transport_areas",
-      "minzoom": 14,
+      "minzoom": 12,
       "maxzoom": 24,
       "filter": ["==", ["get", "type"], "aerodrome"],
       "layout": {"visibility": "visible"},
@@ -1078,7 +1076,7 @@
       "type": "fill",
       "source": "osm",
       "source-layer": "transport_areas",
-      "minzoom": 14,
+      "minzoom": 12,
       "maxzoom": 24,
       "filter": ["==", ["get", "type"], "helipad"],
       "layout": {"visibility": "visible"},
@@ -2691,7 +2689,7 @@
       "type": "line",
       "source": "osm",
       "source-layer": "transport_lines",
-      "minzoom": 14,
+      "minzoom": 12,
       "filter": ["==", ["get", "type"], "subway"],
       "layout": {"visibility": "visible"},
       "paint": {
@@ -2701,7 +2699,7 @@
           ["linear"],
           ["zoom"],
           12,
-          1,
+          0.8,
           13,
           1,
           14,
@@ -3147,6 +3145,36 @@
         "line-dasharray": [0.1, 0.3]
       }
     },
+    {
+      "id": "roads_servicecase_z13",
+      "type": "line",
+      "source": "osm",
+      "source-layer": "transport_lines",
+      "minzoom": 13,
+      "maxzoom": 24,
+      "filter": [
+        "all",
+        ["in", ["get", "type"], ["literal", ["service"]]],
+        ["!=", ["get", "bridge"], 1]
+      ],
+      "layout": {
+        "visibility": "visible",
+        "line-cap": "round",
+        "line-join": "round"
+      },
+      "paint": {
+        "line-color": "#D2D2D5",
+        "line-width": [
+          "interpolate",
+          ["exponential", 1.5],
+          ["zoom"],
+          13,
+          2,
+          18,
+          12
+        ]
+      }
+    },
     {
       "id": "roads_residentialcase_z13",
       "type": "line",
@@ -3156,11 +3184,7 @@
       "maxzoom": 24,
       "filter": [
         "all",
-        [
-          "in",
-          ["get", "type"],
-          ["literal", ["residential", "service", "unclassified"]]
-        ],
+        ["in", ["get", "type"], ["literal", ["residential", "unclassified"]]],
         ["!=", ["get", "bridge"], 1]
       ],
       "layout": {
@@ -3495,6 +3519,32 @@
         "line-dasharray": [1, 2]
       }
     },
+    {
+      "id": "roads_service",
+      "type": "line",
+      "source": "osm",
+      "source-layer": "transport_lines",
+      "minzoom": 12,
+      "maxzoom": 24,
+      "filter": ["in", ["get", "type"], ["literal", ["service"]]],
+      "layout": {
+        "visibility": "visible",
+        "line-cap": "round",
+        "line-join": "round"
+      },
+      "paint": {
+        "line-color": "#ffffff",
+        "line-width": [
+          "interpolate",
+          ["exponential", 1.5],
+          ["zoom"],
+          12,
+          1.6,
+          18,
+          7
+        ]
+      }
+    },
     {
       "id": "roads_residential",
       "type": "line",
@@ -3505,7 +3555,7 @@
       "filter": [
         "in",
         ["get", "type"],
-        ["literal", ["residential", "service", "unclassified"]]
+        ["literal", ["residential", "unclassified"]]
       ],
       "layout": {
         "visibility": "visible",
@@ -5595,7 +5645,7 @@
       "source": "osm",
       "source-layer": "buildings_centroids",
       "minzoom": 16,
-      "filter": ["all"],
+      "filter": ["!=", ["get", "type"], "parking"],
       "layout": {
         "icon-image": "{tourism}-18",
         "visibility": "visible",
@@ -5971,7 +6021,7 @@
       "source": "osm",
       "source-layer": "transport_areas",
       "minzoom": 10,
-      "maxzoom": 16,
+      "maxzoom": 14,
       "filter": ["==", ["get", "type"], "aerodrome"],
       "layout": {"icon-image": "airport-18", "text-font": ["OpenHistorical"]}
     },

package/index.html

@@ -0,0 +1,50 @@
+<html>
+<head>
+  <script src="./node_modules/maplibre-gl/dist/maplibre-gl.js"></script>
+  <link href="./node_modules/maplibre-gl/dist/maplibre-gl.css" rel="stylesheet" />
+</head>
+<body>
+<div id="map" style="width:100%;height:100%"></div>
+
+<script type="module">
+  import StyleFlipperControl from "./node_modules/maplibre-gl-style-flipper/index.js";
+  const mapStyles = {
+    "historical": {
+      code: "historical",
+      url: "./historical/historical.json"
+    },
+    "japanese_scroll": {
+      code: "japanese_scroll",
+      url: "./japanese_scroll/japanese_scroll.json"
+    },
+    "railway": {
+      code: "railway",
+      url: "./railway/railway.json"
+    },
+    "woodblock": {
+      code: "woodblock",
+      url: "./woodblock/woodblock.json"
+    },
+  };
+
+  var map = new maplibregl.Map({
+    container: 'map',
+    style: mapStyles["historical"].url,
+    center: [-74.033, 40.6259],
+    zoom: 11.73,
+    hash: true
+  })
+
+  // Create an instance of StyleFlipperControl
+  const styleFlipperControl = new StyleFlipperControl(mapStyles);
+
+  // Set the initial style code
+  styleFlipperControl.setCurrentStyleCode("historical");
+
+  // Add the control to the map
+  map.addControl(styleFlipperControl, "bottom-right");
+
+</script>
+
+</body>
+</html>

package/japanese_scroll/Japanese_Scroll-Style-Documentation.md

@@ -0,0 +1,40 @@
+# Documentation of Japanese Scrool Map Style
+This style was created after the Woodblock style, and is inspired by the long-form Japanese scroll maps from ~1500/1600/1700s. In some ways, the longform map emulates the modern mapping scale so much more, because the scrolls gave so much more space for information and data. Of course, the amount of paper isn't the same as global or multiple zoom levels, but the premise of showing more information, and having a different visualization connection to what one sees in real life, on the ground, is why I wanted to make this style.
+<br>
+Obviously, the map style is limited to a rectangular screen size, and also doesn't have the same capacity to make you feel like you are strolling along a river, the coast, or a trail, but hopefully some of the core aesthetic elements bring this style into clearly being rooted in historical Japanese maps.
+<br> 
+Below are the maps from which I pulled inspiration:
+- [[Shandong, Zhili, Shengjing hai jiang tu]](https://www.loc.gov/resource/g7822cm.gct00259?r=0.375,0.043,0.25,0.154,0)  Coastal map of Shandong, Zhili, and Shengjing
+- [Map of the Sea and Land Routes from Edo to Nagasaki](https://www.loc.gov/resource/gdcwdl.wdl_14435_001/?sp=23&r=-0.08,-0.07,1.238,0.761,0), Kyoto : Nishida Shobee, 1672
+- [Dai Nihon enkai yochi zenzu](https://www.loc.gov/resource/g7960m.gct00032/?sp=16&r=-0.192,0.859,0.973,0.598,0) [Japan, Hokkaido to Kyushu]
+- [Song Xian he tu.](https://www.loc.gov/resource/g7823s.ct003375/?r=-0.218,-0.052,1.454,0.894,0) Map of the river systems in Song County
+- [[Rehe xing gong quan tu]](https://www.loc.gov/resource/g7824c.ct001844/?r=0.789,0.26,0.25,0.154,0)
+
+## Aesthetic Elements That Made the Map Look Old
+### Background Layer (land)
+![image](https://user-images.githubusercontent.com/7087091/155616674-731c9b0d-e376-4594-b008-bd9c7544488d.png) <br>
+For this style, it made sense to emulate the texture of old, aged paper, as this aesthetic is something we are very used to seeing in old maps. 
+
+## Water (Ocean, lakes)
+![image](https://user-images.githubusercontent.com/7087091/211070389-a98ee7a4-daad-4682-92f7-141e325836b8.png)<br>
+I was inspired by the above, and created a pattern for water areas across the map that was similar to the above.
+
+## Linework (admin, roads)
+![image](https://user-images.githubusercontent.com/7087091/211070481-fdcea19d-31fd-4b1e-97c5-daa4f897ed86.png) <br>
+Similar to Woodblock, I used  inconsistent/tapering lines to emulate the imperfections of old maps. 
+
+## Symbology (Mountains)
+![image](https://user-images.githubusercontent.com/7087091/211070597-c2c238e5-858e-4fff-ad51-f7e0ac21fecc.png)
+![image](https://user-images.githubusercontent.com/7087091/211070644-bee6701a-f61d-4728-b310-242968326dcb.png)
+![image](https://user-images.githubusercontent.com/7087091/211070700-780e5719-495d-40a6-b582-c9cf2cd13edc.png)
+<br>
+Symbology in old maps always a reason why they look old. Mountains were a consistent theme across japanese maps, so I created these symbols as well.
+
+## Label Design
+![image](https://user-images.githubusercontent.com/7087091/211070796-31b61a28-1f16-4ef4-a9d2-672b7709196c.png) <br>
+This felt really important as a few of the maps had this styling. I used block/square halos with red tones were common across various maps. Incorporated reds as well as mustard yellows, as this also was colors used across some of the inpsiration maps
+
+## Data Choices
+Like the Woodblock style, this map style intentionally removes quite a bit of OHM data from the map. Older maps had a lot less data in them. If this map were to grow over time and have more data added, there would need to be some consideration of how design elements change to ensure that there is an appropriate hierarchy and balance of contrast.
+
+For now, this style serves to highlight an older map aesthetic, in modern mapping technologies, alongside showing data over time.

package/japanese_scroll/japanese_scroll.json

@@ -16,8 +16,8 @@
       ]
     }
   },
-  "sprite": "https://www.openhistoricalmap.org/map-styles/japanese_scroll/jp_spritesheet_template",
-  "glyphs": "https://www.openhistoricalmap.org/map-styles/fonts/{fontstack}/{range}.pbf",
+  "sprite": "http://localhost:8888/japanese_scroll/japanese_scroll_spritesheet_template",
+  "glyphs": "http://localhost:8888/fonts/{fontstack}/{range}.pbf",
   "layers": [
     {
       "id": "background",

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@openhistoricalmap/map-styles",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "description": "A collection of map styles for OpenHistoricalMap",
   "main": "''",
   "type": "module",
   "scripts": {
     "prepare": "scripts/prepare.js",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "http-server --port 8888 --cors -o '#7.33/40.487/-73.554'"
   },
   "repository": {
     "type": "git",
@@ -17,12 +17,15 @@
     "Vanessa Knoppke-Wetzel <run.for.funner@gmail.com>",
     "Eric Theise <erictheise@gmail.com>"
   ],
-  "license": "",
+  "license": "CC0 1.0 Universal",
   "bugs": {
-    "url": "https://github.com/OpenHistoricalMap/map-styles/issues"
+    "url": "https://github.com/OpenHistoricalMap/issues"
   },
   "homepage": "https://github.com/OpenHistoricalMap/map-styles#readme",
   "dependencies": {
-    "camelcase": "^8.0.0"
+    "camelcase": "^8.0.0",
+    "http-server": "^14.1.1",
+    "maplibre-gl": "^5.1.0",
+    "maplibre-gl-style-flipper": "^1.0.7"
   }
 }

package/railway/Railway-Style-Documentation.md

@@ -0,0 +1,60 @@
+# Documentation of Railway Style: Where it is today
+The below documents the original considerations for the rail style. This style, however, is one that requires some design updates, and I would say is not at all a "final design" because of the likelihood of more data attributes to exist in the future. This style is historical but also must be practical, and unlike the other two style variants, this style requires more data, and also has more need for multi-variant styling of some elements (specifically rail). <br>
+<br>
+
+## Original Railway Style Inspiration (And references for the future?)
+
+### Main line routes
+![image](https://github.com/OpenHistoricalMap/issues/assets/7087091/b6315c49-b06a-4290-a00d-b51e37f7fc24)
+![image](https://github.com/OpenHistoricalMap/issues/assets/7087091/1e317252-0f2a-40f2-bc83-5f071d0878ed)
+![image](https://github.com/OpenHistoricalMap/issues/assets/7087091/0ebd2c0d-b581-40ee-b569-36292b2c7c66)
+![image](https://github.com/OpenHistoricalMap/issues/assets/7087091/ca6d44fb-a65f-4877-a750-e50be86aa021)
+![image](https://github.com/OpenHistoricalMap/issues/assets/7087091/de96141e-ecba-484a-a235-1debe2c0dd67)
+![image](https://github.com/OpenHistoricalMap/issues/assets/7087091/6cc264f9-f1f7-42af-b76b-692f0ef4cadc)
+
+heavy black lines with white/clear circles (that represented towns) were common across many historical maps. This in itself isn't shocking: Make a clearly visible line, and showcase where the cities and towns are along the routes. The result is a visually distinct aesthetic, however. Given that this occurs often and also globally ( *historical research dependent on what I could find based on language I speak, so noting that I attempted to review globally but limits here). Given this, this aesthetic seems appropriate for "main" line routes.
+<br>
+<br>
+While this is where the inspiration for the "main" rail lines came from, the OHM community has generally stated that it would be ideal to update this, so I anticipate when there are more data attributes, this styling will change in the future.
+
+### "Other route" aesthetics
+Obvious tracks, dashed lines, and other line aesthetics are ones we should use for the upcoming variety of rail that folx are considering adding as more distinguishable tags for a rail specific style, but I wanted to also review historically how some of these presented, as well as gather other options for inspiration. 
+<br>
+The below lists and shows some examples
+<br>
+<br>
+Thick, dense rail dashes (millipede-esque):
+![image](https://github.com/OpenHistoricalMap/issues/assets/7087091/e7e3a198-9471-4de7-adf0-75ad03661fd0)
+![image](https://github.com/OpenHistoricalMap/issues/assets/7087091/22f01ba5-02fb-4eb7-a8ae-82460b1e96d5)
+![image](https://github.com/OpenHistoricalMap/issues/assets/7087091/b2467fda-2ac9-4416-9f9b-d919bda403da)
+<br><Br>
+classic dashed route:
+![image](https://github.com/OpenHistoricalMap/issues/assets/7087091/82bfce88-020b-4116-b6f3-31be5889244b)
+<br><br>
+mostly-one-sided dash (I think possible implentation via offset?):
+![image](https://github.com/OpenHistoricalMap/issues/assets/7087091/ed4c5ba2-f644-4fb3-80ea-4689be3f9a8a)
+<Br><br>
+one-sided dash:
+![image](https://github.com/OpenHistoricalMap/issues/assets/7087091/33e32a54-6b1d-49af-b20a-19cf831e1edb)
+![image](https://github.com/OpenHistoricalMap/issues/assets/7087091/bf5e595a-9c23-4464-a63e-f7222bbc6331)
+<Br><Br>
+thicker wide dashes:
+![image](https://github.com/OpenHistoricalMap/issues/assets/7087091/013d6328-f982-4b20-b4bc-ffe323105e21)
+<Br><br>
+Legend with line varieties (not just rail):
+![image](https://github.com/OpenHistoricalMap/issues/assets/7087091/29fad750-b5ad-470b-9a79-d5b780d9330b)
+<br><br>
+farther-apart track dashes:
+![image](https://github.com/OpenHistoricalMap/issues/assets/7087091/2bb34dc4-68e0-4780-9b83-7a17269c75ff)
+<br><br>
+"casing only" route (not the main routes that are bolder here):
+![image](https://github.com/OpenHistoricalMap/issues/assets/7087091/c1eaaf88-3f72-4b4e-b187-d80f096442f8)
+<Br><br>
+And of course, the above isn't including basic line representation, color variances, and normal dashing lines as well (also pictured in these map examples)
+
+## Data and Design Today vs the Future
+![image](https://github.com/user-attachments/assets/52041a80-e350-47ab-a96a-f55162927465)
+The above notes what the various rail styling looks like today. Updates have been made since the original style release based on community feedback, but as noted above, there will absolutely be more changes in the future.
+<br><br>
+Data-wise today, only some places across the globe have visible rail variance. When there are updates to the rail data, this is where there will be a need for more design changes and considerations to be made, especially because this is what the OHM rail community has identified as a space that they want updated (more data, and then updated designs for that new data).
+

package/railway/railway.json

@@ -25,8 +25,8 @@
       ]
     }
   },
-  "sprite": "https://www.openhistoricalmap.org/map-styles/rail/rail_spritesheet",
-  "glyphs": "https://www.openhistoricalmap.org/map-styles/fonts/{fontstack}/{range}.pbf",
+  "sprite": "http://localhost:8888/railway/railway_spritesheet",
+  "glyphs": "http://localhost:8888/fonts/{fontstack}/{range}.pbf",
   "layers": [
     {
       "id": "background",

package/scripts/prepare.js

@@ -18,8 +18,15 @@ if (!fs.existsSync(distDir)) {
 }
 
 try {
+  const assets = ['glyphs', 'sprite'];
   styles.forEach((style) => {
-    ohmVectorStyles[camelCase(style, { pascalCase: true })] = JSON.parse(fs.readFileSync(path.join(baseDir.path, style, `${style}.json`)));
+    // Load each development style from disk, replace the scheme/domain/port, & make it the value of an ohm-website key,
+    // e.g., japanese_scroll => ohmVectorStyles.JapaneseScroll
+    const ohmWebsiteKey = camelCase(style, { pascalCase: true });
+    ohmVectorStyles[ohmWebsiteKey] = JSON.parse(fs.readFileSync(path.join(baseDir.path, style, `${style}.json`)));
+    assets.forEach((asset) => {
+      ohmVectorStyles[ohmWebsiteKey][asset] = ohmVectorStyles[ohmWebsiteKey][asset].replace('http://localhost:8888', 'https://www.openhistoricalmap.org/map-styles')
+    })
   })
   fs.writeFileSync(
     path.join(distDir, `ohm.styles.js`),

package/woodblock/Woodblock-Style-Documentation.md

@@ -0,0 +1,29 @@
+# Documentation of Woodblock Style
+The woodblock style was directly informed by woodblock map styles in the history of cartography. Specific aesthetic elements that captured the imperfections and textures of these old maps - plus map monsters of course - helped to bring this style to life.
+
+## Aesthetic Elements that Made the Map Look Old
+
+### Background Layer (ocean)
+![image](https://user-images.githubusercontent.com/7087091/155616674-731c9b0d-e376-4594-b008-bd9c7544488d.png) <br>
+For this style, it made sense to emulate the texture of old, aged paper, as this aesthetic is something we are very used to seeing in old maps. 
+
+### Typeface and styling
+![image](https://user-images.githubusercontent.com/7087091/155616707-ab373ef4-ef99-43dd-bca4-d3b22dd320c7.png)<br>
+For the font choice, I chose the [Eadui](https://fontlibrary.org/en/font/eadui) (with [SIL Open Font License](https://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=OFL)) because it was very close to a typeface style that was used often in woodblock maps, and also was easier to read on a screen than the bolder Blackletter options that also typical woodblock map fonts.I also made a thick halo in the labels, emulating the “halos” that were commonly seen in woodblock maps, due to map makers adding labels via slot cutting (read more about tools and media [here](https://vknoppkewetzel.github.io/VKW_MSthesis.pdf)), or leaving space to label by hand.
+
+### Linework design (roads, country boundaries)
+![image](https://user-images.githubusercontent.com/7087091/155616859-91af592c-1c12-4a27-a5b5-d9448590eb87.png)<br>
+Both the tools used and the medium (wood) meant that everything carved into the wood was not perfectly linear, perfectly spaced, or perfectly circular. Additionally, using ink on the block and pressing down the block onto paper meant the ink sometimes squeezed to the side, or was patchy on the paper itself, providing even more textural elements. Essentially, the tools and mediums used mean that woodblock maps have “imperfections” as an enormous part of the aesthetic.
+
+In order to mimic this, I created “splotchy” (ink squeezing/inconsistent) linework which is used in country boundaries and building linework, as well as “inconsistent tapering” linework for the roads. 
+
+Note, I intentionally used a light dashed-line for state boundaries rather than another textural line pattern, as it was a little too much texture to use another “imperfect” line pattern for states (alongside a more intricate font, country boundaries, paper texture, roads, and stylized icons).
+
+### Symbology design
+![image](https://user-images.githubusercontent.com/7087091/155616941-6627cda8-fa5e-42a3-a96f-192dfe1b01a7.png)<br>
+A huge part of old maps are the illustrative elements across the map, from icons used for cities to map monsters across the old map. I created two different sized building icons, two different map monsters, and a tree grouping to provide this final aesthetic element to this map to wrap up the “woodblock map feeling” of the style. 
+
+### Data Choices
+ Another important aspect of making this style work really well in emulating woodblock maps is that this map intentionally removes quite a bit of OHM data from the map. Older maps had a lot less data in them. If this map were to grow over time and have more data added, there would need to be some consideration of how design elements change to ensure that there is an appropriate hierarchy and balance of contrast. 
+<br><br>
+For now, this style serves to highlight an older map aesthetic, in modern mapping technologies, alongside showing data over time.

package/woodblock/woodblock.json

@@ -16,8 +16,8 @@
       ]
     }
   },
-  "sprite": "https://www.openhistoricalmap.org/map-styles/woodblock/woodblock_spritesheet",
-  "glyphs": "https://www.openhistoricalmap.org/map-styles/fonts/{fontstack}/{range}.pbf",
+  "sprite": "http://localhost:8888/woodblock/woodblock_spritesheet",
+  "glyphs": "http://localhost:8888/fonts/{fontstack}/{range}.pbf",
   "layers": [
     {
       "id": "background-pattern",