HuggeK · HuggeK · Jul 5, 2026 · Jul 5, 2026 · Jul 5, 2026 · Jul 5, 2026
diff --git a/.github/workflows/publish-pages.yml b/.github/workflows/publish-pages.yml
@@ -0,0 +1,70 @@
+name: Publish GitHub Pages
+
+# Publishes the demo site to GitHub Pages on every push to main and on each
+# published release (and on manual dispatch). The site is assembled from the
+# canonical sources at build time, so nothing has to be hand-copied into
+# docs/ anymore:
+#   - docs/index.html            -> /            (the demo page)
+#   - styles/golfTilesStyle.json -> /styles/     (pmtiles URL rewritten to the
+#                                                 Pages origin: golftiles.org
+#                                                 sends no CORS headers)
+#   - docs/samples/*.pmtiles     -> /samples/    (example tilesets)
+#   - docs/fonts/                -> /fonts/      (self-hosted glyph ranges)
+#
+# Requires the repo's Pages source to be set to "GitHub Actions"
+# (one-time: gh api -X PUT repos/HuggeK/golfTiles/pages -f build_type=workflow).
+
+on:
+  push:
+    branches: [main]
+  release:
+    types: [published]
+  workflow_dispatch:        # allow manual runs from the Actions tab
+
+# Never cancel a deployment in progress; queue instead.
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    permissions:
+      contents: read
+      pages: write           # required to deploy to Pages
+      id-token: write        # required by deploy-pages for OIDC verification
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Configure Pages
+        id: pages
+        uses: actions/configure-pages@v5
+
+      - name: Assemble site
+        env:
+          BASE_URL: ${{ steps.pages.outputs.base_url }}
+        run: |
+          mkdir -p _site/styles _site/samples
+          cp docs/index.html _site/index.html
+          cp docs/samples/*.pmtiles _site/samples/
+          cp -r docs/fonts _site/fonts
+          # The canonical style points its pmtiles source at golftiles.org,
+          # which serves no CORS headers; the Pages copy must fetch tiles from
+          # its own origin. jq doubles as a JSON validity gate.
+          jq --arg url "pmtiles://${BASE_URL}/samples/golfTiles_se_dk_fi.pmtiles" \
+            '.sources.golfTiles_source.url = $url' \
+            styles/golfTilesStyle.json > _site/styles/golfTilesStyle.json
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: _site
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
diff --git a/.gitignore b/.gitignore
@@ -3,4 +3,6 @@
 /.vscode
 *:Zone.Identifier
 !/docs/samples/*.pmtiles
-!/tests/fixtures/*.pbf
+!/tests/fixtures/*.pbf
+!/docs/fonts/**/*.pbf
+/_site
diff --git a/README.md b/README.md
@@ -102,12 +102,12 @@ golfTiles/
 │   └── process.lua            # Process file which decides what should be included in the tiles in what layers and what vector attributes should be written to the features(Schema)
 ├── data/                      # Folder to place your .pbf extracts to generate tiles on.
 │   └── processed/             # Temporary folder used by the run_all.sh script for osmium-tool.
-├── docs/                      # Documentation.
+├── docs/                      # Documentation + sources for the GitHub Pages demo site.
+│   ├── fonts/                 # Self-hosted glyph .pbf ranges used by the style's glyphs property.
 │   ├── samples/               # folder for samples to be downloaded by interested parties and used by the demo.
-│   ├── styles/                # mirrors the styles/ folder, to be use on the github pages due to CORS
 │   ├── CONTRIBUTING.md        # Contributing information.
 │   ├── diary.md               # Some development diary documenting the early process.
-│   └── index.html             # The page for github pages.
+│   └── index.html             # The demo page for github pages.
 ├── openfreemap-styles/        # Git Submodule of openfreemap-styles using the OpenMapTiles schema.
 ├── store/                     # Folder to be used as swapspace for tilemaker. TBD.
 ├── styles/                    # Contains the maplibre GL Styles golfTilesStyle.json, 
@@ -118,6 +118,16 @@ golfTiles/
 └── run_all.sh                 # Main script to get generate .pmtiles.
 ```
 
+## Publishing the demo site
+The GitHub Pages demo (https://huggek.github.io/golfTiles/) is published by the
+[`publish-pages.yml`](.github/workflows/publish-pages.yml) workflow, which runs on every push to
+main and on every published release (or manually from the Actions tab). It assembles the site from the canonical sources — the
+demo page (`docs/index.html`), the style (`styles/golfTilesStyle.json`, with its pmtiles source URL
+rewritten to the Pages origin since golftiles.org serves no CORS headers), the example tilesets
+(`docs/samples/`) and the self-hosted font glyphs (`docs/fonts/`) — so no copies need to be kept in
+sync by hand. Longer term, golftiles.org is meant to be the bucket endpoint serving the tiles and
+the style, with the GitHub Pages site acting as the demo page.
+
 ## Future technical development to solve the limitation using tileMaker
 In the future one could maybe use a "dynamic" tile generator server such as:
 - osm2psql 

diff --git a/docs/fonts/Open Sans Regular/0-255.pbf b/docs/fonts/Open Sans Regular/0-255.pbf
diff --git a/docs/fonts/Open Sans Regular/1024-1279.pbf b/docs/fonts/Open Sans Regular/1024-1279.pbf
diff --git a/docs/fonts/Open Sans Regular/10240-10495.pbf b/docs/fonts/Open Sans Regular/10240-10495.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular10240-10495
diff --git a/docs/fonts/Open Sans Regular/10496-10751.pbf b/docs/fonts/Open Sans Regular/10496-10751.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular10496-10751
diff --git a/docs/fonts/Open Sans Regular/10752-11007.pbf b/docs/fonts/Open Sans Regular/10752-11007.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular10752-11007
diff --git a/docs/fonts/Open Sans Regular/11008-11263.pbf b/docs/fonts/Open Sans Regular/11008-11263.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular11008-11263
diff --git a/docs/fonts/Open Sans Regular/11264-11519.pbf b/docs/fonts/Open Sans Regular/11264-11519.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular11264-11519
diff --git a/docs/fonts/Open Sans Regular/11520-11775.pbf b/docs/fonts/Open Sans Regular/11520-11775.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular11520-11775
diff --git a/docs/fonts/Open Sans Regular/11776-12031.pbf b/docs/fonts/Open Sans Regular/11776-12031.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular11776-12031
diff --git a/docs/fonts/Open Sans Regular/12032-12287.pbf b/docs/fonts/Open Sans Regular/12032-12287.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular12032-12287
diff --git a/docs/fonts/Open Sans Regular/12288-12543.pbf b/docs/fonts/Open Sans Regular/12288-12543.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular12288-12543
diff --git a/docs/fonts/Open Sans Regular/12544-12799.pbf b/docs/fonts/Open Sans Regular/12544-12799.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular12544-12799
diff --git a/docs/fonts/Open Sans Regular/1280-1535.pbf b/docs/fonts/Open Sans Regular/1280-1535.pbf
diff --git a/docs/fonts/Open Sans Regular/12800-13055.pbf b/docs/fonts/Open Sans Regular/12800-13055.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular12800-13055
diff --git a/docs/fonts/Open Sans Regular/13056-13311.pbf b/docs/fonts/Open Sans Regular/13056-13311.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular13056-13311
diff --git a/docs/fonts/Open Sans Regular/13312-13567.pbf b/docs/fonts/Open Sans Regular/13312-13567.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular13312-13567
diff --git a/docs/fonts/Open Sans Regular/13568-13823.pbf b/docs/fonts/Open Sans Regular/13568-13823.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular13568-13823
diff --git a/docs/fonts/Open Sans Regular/13824-14079.pbf b/docs/fonts/Open Sans Regular/13824-14079.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular13824-14079
diff --git a/docs/fonts/Open Sans Regular/14080-14335.pbf b/docs/fonts/Open Sans Regular/14080-14335.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular14080-14335
diff --git a/docs/fonts/Open Sans Regular/14336-14591.pbf b/docs/fonts/Open Sans Regular/14336-14591.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular14336-14591
diff --git a/docs/fonts/Open Sans Regular/14592-14847.pbf b/docs/fonts/Open Sans Regular/14592-14847.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular14592-14847
diff --git a/docs/fonts/Open Sans Regular/14848-15103.pbf b/docs/fonts/Open Sans Regular/14848-15103.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular14848-15103
diff --git a/docs/fonts/Open Sans Regular/15104-15359.pbf b/docs/fonts/Open Sans Regular/15104-15359.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular15104-15359
diff --git a/docs/fonts/Open Sans Regular/1536-1791.pbf b/docs/fonts/Open Sans Regular/1536-1791.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular	1536-1791
diff --git a/docs/fonts/Open Sans Regular/15360-15615.pbf b/docs/fonts/Open Sans Regular/15360-15615.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular15360-15615
diff --git a/docs/fonts/Open Sans Regular/15616-15871.pbf b/docs/fonts/Open Sans Regular/15616-15871.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular15616-15871
diff --git a/docs/fonts/Open Sans Regular/15872-16127.pbf b/docs/fonts/Open Sans Regular/15872-16127.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular15872-16127
diff --git a/docs/fonts/Open Sans Regular/16128-16383.pbf b/docs/fonts/Open Sans Regular/16128-16383.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular16128-16383
diff --git a/docs/fonts/Open Sans Regular/16384-16639.pbf b/docs/fonts/Open Sans Regular/16384-16639.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular16384-16639
diff --git a/docs/fonts/Open Sans Regular/16640-16895.pbf b/docs/fonts/Open Sans Regular/16640-16895.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular16640-16895
diff --git a/docs/fonts/Open Sans Regular/16896-17151.pbf b/docs/fonts/Open Sans Regular/16896-17151.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular16896-17151
diff --git a/docs/fonts/Open Sans Regular/17152-17407.pbf b/docs/fonts/Open Sans Regular/17152-17407.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular17152-17407
diff --git a/docs/fonts/Open Sans Regular/17408-17663.pbf b/docs/fonts/Open Sans Regular/17408-17663.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular17408-17663
diff --git a/docs/fonts/Open Sans Regular/17664-17919.pbf b/docs/fonts/Open Sans Regular/17664-17919.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular17664-17919
diff --git a/docs/fonts/Open Sans Regular/1792-2047.pbf b/docs/fonts/Open Sans Regular/1792-2047.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular	1792-2047
diff --git a/docs/fonts/Open Sans Regular/17920-18175.pbf b/docs/fonts/Open Sans Regular/17920-18175.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular17920-18175
diff --git a/docs/fonts/Open Sans Regular/18176-18431.pbf b/docs/fonts/Open Sans Regular/18176-18431.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular18176-18431
diff --git a/docs/fonts/Open Sans Regular/18432-18687.pbf b/docs/fonts/Open Sans Regular/18432-18687.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular18432-18687
diff --git a/docs/fonts/Open Sans Regular/18688-18943.pbf b/docs/fonts/Open Sans Regular/18688-18943.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular18688-18943
diff --git a/docs/fonts/Open Sans Regular/18944-19199.pbf b/docs/fonts/Open Sans Regular/18944-19199.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular18944-19199
diff --git a/docs/fonts/Open Sans Regular/19200-19455.pbf b/docs/fonts/Open Sans Regular/19200-19455.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular19200-19455
diff --git a/docs/fonts/Open Sans Regular/19456-19711.pbf b/docs/fonts/Open Sans Regular/19456-19711.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular19456-19711
diff --git a/docs/fonts/Open Sans Regular/19712-19967.pbf b/docs/fonts/Open Sans Regular/19712-19967.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular19712-19967
diff --git a/docs/fonts/Open Sans Regular/19968-20223.pbf b/docs/fonts/Open Sans Regular/19968-20223.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular19968-20223
diff --git a/docs/fonts/Open Sans Regular/20224-20479.pbf b/docs/fonts/Open Sans Regular/20224-20479.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular20224-20479
diff --git a/docs/fonts/Open Sans Regular/2048-2303.pbf b/docs/fonts/Open Sans Regular/2048-2303.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular	2048-2303
diff --git a/docs/fonts/Open Sans Regular/20480-20735.pbf b/docs/fonts/Open Sans Regular/20480-20735.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular20480-20735
diff --git a/docs/fonts/Open Sans Regular/20736-20991.pbf b/docs/fonts/Open Sans Regular/20736-20991.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular20736-20991
diff --git a/docs/fonts/Open Sans Regular/20992-21247.pbf b/docs/fonts/Open Sans Regular/20992-21247.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular20992-21247
diff --git a/docs/fonts/Open Sans Regular/21248-21503.pbf b/docs/fonts/Open Sans Regular/21248-21503.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular21248-21503
diff --git a/docs/fonts/Open Sans Regular/21504-21759.pbf b/docs/fonts/Open Sans Regular/21504-21759.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular21504-21759
diff --git a/docs/fonts/Open Sans Regular/21760-22015.pbf b/docs/fonts/Open Sans Regular/21760-22015.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular21760-22015
diff --git a/docs/fonts/Open Sans Regular/22016-22271.pbf b/docs/fonts/Open Sans Regular/22016-22271.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular22016-22271
diff --git a/docs/fonts/Open Sans Regular/22272-22527.pbf b/docs/fonts/Open Sans Regular/22272-22527.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular22272-22527
diff --git a/docs/fonts/Open Sans Regular/22528-22783.pbf b/docs/fonts/Open Sans Regular/22528-22783.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular22528-22783
diff --git a/docs/fonts/Open Sans Regular/22784-23039.pbf b/docs/fonts/Open Sans Regular/22784-23039.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular22784-23039
diff --git a/docs/fonts/Open Sans Regular/2304-2559.pbf b/docs/fonts/Open Sans Regular/2304-2559.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular	2304-2559
diff --git a/docs/fonts/Open Sans Regular/23040-23295.pbf b/docs/fonts/Open Sans Regular/23040-23295.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular23040-23295
diff --git a/docs/fonts/Open Sans Regular/23296-23551.pbf b/docs/fonts/Open Sans Regular/23296-23551.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular23296-23551
diff --git a/docs/fonts/Open Sans Regular/23552-23807.pbf b/docs/fonts/Open Sans Regular/23552-23807.pbf
@@ -0,0 +1,3 @@
+
+
+Open Sans Regular23552-23807