site_maps 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9246737e11d28f750005fedc117c0c2afb8c5f5ef606218fc505e1042c4da002
-  data.tar.gz: 80f005cca72244cfe1044c30cf91d1656b22bb7ff3047a2fd159eee2ddd2f3a5
+  metadata.gz: 312638d84df202fdc438b1d93c61325a66eb2513be24846b5dce67dfe47b5737
+  data.tar.gz: 9e346f74fd71bb0f5f9187407adb934ae577acac5c71f4a2100ac650c5969f40
 SHA512:
-  metadata.gz: 6ebb8a69803018a65c995e61cc714385ae965b04fc8df330cb7a5e99fd37539568cc1661e86da70f1e7e90eef108ba9a9c5ba1bc6e4b50d5c17f41856e4df934
-  data.tar.gz: 9dbf41444903708643f4639ae773470fc2043eeb0deb9061dedccef5ceda30210435db6faec1d1f949baa8200841d7245c40ac97df88f8993b57e5c1caeaa41b
+  metadata.gz: 91ee260ef7da511dbaa184a34d05225e9293c6bf220d3b7bd2447fa69e84fe47bec7aa77f0ae96a9b4d4eeb50646df9d50c7137d44077490622b3152a1ed1c2d
+  data.tar.gz: a6d1c0ee3b32571b801ddb2f152b92f1684db588b15bc58ca6af08f0afdc66e919286b1973b352bb7012e33538f13e95e81724a4509adf4181b6ff7e7ebdd973

data/.tool-versions

@@ -1 +1 @@
-ruby 3.4.9
+ruby 3.0.7

data/CHANGELOG.md

@@ -4,6 +4,24 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 0.2.0 - 2026-11-11
+
+### Added
+- `index_from_storage` configuration option. The sitemap index is rebuilt from the sitemap files found in storage (filtered by the declared process locations) instead of the in-memory state of the run, so it always lists every shard that exists.
+  - The index is still written when a process fails, and the other processes keep running. The first error is re-raised afterwards.
+  - Numbered parts a successful process no longer writes (e.g. `sitemap3.xml` after a shard shrank to two files) are deleted. Files of failed processes are never touched.
+- `Runner#rebuild_index!` rewrites the index from storage without running any process.
+- `Adapter#list_sitemaps` for the `:file_system`, `:aws_sdk` and `:noop` adapters.
+- `sitemaps.prune_sitemap` event.
+
+### Fixed
+- Partial runs preloaded the existing index by fetching `config.url` over HTTP, which failed whenever the stored URL is not publicly routable (e.g. behind the middleware `storage_prefix`) and silently dropped every shard not regenerated by the run. The index is now read through the adapter storage.
+
+## 0.1.2 - 2026-07-17
+
+### Added
+- Middleware `aliases:` option: maps an incoming public request path to another public request path (applied before the prefix options), so the same content can be served at multiple locations without a redirect — e.g. `aliases: { "/sitemap.xml" => "/sitemap_index.xml" }`. Accepts a hash or a callable returning a hash.
+
 ## 0.1.1 - 2026-05-12
 
 ### Fixed

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    site_maps (0.1.1)
+    site_maps (0.2.0)
       builder (~> 3.0)
       concurrent-ruby (>= 1.1)
       rack (>= 2.0)
@@ -37,7 +37,7 @@ GEM
     bigdecimal (4.1.1)
     builder (3.3.0)
     coderay (1.1.3)
-    concurrent-ruby (1.3.6)
+    concurrent-ruby (1.3.8)
     crack (1.0.1)
       bigdecimal
       rexml
@@ -64,7 +64,7 @@ GEM
       reline (>= 0.6.0)
     public_suffix (7.0.5)
     racc (1.8.1)
-    rack (3.2.6)
+    rack (3.2.8)
     rainbow (3.1.1)
     regexp_parser (2.12.0)
     reline (0.6.3)
@@ -126,7 +126,7 @@ GEM
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
-    zeitwerk (2.7.5)
+    zeitwerk (2.8.3)
 
 PLATFORMS
   x86_64-linux

data/README.md

@@ -1,4 +1,9 @@
-# SiteMaps
+<h1 align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/brand/lockup-sitemaps-on-dark.svg">
+    <img alt="SiteMaps" src="docs/brand/lockup-sitemaps-on-light.svg" width="310">
+  </picture>
+</h1>
 
 A concurrent, incremental sitemap generator for Ruby. Framework-agnostic with built-in Rails support.
 
@@ -109,6 +114,7 @@ SiteMaps.use(:file_system, url: "https://example.com/sitemap.xml.gz", directory:
 | `xsl_index_stylesheet_url` | `nil` | URL of the XSL stylesheet for the sitemap index. |
 | `ping_search_engines` | `false` | Ping search engines after sitemap generation. |
 | `ping_engines` | `nil` | Custom engines hash. Defaults to Bing when `nil`. |
+| `index_from_storage` | `false` | Build the sitemap index from the files found in storage. The index survives failed processes and lists every stored shard. See [Index generation](docs/processes.md#index-generation). |
 
 ### Gzip Compression
 
@@ -269,6 +275,7 @@ Use these when the public URL path and the storage path differ:
 |---|---|---|
 | `public_prefix:` | Public URL has an extra prefix → strip it to find the file | Stored at `/sitemap.xml`, served at `/sitemaps/tenant/sitemap.xml` |
 | `storage_prefix:` | Storage has an extra prefix → prepend it to the public path | Stored at `/sitemaps/tenant/sitemap.xml`, served at `/sitemap.xml` |
+| `aliases:` | Serve one public path's content at another public path (no redirect) | `/sitemap.xml` serves the content of `/sitemap_index.xml` |
 
 ```ruby
 # Sitemaps stored at /sitemaps/{slug}/sitemap.xml, served at /sitemap.xml
@@ -283,6 +290,20 @@ Rails.application.middleware.insert_after MultitenancyMiddleware, SiteMaps::Midd
   adapter: -> { ... }
 ```
 
+`aliases:` maps an incoming public request path to another public request path,
+applied before the prefix options. Use it to serve the same content at multiple
+locations — for example, to answer the conventional `/sitemap.xml` with the
+sitemap index that is stored/served as `/sitemap_index.xml`:
+
+```ruby
+Rails.application.middleware.insert_after MultitenancyMiddleware, SiteMaps::Middleware,
+  aliases: { "/sitemap.xml" => "/sitemap_index.xml" },
+  storage_prefix: -> { site = Current.site; "/sitemaps/#{site.slug}" if site },
+  adapter: -> { ... }
+```
+
+It accepts a hash or a callable (0-arg or 1-arg receiving `env`) returning a hash.
+
 XSL stylesheet requests (`/_sitemap-stylesheet.xsl`, `/_sitemap-index-stylesheet.xsl`) are served directly without resolving the adapter or prefix.
 
 ### Thread safety
@@ -536,6 +557,7 @@ use SiteMaps::Middleware,
   adapter: SiteMaps.current_adapter,        # defaults to SiteMaps.current_adapter
   public_prefix: nil,                       # strip this prefix from the public URL before lookup
   storage_prefix: nil,                      # prepend this prefix to the public URL for storage lookup
+  aliases: nil,                             # map a public path to another public path, e.g. { "/sitemap.xml" => "/sitemap_index.xml" }
   x_robots_tag: "noindex, follow",          # default
   cache_control: "public, max-age=3600"     # default
 ```

data/docs/adapters.md

@@ -138,6 +138,7 @@ end
 | `#write(url, raw_data, **kwargs)` | Persist `raw_data` at the location implied by `url`. |
 | `#read(url)` | Return `[raw_data, { content_type: '…' }]` for the given URL. |
 | `#delete(url)` | Remove the file at the URL. |
+| `#list_sitemaps` | (optional) Return a `SiteMaps::Builder::SitemapIndex::Item` for every stored sitemap file. Required by `index_from_storage`. |
 | `.config_class` | (optional) Return a `Configuration` subclass to expose adapter-specific settings. |
 
 The adapter base class handles everything else: URL filters, the process registry, and thread-safe URL tracking.

data/docs/brand/BRAND.md

@@ -0,0 +1,65 @@
+# SiteMaps brand kit
+
+## The mark
+
+A map pin drawn as one route that is also a pair of angle brackets. The `<` and `>` sides meet at the pin's point, and the gap at the top is where the tag opens. The green dot is the URL it holds. From a distance it reads as a pin; up close, as XML.
+
+## Colours
+
+| Role  | Light background | Dark background |
+|-------|------------------|-----------------|
+| Ink   | `#1a2233`        | `#e3e9f3`       |
+| Green | `#1f9d6b`        | `#1f9d6b`        |
+| Tile (app icons) | `#1a2233` | `#1a2233` |
+
+Green is reserved for the dot. The ink and line weight match the Lepus kit, so the libraries read as one family.
+
+## Clear space and minimum size
+
+- Clear space: keep at least a quarter of the mark's height empty on every side.
+- `mark*.svg`: 48 px and up.
+- `mark-small*.svg` / `favicon.svg`: 16 to 48 px. Its line is heavier so it stays sharp at favicon sizes. Do not use it large.
+- `lockup-sitemaps*`: 120 px wide minimum.
+
+## Which file where
+
+| Use | File |
+|-----|------|
+| README header | `lockup-sitemaps-on-light.svg` + `lockup-sitemaps-on-dark.svg` in a `<picture>` (below) |
+| Web page header that follows the OS theme | `lockup-sitemaps.svg`, `mark.svg` (ink switches with `prefers-color-scheme`) |
+| Inline in an app that sets its own text colour | `*-mono.svg` (everything is `currentColor`) |
+| Fixed background you control | `*-on-light.svg` / `*-on-dark.svg` |
+| Browser tab | `favicon.svg` (adaptive), with `favicon.ico` (16/32/48) as fallback |
+| iOS home screen | `apple-touch-icon.png` (180, solid tile) |
+| Web manifest / PWA | `icon-512.png` (solid tile, mark inside the maskable safe zone) |
+| Legacy PNG favicons | `favicon-16.png`, `favicon-32.png` (transparent, light-background ink) |
+
+All wordmark text is outlined Overpass (SIL Open Font License), so no font is needed to render it.
+
+### README
+
+GitHub follows the viewer's GitHub theme only through `<picture>`, so use the light/dark pair rather than the adaptive file:
+
+```html
+<h1 align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/brand/lockup-sitemaps-on-dark.svg">
+    <img alt="SiteMaps" src="docs/brand/lockup-sitemaps-on-light.svg" width="310">
+  </picture>
+</h1>
+```
+
+### HTML head
+
+```html
+<link rel="icon" href="/favicon.ico" sizes="48x48">
+<link rel="icon" href="/favicon.svg" type="image/svg+xml">
+<link rel="apple-touch-icon" href="/apple-touch-icon.png">
+```
+
+## Don'ts
+
+- Don't redraw the wordmark in live text or another typeface.
+- Don't stretch, rotate, outline or add effects to the mark.
+- Don't put the ink mark on mid-tone or busy backgrounds; use the tile or the mono file instead.
+- Don't recolour the line in the accent or put the dot in ink (except in the mono files).

data/docs/brand/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="SiteMaps"><title>SiteMaps</title><style>.i{stroke:#1a2233}.f{fill:#1a2233}@media (prefers-color-scheme:dark){.i{stroke:#e3e9f3}.f{fill:#e3e9f3}}</style><path class="i" d="M23 9 L11 28 L32 58 L53 28 L41 9" fill="none" stroke-width="8" stroke-linecap="round" stroke-linejoin="round"/><circle cx="32" cy="28" r="7" fill="#1f9d6b"/></svg>

data/docs/brand/lockup-sitemaps-mono.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="-6.00 -64.40 361.08 84.00" width="387" height="90" role="img" aria-label="SiteMaps"><title>SiteMaps</title><g transform="translate(-11.79 -61.50) scale(1.2414)"><path stroke="currentColor" d="M24 10 L12 28 L32 57 L52 28 L40 10" fill="none" stroke-width="7" stroke-linecap="round" stroke-linejoin="round"/><circle cx="32" cy="28" r="6" fill="currentColor"/></g><path fill="currentColor" d="M95.16 0.77Q90.87 0.77 87.35 -0.77Q83.84 -2.31 81.32 -5.16Q78.79 -8 77.49 -11.93L85.76 -15.03Q87.23 -11.9 89.75 -9.9Q92.27 -7.91 95.39 -7.91Q98.57 -7.91 100.5 -9.18Q102.43 -10.45 102.43 -12.9Q102.43 -14.55 101.31 -15.64Q100.19 -16.74 98.23 -17.55Q96.27 -18.37 93.75 -19.2Q91.26 -20.04 88.69 -21.04Q86.13 -22.05 83.99 -23.56Q81.86 -25.06 80.55 -27.38Q79.25 -29.69 79.25 -33.11Q79.25 -36.51 81.06 -39.34Q82.87 -42.17 86.31 -43.87Q89.75 -45.57 94.64 -45.57Q98.68 -45.57 101.81 -44.14Q104.94 -42.72 106.99 -40.28Q109.04 -37.85 109.86 -34.8L101.67 -32.1Q100.74 -34.14 99 -35.52Q97.26 -36.9 94.16 -36.9Q91.42 -36.9 89.93 -35.88Q88.44 -34.87 88.44 -32.96Q88.44 -31.72 89.45 -30.84Q90.46 -29.96 92.24 -29.25Q94.01 -28.53 96.31 -27.75Q99.06 -26.83 101.78 -25.71Q104.49 -24.58 106.72 -22.95Q108.95 -21.32 110.29 -18.88Q111.62 -16.44 111.62 -12.88Q111.62 -8.54 109.43 -5.5Q107.24 -2.45 103.51 -0.84Q99.79 0.77 95.16 0.77ZM119.58 0V-32.7H128.37V0ZM123.97 -36.2Q121.89 -36.2 120.38 -37.71Q118.87 -39.21 118.87 -41.29Q118.87 -43.36 120.36 -44.84Q121.84 -46.31 123.97 -46.31Q126.16 -46.31 127.62 -44.86Q129.08 -43.41 129.08 -41.29Q129.08 -39.16 127.59 -37.68Q126.11 -36.2 123.97 -36.2ZM147.89 0.77Q143.81 0.77 141.8 -1.43Q139.8 -3.62 139.8 -8.01V-24.97H135.2V-32.7H139.8V-42.04L148.54 -46.21V-32.7H155.73V-24.97H148.54V-9.31Q148.54 -8.07 149.1 -7.45Q149.66 -6.82 150.83 -6.82Q153.25 -6.82 156.13 -8.19L155.13 -0.7Q153.61 0.01 151.83 0.39Q150.05 0.77 147.89 0.77ZM177.38 0.77Q172.59 0.77 169.13 -1.31Q165.68 -3.39 163.83 -7.24Q161.98 -11.08 161.98 -16.38Q161.98 -21.64 163.87 -25.48Q165.75 -29.31 169.21 -31.39Q172.67 -33.47 177.38 -33.47Q181.44 -33.47 184.73 -31.8Q188.02 -30.12 189.96 -26.68Q191.9 -23.24 191.9 -17.97Q191.9 -17.1 191.87 -15.84Q191.83 -14.57 191.66 -13.31H170.59Q170.66 -11.31 171.5 -9.82Q172.35 -8.34 173.85 -7.52Q175.35 -6.71 177.4 -6.71Q179.82 -6.71 181.51 -7.49Q183.21 -8.28 184.78 -10.07L189.83 -4.94Q187.62 -2.35 184.55 -0.79Q181.47 0.77 177.38 0.77ZM170.68 -20.02H183.46Q183.25 -21.93 182.48 -23.27Q181.71 -24.6 180.38 -25.3Q179.06 -26 177.17 -26Q174.59 -26 172.8 -24.46Q171.02 -22.92 170.68 -20.02ZM220.79 0.77 209.55 -23.07Q209.43 -23.37 209.27 -23.77Q209.11 -24.18 208.96 -24.65Q208.98 -24.25 208.99 -23.79Q209 -23.32 209 -23.01V0H199.8V-44.8H209.09L219.89 -20.95Q220.23 -20.25 220.49 -19.6Q220.76 -18.94 220.99 -18.2Q221.25 -18.94 221.5 -19.63Q221.75 -20.31 222.04 -20.95L233.14 -44.8H241.73V0H232.53V-23.07Q232.53 -23.45 232.54 -23.92Q232.54 -24.39 232.55 -24.67Q232.4 -24.29 232.22 -23.87Q232.05 -23.45 231.9 -23.14ZM261.34 0.77Q255.95 0.77 252.82 -2.11Q249.69 -4.99 249.69 -9.88Q249.69 -13.08 251.34 -15.48Q252.98 -17.89 255.92 -19.22Q258.87 -20.54 262.78 -20.54Q264.85 -20.54 266.82 -20.2Q268.79 -19.85 270.16 -19.2V-21.15Q270.16 -23.57 268.67 -24.84Q267.19 -26.1 264.38 -26.1Q261.97 -26.1 259.43 -25.24Q256.9 -24.37 254.18 -22.63L251.51 -29.45Q254.43 -31.39 257.99 -32.43Q261.56 -33.47 265.24 -33.47Q272.06 -33.47 275.45 -30.31Q278.84 -27.14 278.84 -20.83V0H270.16V-2.5Q268.6 -0.9 266.34 -0.07Q264.08 0.77 261.34 0.77ZM263.5 -6.6Q265.39 -6.6 267.1 -7.28Q268.81 -7.95 270.16 -9.2V-12.48Q268.88 -13.04 267.34 -13.34Q265.8 -13.63 264.22 -13.63Q261.43 -13.63 259.85 -12.66Q258.27 -11.68 258.27 -9.92Q258.27 -8.36 259.64 -7.48Q261.01 -6.6 263.5 -6.6ZM287.93 12.99V-32.7H296.72V-30.41Q299.14 -33.47 303.52 -33.47Q307.73 -33.47 310.77 -31.4Q313.81 -29.34 315.44 -25.5Q317.08 -21.66 317.08 -16.33Q317.08 -11.21 315.36 -7.37Q313.65 -3.53 310.57 -1.38Q307.5 0.77 303.42 0.77Q301.26 0.77 299.58 0Q297.9 -0.76 296.72 -2.25V9.04ZM302.05 -7.69Q305.02 -7.69 306.64 -9.96Q308.26 -12.24 308.26 -16.33Q308.26 -20.51 306.64 -22.77Q305.03 -25.02 302.05 -25.02Q300.3 -25.02 299.02 -24.46Q297.74 -23.9 296.72 -22.71V-10.11Q297.29 -9.03 298.77 -8.36Q300.24 -7.69 302.05 -7.69ZM336.21 0.77Q332.26 0.77 328.66 -0.91Q325.05 -2.59 322.98 -5.4L328.64 -10.18Q330.27 -8.5 332.4 -7.49Q334.54 -6.48 336.49 -6.48Q338.75 -6.48 339.97 -7.2Q341.18 -7.92 341.18 -9.25Q341.18 -10.07 340.61 -10.74Q340.03 -11.4 338.48 -12.14Q336.94 -12.88 334.06 -13.93Q328.49 -15.94 326.22 -18.28Q323.94 -20.63 323.94 -24.27Q323.94 -28.39 327.28 -30.93Q330.62 -33.47 335.98 -33.47Q339.62 -33.47 342.71 -32.09Q345.81 -30.71 348.06 -28.08L342.38 -23.4Q339.51 -26.23 335.81 -26.23Q334.05 -26.23 332.95 -25.58Q331.85 -24.94 331.85 -23.91Q331.85 -22.87 333.17 -22.03Q334.48 -21.2 338.14 -20.06Q341.97 -18.91 344.39 -17.4Q346.81 -15.9 347.95 -13.9Q349.08 -11.9 349.08 -9.28Q349.08 -4.58 345.65 -1.9Q342.21 0.77 336.21 0.77Z"/></svg>

data/docs/brand/lockup-sitemaps-on-dark.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="-6.00 -64.40 361.08 84.00" width="387" height="90" role="img" aria-label="SiteMaps"><title>SiteMaps</title><g transform="translate(-11.79 -61.50) scale(1.2414)"><path stroke="#e3e9f3" d="M24 10 L12 28 L32 57 L52 28 L40 10" fill="none" stroke-width="7" stroke-linecap="round" stroke-linejoin="round"/><circle cx="32" cy="28" r="6" fill="#1f9d6b"/></g><path fill="#e3e9f3" d="M95.16 0.77Q90.87 0.77 87.35 -0.77Q83.84 -2.31 81.32 -5.16Q78.79 -8 77.49 -11.93L85.76 -15.03Q87.23 -11.9 89.75 -9.9Q92.27 -7.91 95.39 -7.91Q98.57 -7.91 100.5 -9.18Q102.43 -10.45 102.43 -12.9Q102.43 -14.55 101.31 -15.64Q100.19 -16.74 98.23 -17.55Q96.27 -18.37 93.75 -19.2Q91.26 -20.04 88.69 -21.04Q86.13 -22.05 83.99 -23.56Q81.86 -25.06 80.55 -27.38Q79.25 -29.69 79.25 -33.11Q79.25 -36.51 81.06 -39.34Q82.87 -42.17 86.31 -43.87Q89.75 -45.57 94.64 -45.57Q98.68 -45.57 101.81 -44.14Q104.94 -42.72 106.99 -40.28Q109.04 -37.85 109.86 -34.8L101.67 -32.1Q100.74 -34.14 99 -35.52Q97.26 -36.9 94.16 -36.9Q91.42 -36.9 89.93 -35.88Q88.44 -34.87 88.44 -32.96Q88.44 -31.72 89.45 -30.84Q90.46 -29.96 92.24 -29.25Q94.01 -28.53 96.31 -27.75Q99.06 -26.83 101.78 -25.71Q104.49 -24.58 106.72 -22.95Q108.95 -21.32 110.29 -18.88Q111.62 -16.44 111.62 -12.88Q111.62 -8.54 109.43 -5.5Q107.24 -2.45 103.51 -0.84Q99.79 0.77 95.16 0.77ZM119.58 0V-32.7H128.37V0ZM123.97 -36.2Q121.89 -36.2 120.38 -37.71Q118.87 -39.21 118.87 -41.29Q118.87 -43.36 120.36 -44.84Q121.84 -46.31 123.97 -46.31Q126.16 -46.31 127.62 -44.86Q129.08 -43.41 129.08 -41.29Q129.08 -39.16 127.59 -37.68Q126.11 -36.2 123.97 -36.2ZM147.89 0.77Q143.81 0.77 141.8 -1.43Q139.8 -3.62 139.8 -8.01V-24.97H135.2V-32.7H139.8V-42.04L148.54 -46.21V-32.7H155.73V-24.97H148.54V-9.31Q148.54 -8.07 149.1 -7.45Q149.66 -6.82 150.83 -6.82Q153.25 -6.82 156.13 -8.19L155.13 -0.7Q153.61 0.01 151.83 0.39Q150.05 0.77 147.89 0.77ZM177.38 0.77Q172.59 0.77 169.13 -1.31Q165.68 -3.39 163.83 -7.24Q161.98 -11.08 161.98 -16.38Q161.98 -21.64 163.87 -25.48Q165.75 -29.31 169.21 -31.39Q172.67 -33.47 177.38 -33.47Q181.44 -33.47 184.73 -31.8Q188.02 -30.12 189.96 -26.68Q191.9 -23.24 191.9 -17.97Q191.9 -17.1 191.87 -15.84Q191.83 -14.57 191.66 -13.31H170.59Q170.66 -11.31 171.5 -9.82Q172.35 -8.34 173.85 -7.52Q175.35 -6.71 177.4 -6.71Q179.82 -6.71 181.51 -7.49Q183.21 -8.28 184.78 -10.07L189.83 -4.94Q187.62 -2.35 184.55 -0.79Q181.47 0.77 177.38 0.77ZM170.68 -20.02H183.46Q183.25 -21.93 182.48 -23.27Q181.71 -24.6 180.38 -25.3Q179.06 -26 177.17 -26Q174.59 -26 172.8 -24.46Q171.02 -22.92 170.68 -20.02ZM220.79 0.77 209.55 -23.07Q209.43 -23.37 209.27 -23.77Q209.11 -24.18 208.96 -24.65Q208.98 -24.25 208.99 -23.79Q209 -23.32 209 -23.01V0H199.8V-44.8H209.09L219.89 -20.95Q220.23 -20.25 220.49 -19.6Q220.76 -18.94 220.99 -18.2Q221.25 -18.94 221.5 -19.63Q221.75 -20.31 222.04 -20.95L233.14 -44.8H241.73V0H232.53V-23.07Q232.53 -23.45 232.54 -23.92Q232.54 -24.39 232.55 -24.67Q232.4 -24.29 232.22 -23.87Q232.05 -23.45 231.9 -23.14ZM261.34 0.77Q255.95 0.77 252.82 -2.11Q249.69 -4.99 249.69 -9.88Q249.69 -13.08 251.34 -15.48Q252.98 -17.89 255.92 -19.22Q258.87 -20.54 262.78 -20.54Q264.85 -20.54 266.82 -20.2Q268.79 -19.85 270.16 -19.2V-21.15Q270.16 -23.57 268.67 -24.84Q267.19 -26.1 264.38 -26.1Q261.97 -26.1 259.43 -25.24Q256.9 -24.37 254.18 -22.63L251.51 -29.45Q254.43 -31.39 257.99 -32.43Q261.56 -33.47 265.24 -33.47Q272.06 -33.47 275.45 -30.31Q278.84 -27.14 278.84 -20.83V0H270.16V-2.5Q268.6 -0.9 266.34 -0.07Q264.08 0.77 261.34 0.77ZM263.5 -6.6Q265.39 -6.6 267.1 -7.28Q268.81 -7.95 270.16 -9.2V-12.48Q268.88 -13.04 267.34 -13.34Q265.8 -13.63 264.22 -13.63Q261.43 -13.63 259.85 -12.66Q258.27 -11.68 258.27 -9.92Q258.27 -8.36 259.64 -7.48Q261.01 -6.6 263.5 -6.6ZM287.93 12.99V-32.7H296.72V-30.41Q299.14 -33.47 303.52 -33.47Q307.73 -33.47 310.77 -31.4Q313.81 -29.34 315.44 -25.5Q317.08 -21.66 317.08 -16.33Q317.08 -11.21 315.36 -7.37Q313.65 -3.53 310.57 -1.38Q307.5 0.77 303.42 0.77Q301.26 0.77 299.58 0Q297.9 -0.76 296.72 -2.25V9.04ZM302.05 -7.69Q305.02 -7.69 306.64 -9.96Q308.26 -12.24 308.26 -16.33Q308.26 -20.51 306.64 -22.77Q305.03 -25.02 302.05 -25.02Q300.3 -25.02 299.02 -24.46Q297.74 -23.9 296.72 -22.71V-10.11Q297.29 -9.03 298.77 -8.36Q300.24 -7.69 302.05 -7.69ZM336.21 0.77Q332.26 0.77 328.66 -0.91Q325.05 -2.59 322.98 -5.4L328.64 -10.18Q330.27 -8.5 332.4 -7.49Q334.54 -6.48 336.49 -6.48Q338.75 -6.48 339.97 -7.2Q341.18 -7.92 341.18 -9.25Q341.18 -10.07 340.61 -10.74Q340.03 -11.4 338.48 -12.14Q336.94 -12.88 334.06 -13.93Q328.49 -15.94 326.22 -18.28Q323.94 -20.63 323.94 -24.27Q323.94 -28.39 327.28 -30.93Q330.62 -33.47 335.98 -33.47Q339.62 -33.47 342.71 -32.09Q345.81 -30.71 348.06 -28.08L342.38 -23.4Q339.51 -26.23 335.81 -26.23Q334.05 -26.23 332.95 -25.58Q331.85 -24.94 331.85 -23.91Q331.85 -22.87 333.17 -22.03Q334.48 -21.2 338.14 -20.06Q341.97 -18.91 344.39 -17.4Q346.81 -15.9 347.95 -13.9Q349.08 -11.9 349.08 -9.28Q349.08 -4.58 345.65 -1.9Q342.21 0.77 336.21 0.77Z"/></svg>

data/docs/brand/lockup-sitemaps-on-light.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="-6.00 -64.40 361.08 84.00" width="387" height="90" role="img" aria-label="SiteMaps"><title>SiteMaps</title><g transform="translate(-11.79 -61.50) scale(1.2414)"><path stroke="#1a2233" d="M24 10 L12 28 L32 57 L52 28 L40 10" fill="none" stroke-width="7" stroke-linecap="round" stroke-linejoin="round"/><circle cx="32" cy="28" r="6" fill="#1f9d6b"/></g><path fill="#1a2233" d="M95.16 0.77Q90.87 0.77 87.35 -0.77Q83.84 -2.31 81.32 -5.16Q78.79 -8 77.49 -11.93L85.76 -15.03Q87.23 -11.9 89.75 -9.9Q92.27 -7.91 95.39 -7.91Q98.57 -7.91 100.5 -9.18Q102.43 -10.45 102.43 -12.9Q102.43 -14.55 101.31 -15.64Q100.19 -16.74 98.23 -17.55Q96.27 -18.37 93.75 -19.2Q91.26 -20.04 88.69 -21.04Q86.13 -22.05 83.99 -23.56Q81.86 -25.06 80.55 -27.38Q79.25 -29.69 79.25 -33.11Q79.25 -36.51 81.06 -39.34Q82.87 -42.17 86.31 -43.87Q89.75 -45.57 94.64 -45.57Q98.68 -45.57 101.81 -44.14Q104.94 -42.72 106.99 -40.28Q109.04 -37.85 109.86 -34.8L101.67 -32.1Q100.74 -34.14 99 -35.52Q97.26 -36.9 94.16 -36.9Q91.42 -36.9 89.93 -35.88Q88.44 -34.87 88.44 -32.96Q88.44 -31.72 89.45 -30.84Q90.46 -29.96 92.24 -29.25Q94.01 -28.53 96.31 -27.75Q99.06 -26.83 101.78 -25.71Q104.49 -24.58 106.72 -22.95Q108.95 -21.32 110.29 -18.88Q111.62 -16.44 111.62 -12.88Q111.62 -8.54 109.43 -5.5Q107.24 -2.45 103.51 -0.84Q99.79 0.77 95.16 0.77ZM119.58 0V-32.7H128.37V0ZM123.97 -36.2Q121.89 -36.2 120.38 -37.71Q118.87 -39.21 118.87 -41.29Q118.87 -43.36 120.36 -44.84Q121.84 -46.31 123.97 -46.31Q126.16 -46.31 127.62 -44.86Q129.08 -43.41 129.08 -41.29Q129.08 -39.16 127.59 -37.68Q126.11 -36.2 123.97 -36.2ZM147.89 0.77Q143.81 0.77 141.8 -1.43Q139.8 -3.62 139.8 -8.01V-24.97H135.2V-32.7H139.8V-42.04L148.54 -46.21V-32.7H155.73V-24.97H148.54V-9.31Q148.54 -8.07 149.1 -7.45Q149.66 -6.82 150.83 -6.82Q153.25 -6.82 156.13 -8.19L155.13 -0.7Q153.61 0.01 151.83 0.39Q150.05 0.77 147.89 0.77ZM177.38 0.77Q172.59 0.77 169.13 -1.31Q165.68 -3.39 163.83 -7.24Q161.98 -11.08 161.98 -16.38Q161.98 -21.64 163.87 -25.48Q165.75 -29.31 169.21 -31.39Q172.67 -33.47 177.38 -33.47Q181.44 -33.47 184.73 -31.8Q188.02 -30.12 189.96 -26.68Q191.9 -23.24 191.9 -17.97Q191.9 -17.1 191.87 -15.84Q191.83 -14.57 191.66 -13.31H170.59Q170.66 -11.31 171.5 -9.82Q172.35 -8.34 173.85 -7.52Q175.35 -6.71 177.4 -6.71Q179.82 -6.71 181.51 -7.49Q183.21 -8.28 184.78 -10.07L189.83 -4.94Q187.62 -2.35 184.55 -0.79Q181.47 0.77 177.38 0.77ZM170.68 -20.02H183.46Q183.25 -21.93 182.48 -23.27Q181.71 -24.6 180.38 -25.3Q179.06 -26 177.17 -26Q174.59 -26 172.8 -24.46Q171.02 -22.92 170.68 -20.02ZM220.79 0.77 209.55 -23.07Q209.43 -23.37 209.27 -23.77Q209.11 -24.18 208.96 -24.65Q208.98 -24.25 208.99 -23.79Q209 -23.32 209 -23.01V0H199.8V-44.8H209.09L219.89 -20.95Q220.23 -20.25 220.49 -19.6Q220.76 -18.94 220.99 -18.2Q221.25 -18.94 221.5 -19.63Q221.75 -20.31 222.04 -20.95L233.14 -44.8H241.73V0H232.53V-23.07Q232.53 -23.45 232.54 -23.92Q232.54 -24.39 232.55 -24.67Q232.4 -24.29 232.22 -23.87Q232.05 -23.45 231.9 -23.14ZM261.34 0.77Q255.95 0.77 252.82 -2.11Q249.69 -4.99 249.69 -9.88Q249.69 -13.08 251.34 -15.48Q252.98 -17.89 255.92 -19.22Q258.87 -20.54 262.78 -20.54Q264.85 -20.54 266.82 -20.2Q268.79 -19.85 270.16 -19.2V-21.15Q270.16 -23.57 268.67 -24.84Q267.19 -26.1 264.38 -26.1Q261.97 -26.1 259.43 -25.24Q256.9 -24.37 254.18 -22.63L251.51 -29.45Q254.43 -31.39 257.99 -32.43Q261.56 -33.47 265.24 -33.47Q272.06 -33.47 275.45 -30.31Q278.84 -27.14 278.84 -20.83V0H270.16V-2.5Q268.6 -0.9 266.34 -0.07Q264.08 0.77 261.34 0.77ZM263.5 -6.6Q265.39 -6.6 267.1 -7.28Q268.81 -7.95 270.16 -9.2V-12.48Q268.88 -13.04 267.34 -13.34Q265.8 -13.63 264.22 -13.63Q261.43 -13.63 259.85 -12.66Q258.27 -11.68 258.27 -9.92Q258.27 -8.36 259.64 -7.48Q261.01 -6.6 263.5 -6.6ZM287.93 12.99V-32.7H296.72V-30.41Q299.14 -33.47 303.52 -33.47Q307.73 -33.47 310.77 -31.4Q313.81 -29.34 315.44 -25.5Q317.08 -21.66 317.08 -16.33Q317.08 -11.21 315.36 -7.37Q313.65 -3.53 310.57 -1.38Q307.5 0.77 303.42 0.77Q301.26 0.77 299.58 0Q297.9 -0.76 296.72 -2.25V9.04ZM302.05 -7.69Q305.02 -7.69 306.64 -9.96Q308.26 -12.24 308.26 -16.33Q308.26 -20.51 306.64 -22.77Q305.03 -25.02 302.05 -25.02Q300.3 -25.02 299.02 -24.46Q297.74 -23.9 296.72 -22.71V-10.11Q297.29 -9.03 298.77 -8.36Q300.24 -7.69 302.05 -7.69ZM336.21 0.77Q332.26 0.77 328.66 -0.91Q325.05 -2.59 322.98 -5.4L328.64 -10.18Q330.27 -8.5 332.4 -7.49Q334.54 -6.48 336.49 -6.48Q338.75 -6.48 339.97 -7.2Q341.18 -7.92 341.18 -9.25Q341.18 -10.07 340.61 -10.74Q340.03 -11.4 338.48 -12.14Q336.94 -12.88 334.06 -13.93Q328.49 -15.94 326.22 -18.28Q323.94 -20.63 323.94 -24.27Q323.94 -28.39 327.28 -30.93Q330.62 -33.47 335.98 -33.47Q339.62 -33.47 342.71 -32.09Q345.81 -30.71 348.06 -28.08L342.38 -23.4Q339.51 -26.23 335.81 -26.23Q334.05 -26.23 332.95 -25.58Q331.85 -24.94 331.85 -23.91Q331.85 -22.87 333.17 -22.03Q334.48 -21.2 338.14 -20.06Q341.97 -18.91 344.39 -17.4Q346.81 -15.9 347.95 -13.9Q349.08 -11.9 349.08 -9.28Q349.08 -4.58 345.65 -1.9Q342.21 0.77 336.21 0.77Z"/></svg>

data/docs/brand/lockup-sitemaps.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="-6.00 -64.40 361.08 84.00" width="387" height="90" role="img" aria-label="SiteMaps"><title>SiteMaps</title><style>.i{stroke:#1a2233}.f{fill:#1a2233}@media (prefers-color-scheme:dark){.i{stroke:#e3e9f3}.f{fill:#e3e9f3}}</style><g transform="translate(-11.79 -61.50) scale(1.2414)"><path class="i" d="M24 10 L12 28 L32 57 L52 28 L40 10" fill="none" stroke-width="7" stroke-linecap="round" stroke-linejoin="round"/><circle cx="32" cy="28" r="6" fill="#1f9d6b"/></g><path class="f" d="M95.16 0.77Q90.87 0.77 87.35 -0.77Q83.84 -2.31 81.32 -5.16Q78.79 -8 77.49 -11.93L85.76 -15.03Q87.23 -11.9 89.75 -9.9Q92.27 -7.91 95.39 -7.91Q98.57 -7.91 100.5 -9.18Q102.43 -10.45 102.43 -12.9Q102.43 -14.55 101.31 -15.64Q100.19 -16.74 98.23 -17.55Q96.27 -18.37 93.75 -19.2Q91.26 -20.04 88.69 -21.04Q86.13 -22.05 83.99 -23.56Q81.86 -25.06 80.55 -27.38Q79.25 -29.69 79.25 -33.11Q79.25 -36.51 81.06 -39.34Q82.87 -42.17 86.31 -43.87Q89.75 -45.57 94.64 -45.57Q98.68 -45.57 101.81 -44.14Q104.94 -42.72 106.99 -40.28Q109.04 -37.85 109.86 -34.8L101.67 -32.1Q100.74 -34.14 99 -35.52Q97.26 -36.9 94.16 -36.9Q91.42 -36.9 89.93 -35.88Q88.44 -34.87 88.44 -32.96Q88.44 -31.72 89.45 -30.84Q90.46 -29.96 92.24 -29.25Q94.01 -28.53 96.31 -27.75Q99.06 -26.83 101.78 -25.71Q104.49 -24.58 106.72 -22.95Q108.95 -21.32 110.29 -18.88Q111.62 -16.44 111.62 -12.88Q111.62 -8.54 109.43 -5.5Q107.24 -2.45 103.51 -0.84Q99.79 0.77 95.16 0.77ZM119.58 0V-32.7H128.37V0ZM123.97 -36.2Q121.89 -36.2 120.38 -37.71Q118.87 -39.21 118.87 -41.29Q118.87 -43.36 120.36 -44.84Q121.84 -46.31 123.97 -46.31Q126.16 -46.31 127.62 -44.86Q129.08 -43.41 129.08 -41.29Q129.08 -39.16 127.59 -37.68Q126.11 -36.2 123.97 -36.2ZM147.89 0.77Q143.81 0.77 141.8 -1.43Q139.8 -3.62 139.8 -8.01V-24.97H135.2V-32.7H139.8V-42.04L148.54 -46.21V-32.7H155.73V-24.97H148.54V-9.31Q148.54 -8.07 149.1 -7.45Q149.66 -6.82 150.83 -6.82Q153.25 -6.82 156.13 -8.19L155.13 -0.7Q153.61 0.01 151.83 0.39Q150.05 0.77 147.89 0.77ZM177.38 0.77Q172.59 0.77 169.13 -1.31Q165.68 -3.39 163.83 -7.24Q161.98 -11.08 161.98 -16.38Q161.98 -21.64 163.87 -25.48Q165.75 -29.31 169.21 -31.39Q172.67 -33.47 177.38 -33.47Q181.44 -33.47 184.73 -31.8Q188.02 -30.12 189.96 -26.68Q191.9 -23.24 191.9 -17.97Q191.9 -17.1 191.87 -15.84Q191.83 -14.57 191.66 -13.31H170.59Q170.66 -11.31 171.5 -9.82Q172.35 -8.34 173.85 -7.52Q175.35 -6.71 177.4 -6.71Q179.82 -6.71 181.51 -7.49Q183.21 -8.28 184.78 -10.07L189.83 -4.94Q187.62 -2.35 184.55 -0.79Q181.47 0.77 177.38 0.77ZM170.68 -20.02H183.46Q183.25 -21.93 182.48 -23.27Q181.71 -24.6 180.38 -25.3Q179.06 -26 177.17 -26Q174.59 -26 172.8 -24.46Q171.02 -22.92 170.68 -20.02ZM220.79 0.77 209.55 -23.07Q209.43 -23.37 209.27 -23.77Q209.11 -24.18 208.96 -24.65Q208.98 -24.25 208.99 -23.79Q209 -23.32 209 -23.01V0H199.8V-44.8H209.09L219.89 -20.95Q220.23 -20.25 220.49 -19.6Q220.76 -18.94 220.99 -18.2Q221.25 -18.94 221.5 -19.63Q221.75 -20.31 222.04 -20.95L233.14 -44.8H241.73V0H232.53V-23.07Q232.53 -23.45 232.54 -23.92Q232.54 -24.39 232.55 -24.67Q232.4 -24.29 232.22 -23.87Q232.05 -23.45 231.9 -23.14ZM261.34 0.77Q255.95 0.77 252.82 -2.11Q249.69 -4.99 249.69 -9.88Q249.69 -13.08 251.34 -15.48Q252.98 -17.89 255.92 -19.22Q258.87 -20.54 262.78 -20.54Q264.85 -20.54 266.82 -20.2Q268.79 -19.85 270.16 -19.2V-21.15Q270.16 -23.57 268.67 -24.84Q267.19 -26.1 264.38 -26.1Q261.97 -26.1 259.43 -25.24Q256.9 -24.37 254.18 -22.63L251.51 -29.45Q254.43 -31.39 257.99 -32.43Q261.56 -33.47 265.24 -33.47Q272.06 -33.47 275.45 -30.31Q278.84 -27.14 278.84 -20.83V0H270.16V-2.5Q268.6 -0.9 266.34 -0.07Q264.08 0.77 261.34 0.77ZM263.5 -6.6Q265.39 -6.6 267.1 -7.28Q268.81 -7.95 270.16 -9.2V-12.48Q268.88 -13.04 267.34 -13.34Q265.8 -13.63 264.22 -13.63Q261.43 -13.63 259.85 -12.66Q258.27 -11.68 258.27 -9.92Q258.27 -8.36 259.64 -7.48Q261.01 -6.6 263.5 -6.6ZM287.93 12.99V-32.7H296.72V-30.41Q299.14 -33.47 303.52 -33.47Q307.73 -33.47 310.77 -31.4Q313.81 -29.34 315.44 -25.5Q317.08 -21.66 317.08 -16.33Q317.08 -11.21 315.36 -7.37Q313.65 -3.53 310.57 -1.38Q307.5 0.77 303.42 0.77Q301.26 0.77 299.58 0Q297.9 -0.76 296.72 -2.25V9.04ZM302.05 -7.69Q305.02 -7.69 306.64 -9.96Q308.26 -12.24 308.26 -16.33Q308.26 -20.51 306.64 -22.77Q305.03 -25.02 302.05 -25.02Q300.3 -25.02 299.02 -24.46Q297.74 -23.9 296.72 -22.71V-10.11Q297.29 -9.03 298.77 -8.36Q300.24 -7.69 302.05 -7.69ZM336.21 0.77Q332.26 0.77 328.66 -0.91Q325.05 -2.59 322.98 -5.4L328.64 -10.18Q330.27 -8.5 332.4 -7.49Q334.54 -6.48 336.49 -6.48Q338.75 -6.48 339.97 -7.2Q341.18 -7.92 341.18 -9.25Q341.18 -10.07 340.61 -10.74Q340.03 -11.4 338.48 -12.14Q336.94 -12.88 334.06 -13.93Q328.49 -15.94 326.22 -18.28Q323.94 -20.63 323.94 -24.27Q323.94 -28.39 327.28 -30.93Q330.62 -33.47 335.98 -33.47Q339.62 -33.47 342.71 -32.09Q345.81 -30.71 348.06 -28.08L342.38 -23.4Q339.51 -26.23 335.81 -26.23Q334.05 -26.23 332.95 -25.58Q331.85 -24.94 331.85 -23.91Q331.85 -22.87 333.17 -22.03Q334.48 -21.2 338.14 -20.06Q341.97 -18.91 344.39 -17.4Q346.81 -15.9 347.95 -13.9Q349.08 -11.9 349.08 -9.28Q349.08 -4.58 345.65 -1.9Q342.21 0.77 336.21 0.77Z"/></svg>

data/docs/brand/mark-mono.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 1 64 64" role="img" aria-label="SiteMaps"><title>SiteMaps</title><path stroke="currentColor" d="M24 10 L12 28 L32 57 L52 28 L40 10" fill="none" stroke-width="7" stroke-linecap="round" stroke-linejoin="round"/><circle cx="32" cy="28" r="6" fill="currentColor"/></svg>

data/docs/brand/mark-on-dark.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 1 64 64" role="img" aria-label="SiteMaps"><title>SiteMaps</title><path stroke="#e3e9f3" d="M24 10 L12 28 L32 57 L52 28 L40 10" fill="none" stroke-width="7" stroke-linecap="round" stroke-linejoin="round"/><circle cx="32" cy="28" r="6" fill="#1f9d6b"/></svg>

data/docs/brand/mark-on-light.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 1 64 64" role="img" aria-label="SiteMaps"><title>SiteMaps</title><path stroke="#1a2233" d="M24 10 L12 28 L32 57 L52 28 L40 10" fill="none" stroke-width="7" stroke-linecap="round" stroke-linejoin="round"/><circle cx="32" cy="28" r="6" fill="#1f9d6b"/></svg>

data/docs/brand/mark-small-mono.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="SiteMaps"><title>SiteMaps</title><path stroke="currentColor" d="M23 9 L11 28 L32 58 L53 28 L41 9" fill="none" stroke-width="8" stroke-linecap="round" stroke-linejoin="round"/><circle cx="32" cy="28" r="7" fill="currentColor"/></svg>

data/docs/brand/mark-small-on-dark.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="SiteMaps"><title>SiteMaps</title><path stroke="#e3e9f3" d="M23 9 L11 28 L32 58 L53 28 L41 9" fill="none" stroke-width="8" stroke-linecap="round" stroke-linejoin="round"/><circle cx="32" cy="28" r="7" fill="#1f9d6b"/></svg>

data/docs/brand/mark-small-on-light.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="SiteMaps"><title>SiteMaps</title><path stroke="#1a2233" d="M23 9 L11 28 L32 58 L53 28 L41 9" fill="none" stroke-width="8" stroke-linecap="round" stroke-linejoin="round"/><circle cx="32" cy="28" r="7" fill="#1f9d6b"/></svg>

data/docs/brand/mark-small.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="SiteMaps"><title>SiteMaps</title><style>.i{stroke:#1a2233}.f{fill:#1a2233}@media (prefers-color-scheme:dark){.i{stroke:#e3e9f3}.f{fill:#e3e9f3}}</style><path class="i" d="M23 9 L11 28 L32 58 L53 28 L41 9" fill="none" stroke-width="8" stroke-linecap="round" stroke-linejoin="round"/><circle cx="32" cy="28" r="7" fill="#1f9d6b"/></svg>

data/docs/brand/mark.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 1 64 64" role="img" aria-label="SiteMaps"><title>SiteMaps</title><style>.i{stroke:#1a2233}.f{fill:#1a2233}@media (prefers-color-scheme:dark){.i{stroke:#e3e9f3}.f{fill:#e3e9f3}}</style><path class="i" d="M24 10 L12 28 L32 57 L52 28 L40 10" fill="none" stroke-width="7" stroke-linecap="round" stroke-linejoin="round"/><circle cx="32" cy="28" r="6" fill="#1f9d6b"/></svg>

data/docs/events.md

@@ -57,6 +57,7 @@ This is subscribed automatically by the CLI.
 | `sitemaps.process_execution` | `process`, `kwargs`, `runtime` |
 | `sitemaps.finalize_urlset` | `url`, `links_count`, `news_count`, `last_modified`, `runtime`, `process` |
 | `sitemaps.ping` | `results` |
+| `sitemaps.prune_sitemap` | `url`, `runtime` |
 
 `process` is a `SiteMaps::Process` struct (`name`, `location_template`, `kwargs_template`, `block`).
 

data/docs/processes.md

@@ -63,6 +63,8 @@ When you call `runner.run`:
 3. Each process builds a `URLSet`. When the set fills up (50,000 links, 1,000 news items, or 50 MB uncompressed), it's finalized and written, and a new URLSet starts — automatically.
 4. After every process finishes, the sitemap index is aggregated and written to `config.url`.
 
+By default the first failing process stops the run and the index is left untouched. With `index_from_storage` the remaining processes still run, the index is written, and the first error is re-raised afterwards.
+
 ## Splitting rules
 
 A URL set is finalized and rolled over when **any** of these apply:
@@ -83,6 +85,32 @@ A sitemap index is produced when:
 
 Otherwise a single `urlset` is written directly at `config.url` (the "inline" optimization).
 
+On a partial run the existing index is read back through the adapter, and the entries of shards that were not regenerated are kept.
+
+### Building the index from storage
+
+Set `index_from_storage` when the index must always reflect what is stored, no matter which processes ran or failed:
+
+```ruby
+SiteMaps.use(:aws_sdk) do
+  configure do |config|
+    config.url = "https://example.com/sitemap.xml"
+    config.index_from_storage = true
+  end
+  # ...
+end
+```
+
+The index then lists every stored file that matches a declared process location, plus the external sitemaps. A successful process deletes the numbered parts it no longer writes. Files of failed processes are left as they were.
+
+To rebuild a lost or stale index without querying any data source:
+
+```ruby
+SiteMaps.generate(config_file: "config/sitemap.rb").rebuild_index!
+```
+
+Adapters need `#list_sitemaps` for this option (built in for `:file_system`, `:aws_sdk` and `:noop`).
+
 ## Adding external sitemaps
 
 Reference third-party or pre-existing sitemaps in the index:

data/lib/site_maps/adapters/adapter.rb

@@ -12,7 +12,11 @@ module SiteMaps::Adapters
       end
     end
 
-    def_delegators :config, :fetch_sitemap_index_links
+    SITEMAP_ENTRY_RE = %r{<sitemap>(.*?)</sitemap>}m
+    LOC_RE = %r{<loc>\s*(.*?)\s*</loc>}m
+    LASTMOD_RE = %r{<lastmod>\s*(.*?)\s*</lastmod>}m
+    XML_ENTITIES = {"&amp;" => "&", "&lt;" => "<", "&gt;" => ">", "&quot;" => '"', "&apos;" => "'"}.freeze
+
     attr_reader :sitemap_index, :processes, :process_mixins
 
     def initialize(**options, &block)
@@ -48,6 +52,28 @@ module SiteMaps::Adapters
       raise NotImplementedError
     end
 
+    # @abstract
+    # @return [Array<SiteMaps::Builder::SitemapIndex::Item>] every sitemap file stored under the sitemap directory
+    # @raise [NotImplementedError] if the adapter can not list its storage
+    def list_sitemaps
+      raise NotImplementedError, "#{self.class} does not support listing stored sitemaps"
+    end
+
+    # Reads the current sitemap index straight from the adapter storage.
+    # Adapters without a #read implementation fall back to fetching the index URL.
+    #
+    # @return [Array<SiteMaps::Builder::SitemapIndex::Item>]
+    def fetch_sitemap_index_links
+      raw_data, metadata = read(config.url)
+      return [] if raw_data.nil?
+
+      parse_sitemap_index(decompress(raw_data, metadata))
+    rescue SiteMaps::FileNotFoundError
+      []
+    rescue NotImplementedError
+      config.fetch_sitemap_index_links
+    end
+
     def config
       yield(@config) if block_given?
       @config
@@ -106,5 +132,24 @@ module SiteMaps::Adapters
       @sitemap_index = SiteMaps::Builder::SitemapIndex.new(xsl_url: xsl_url)
       @repo = nil
     end
+
+    private
+
+    def parse_sitemap_index(xml)
+      xml.scan(SITEMAP_ENTRY_RE).filter_map do |(entry)|
+        loc = entry[LOC_RE, 1]
+        next if loc.nil? || loc.empty?
+
+        SiteMaps::Builder::SitemapIndex::Item.new(loc.gsub(/&(?:amp|lt|gt|quot|apos);/, XML_ENTITIES), entry[LASTMOD_RE, 1])
+      end
+    end
+
+    def decompress(raw_data, metadata)
+      return raw_data unless metadata.is_a?(Hash) && metadata[:content_type] == "application/gzip"
+
+      Zlib::GzipReader.new(StringIO.new(raw_data)).read
+    rescue Zlib::GzipFile::Error
+      raw_data
+    end
   end
 end

data/lib/site_maps/adapters/aws_sdk/storage.rb

@@ -37,14 +37,14 @@ class SiteMaps::Adapters::AwsSdk::Storage
     raise SiteMaps::FileNotFoundError, "File not found: #{location.remote_path}"
   end
 
-  private
-
-  def list_objects(prefix:)
-    config.s3_bucket.objects(
-      prefix: prefix
-    )
+  # @param [String] prefix
+  # @return [Array<Array(String, Time)>] the key and last modified time of every object under the prefix
+  def list(prefix)
+    config.s3_bucket.objects(prefix: prefix).map { |object| [object.key, object.last_modified] }
   end
 
+  private
+
   def object(remote_path)
     config.s3_bucket.object(remote_path)
   end

data/lib/site_maps/adapters/aws_sdk.rb

@@ -18,6 +18,16 @@ module SiteMaps::Adapters
       s3_storage.delete(location)
     end
 
+    def list_sitemaps
+      prefix = config.remote_sitemap_directory
+      prefix = "#{prefix}/" unless prefix.empty?
+      s3_storage.list(prefix).filter_map do |key, last_modified|
+        next unless key.end_with?(".xml", ".xml.gz")
+
+        SiteMaps::Builder::SitemapIndex::Item.new("#{config.base_uri}/#{key}", last_modified)
+      end
+    end
+
     private
 
     def local_storage

data/lib/site_maps/adapters/file_system.rb

@@ -17,6 +17,15 @@ module SiteMaps::Adapters
       storage.delete(location)
     end
 
+    def list_sitemaps
+      root = Pathname.new(config.directory)
+      pattern = root.join(config.remote_sitemap_directory, "**", "*.{xml,xml.gz}").to_s
+      Dir.glob(pattern).map do |path|
+        relative = Pathname.new(path).relative_path_from(root).to_s
+        SiteMaps::Builder::SitemapIndex::Item.new("#{config.base_uri}/#{relative}", File.mtime(path))
+      end
+    end
+
     private
 
     def storage

data/lib/site_maps/adapters/noop.rb

@@ -14,5 +14,9 @@ module SiteMaps::Adapters
     def fetch_sitemap_index_links
       []
     end
+
+    def list_sitemaps
+      []
+    end
   end
 end

data/lib/site_maps/configuration.rb

@@ -44,6 +44,7 @@ module SiteMaps
     attribute :xsl_index_stylesheet_url
     attribute :ping_search_engines, default: false
     attribute :ping_engines
+    attribute :index_from_storage, default: false
 
     def initialize(**options)
       default_attributes.merge(options).each do |key, value|

data/lib/site_maps/incremental_location.rb

@@ -4,6 +4,14 @@ module SiteMaps
   class IncrementalLocation
     FILENAME = "sitemap.xml"
     PLACEHOLDER = "%{index}"
+    ANY_SEGMENT = "__site_maps_any_segment__"
+    TEMPLATE_KEY_RE = /%\{\w+\}/
+
+    # Matches every file a process location template may produce, whatever its
+    # keyword arguments and part number.
+    def self.template_pattern(main_url, location_template)
+      new(main_url, location_template&.gsub(TEMPLATE_KEY_RE, ANY_SEGMENT)).pattern
+    end
 
     def initialize(main_url, process_location)
       @main_uri = URI(main_url)
@@ -24,6 +32,14 @@ module SiteMaps
       main_uri.to_s
     end
 
+    # @return [Regexp] matches every numbered part of this location
+    def pattern
+      source = Regexp.escape(placeholder_url)
+        .sub(Regexp.escape(PLACEHOLDER)) { "\\d+" }
+        .gsub(ANY_SEGMENT) { "[^/]+" }
+      Regexp.new("\\A#{source}\\z")
+    end
+
     def relative_directory
       File.dirname(@uri.path).sub(%r{^/}, "")
     end

data/lib/site_maps/middleware.rb

@@ -28,11 +28,21 @@ module SiteMaps
     # Both options accept a callable (0-arg or 1-arg receiving env), which is useful
     # in multi-tenant setups where the prefix depends on the current request/site.
     #
+    # @param aliases [Hash{String=>String}, #call, nil] Maps an incoming **public
+    #   request path** to another public request path, applied before prefix
+    #   handling. Serves the target's content at the alias path (no redirect).
+    #
+    #   Example: serve the sitemap index at both locations →
+    #   `aliases: { "/sitemap.xml" => "/sitemap_index.xml" }`
+    #
+    #   Accepts a callable (0-arg or 1-arg receiving env) returning such a hash.
+    #
     def initialize(
       app,
       adapter: nil,
       public_prefix: nil,
       storage_prefix: nil,
+      aliases: nil,
       x_robots_tag: DEFAULT_X_ROBOTS_TAG,
       cache_control: DEFAULT_CACHE_CONTROL
     )
@@ -40,12 +50,13 @@ module SiteMaps
       @adapter = adapter
       @public_prefix = public_prefix
       @storage_prefix = storage_prefix
+      @aliases = aliases
       @x_robots_tag = x_robots_tag
       @cache_control = cache_control
     end
 
     def call(env)
-      path = env["PATH_INFO"]
+      path = resolve_alias(env["PATH_INFO"], env)
 
       if xsl_request?(path)
         serve_xsl(path)
@@ -74,6 +85,16 @@ module SiteMaps
 
     private
 
+    # Rewrites the incoming public path through the alias map (if configured)
+    # before any prefix handling, so the aliased path takes the exact same code
+    # path as a real request for the target.
+    def resolve_alias(path, env)
+      aliases = @aliases.respond_to?(:call) ? call_with_env(@aliases, env) : @aliases
+      return path unless aliases
+
+      aliases[path] || path
+    end
+
     def resolve_adapter(env)
       if @adapter.respond_to?(:call)
         call_with_env(@adapter, env)

data/lib/site_maps/notification.rb

@@ -33,5 +33,6 @@ module SiteMaps
     register_event "sitemaps.enqueue_process"
     register_event "sitemaps.process_execution"
     register_event "sitemaps.ping"
+    register_event "sitemaps.prune_sitemap"
   end
 end

data/lib/site_maps/runner.rb

@@ -11,6 +11,7 @@ module SiteMaps
       @execution = Concurrent::Hash.new
       @failed = Concurrent::AtomicBoolean.new(false)
       @errors = Concurrent::Array.new
+      @written = Concurrent::Array.new
     end
 
     def enqueue(process_name = :default, **kwargs)
@@ -68,6 +69,7 @@ module SiteMaps
                 adapter.process_mixins.each { |mixin| builder.extend(mixin) }
                 process.call(builder, **kwargs)
                 builder.finalize!
+                written << [process.location(**kwargs), builder.written_urls]
               end
             end
           end
@@ -75,30 +77,104 @@ module SiteMaps
       end
 
       futures.each(&:wait)
-      failed.false? ? finalize! : fail_with_errors!
+      if failed.false?
+        finalize!
+      else
+        write_index! if index_from_storage?
+        fail_with_errors!
+      end
     ensure
       pool.shutdown
       pool.wait_for_termination
       @execution.clear
+      @written.clear
+    end
+
+    # Rewrites the sitemap index from the sitemap files found in storage,
+    # without running any process.
+    def rebuild_index!
+      add_stored_index_links(adapter.list_sitemaps)
+      add_external_index_links
+      write_sitemap_index
+      self
     end
 
     private
 
-    attr_reader :pool, :failed, :errors
+    attr_reader :pool, :failed, :errors, :written
 
     def finalize!
-      adapter.repo.remaining_index_links.each do |item|
-        adapter.sitemap_index.add(item)
+      write_index!
+      should_ping = @ping.nil? ? adapter.config.respond_to?(:ping_search_engines?) && adapter.config.ping_search_engines? : @ping
+      ping_search_engines if should_ping
+    end
+
+    def write_index!
+      if index_from_storage?
+        add_stored_index_links(prune_stale_sitemaps(adapter.list_sitemaps))
+      else
+        adapter.repo.remaining_index_links.each do |item|
+          adapter.sitemap_index.add(item)
+        end
       end
+      add_external_index_links
+      write_sitemap_index
+    end
+
+    def write_sitemap_index
+      return if adapter.sitemap_index.empty?
+
+      raw_data = adapter.sitemap_index.to_xml
+      adapter.write(adapter.config.url, raw_data, last_modified: adapter.sitemap_index.last_modified)
+    end
+
+    def add_external_index_links
       adapter.external_sitemaps.each do |item|
         adapter.sitemap_index.add(item)
       end
-      unless adapter.sitemap_index.empty?
-        raw_data = adapter.sitemap_index.to_xml
-        adapter.write(adapter.config.url, raw_data, last_modified: adapter.sitemap_index.last_modified)
+    end
+
+    # Adds the stored files that belong to a declared process. Files written by
+    # this run are already in the index, and the index keeps the first entry
+    # added for each location.
+    def add_stored_index_links(stored)
+      patterns = adapter.processes.values.map do |process|
+        SiteMaps::IncrementalLocation.template_pattern(adapter.config.url, process.location_template)
       end
-      should_ping = @ping.nil? ? adapter.config.respond_to?(:ping_search_engines?) && adapter.config.ping_search_engines? : @ping
-      ping_search_engines if should_ping
+
+      stored.each do |item|
+        next if item.loc == adapter.config.url
+        next unless patterns.any? { |pattern| pattern.match?(item.loc) }
+
+        adapter.sitemap_index.add(item)
+      end
+    end
+
+    # Deletes the numbered parts a successful process no longer writes, such as
+    # sitemap3.xml after a month shrank to two files. Returns the stored files
+    # that are left.
+    def prune_stale_sitemaps(stored)
+      stale = written.flat_map do |location, urls|
+        next [] if urls.empty?
+
+        pattern = SiteMaps::IncrementalLocation.new(adapter.config.url, location).pattern
+        stored.select { |item| pattern.match?(item.loc) && !urls.include?(item.loc) && item.loc != adapter.config.url }
+      end
+
+      stale.each do |item|
+        SiteMaps::Notification.instrument("sitemaps.prune_sitemap") do |payload|
+          payload[:url] = item.loc
+          adapter.delete(item.loc)
+        rescue SiteMaps::FileNotFoundError
+          nil
+        end
+      end
+
+      stored - stale
+    end
+
+    def index_from_storage?
+      adapter.config.respond_to?(:index_from_storage?) && adapter.config.index_from_storage?
     end
 
     def ping_search_engines
@@ -119,6 +195,7 @@ module SiteMaps
     end
 
     def may_preload_sitemap_index
+      return if index_from_storage?
       return unless preload_sitemap_index_links?
 
       adapter.fetch_sitemap_index_links.each do |item|
@@ -126,8 +203,10 @@ module SiteMaps
       end
     end
 
+    # A failure stops the remaining processes, unless the index is rebuilt from
+    # storage: then every independent process still gets its chance to publish.
     def wrap_process_execution(process)
-      return if failed.true?
+      return if failed.true? && !index_from_storage?
 
       yield
     rescue => e

data/lib/site_maps/sitemap_builder.rb

@@ -4,8 +4,11 @@ module SiteMaps
   class SitemapBuilder
     extend Forwardable
 
+    attr_reader :written_urls
+
     def initialize(adapter:, location: nil, notification_payload: {})
       @adapter = adapter
+      @written_urls = []
       @url_set = build_url_set
       @location = location
       @mutex = Mutex.new
@@ -43,10 +46,12 @@ module SiteMaps
         if adapter.maybe_inline_urlset? && sitemap_index.empty?
           payload[:url] = repo.main_url
           adapter.write(repo.main_url, raw_data, last_modified: url_set.last_modified)
+          written_urls << repo.main_url
         else
           sitemap_url = repo.generate_url(location)
           payload[:url] = sitemap_url
           adapter.write(sitemap_url, raw_data, last_modified: url_set.last_modified)
+          written_urls << sitemap_url
           add_sitemap_index(sitemap_url, lastmod: url_set.last_modified)
         end
       end
@@ -67,6 +72,7 @@ module SiteMaps
         payload[:news_count] = url_set.news_count
         payload[:last_modified] = url_set.last_modified
         adapter.write(sitemap_url, raw_data, last_modified: url_set.last_modified)
+        written_urls << sitemap_url
         add_sitemap_index(sitemap_url, lastmod: url_set.last_modified)
       end
       @url_set = build_url_set

data/lib/site_maps/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SiteMaps
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: site_maps
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Marcos G. Zimmermann
@@ -108,6 +108,25 @@ files:
 - docs/README.md
 - docs/adapters.md
 - docs/api.md
+- docs/brand/BRAND.md
+- docs/brand/apple-touch-icon.png
+- docs/brand/favicon-16.png
+- docs/brand/favicon-32.png
+- docs/brand/favicon.ico
+- docs/brand/favicon.svg
+- docs/brand/icon-512.png
+- docs/brand/lockup-sitemaps-mono.svg
+- docs/brand/lockup-sitemaps-on-dark.svg
+- docs/brand/lockup-sitemaps-on-light.svg
+- docs/brand/lockup-sitemaps.svg
+- docs/brand/mark-mono.svg
+- docs/brand/mark-on-dark.svg
+- docs/brand/mark-on-light.svg
+- docs/brand/mark-small-mono.svg
+- docs/brand/mark-small-on-dark.svg
+- docs/brand/mark-small-on-light.svg
+- docs/brand/mark-small.svg
+- docs/brand/mark.svg
 - docs/cli.md
 - docs/events.md
 - docs/extensions.md