Jekyll based toolchain automation

.github/workflows/pages.yaml

@@ -1,6 +1,5 @@
 # Builds the docs and deploys them to GitHub pages.
-
-name: Pages
+name: Build and deploy to Github Pages
 
 # Controls when the workflow will run
 on:
@@ -18,27 +17,46 @@ permissions:
   pages: write
   id-token: write
 
-# A workflow run is made up of one or more jobs that can run sequentially or in parallel
+# Workflow run composed of build and deploy jobs
 jobs:
 
+  # Builds and uploads artifact for GitHib pages
   build:
     # The type of runner that the job will run on
     runs-on: ubuntu-latest
 
     # Steps represent a sequence of tasks that will be executed as part of the job
     steps:
-      # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
+
+      # Checks out git repository
       - uses: actions/checkout@v4
 
-      # Runs a single command using the runners shell
-      - name: Run a one-line script
-        run: | 
+      # Builds tools and generates md docs under ./site
+      - name: Build tools and generate md docs
+        run: |
           ./tools/build.sh
 
+      # Builds static html web pages with jekyll under ./site
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.1
+      - name: Install bundler and gems for jekyll
+        run: |
+          cd site
+          gem install bundler
+          bundle install --jobs 4 --retry 3
+      - name: Build static html web page with jekyll
+        run: |
+          cd site
+          ls Gemfile
+          bundle exec jekyll build
+
+      # Creates and uploads the build artifact from ./site
       - uses: actions/upload-pages-artifact@v3
         with:
-          path: site
+          path: site/_site
 
+  # Deploys artifact to GitHub pages
   deploy:
     needs: build
     runs-on: ubuntu-latest
@@ -47,4 +65,4 @@ jobs:
       url: ${{ steps.deployment.outputs.page_url }}
     steps:
       - id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@v5

.gitignore

@@ -7,8 +7,8 @@ generated/xcore/contab/netex.html
 templates/README.md~
 tools/schematron_builder/__pycache__/template2schematron.cpython-313.pyc
 __pycache__
+**/__pycache__/
 netex_rg_ch.egg-info
 dist/
-site/
 build/
-netex_rg_ch_test.egg-info/
+site/

docs/06_stops.md

@@ -2,18 +2,18 @@
 In this chapter:
 
 - [SiteFrame](#siteframe)
-- [StopPlace](#StopPlace)
-- [Quay](#Quay)
-- [TopographicPlace](#TopographicPlace)
-- [Centroid](#Centroid)
+- [StopPlace](#stopplace)
+- [Quay](#quay)
+- [TopographicPlace](#topographicplace)
+- [Centroid](#centroid)
 
 ## SiteFrame
 *→ [Glossary definition](A4_annex_glossary.md#siteframe)*
 
 ### Purpose
 A `SiteFrame` contains the physical infrastructure model for public transport — `StopPlace`s, `Quay`s, and topographic context. It defines the spatial elements that passengers interact with and that other frames reference for stop assignments.
 
-```mermaid
+```mermaid!
 classDiagram
     %% Styles
     classDef frame fill:#FFF8E1,stroke:#FFB300;
@@ -70,7 +70,7 @@ classDiagram
 `SiteFrame` is independent of other frames but provides the physical stop infrastructure that `ServiceFrame` references through `PassengerStopAssignments`. `TimetableFrame` indirectly depends on `SiteFrame` through the `JourneyPattern` stop sequence. `SiteFrame` is typically wrapped in a `CompositeFrame` within a `PublicationDelivery`.
 
 ## StopPlace
-*→ [Glossary definition](A4_annex_glossary.md#StopPlace)*
+*→ [Glossary definition](A4_annex_glossary.md#stopplace)*
 
 ### Purpose
 A named physical or virtual location where passengers can board or alight from public transport, containing one or more `Quays`.

jekyll/.gitignore

@@ -0,0 +1,6 @@
+_site
+.sass-cache
+.jekyll-cache
+.jekyll-metadata
+vendor
+Gemfile.lock

jekyll/404.html

@@ -0,0 +1,25 @@
+---
+permalink: /404.html
+layout: page
+---
+
+<style type="text/css" media="screen">
+  .container {
+    margin: 10px auto;
+    max-width: 600px;
+    text-align: center;
+  }
+  h1 {
+    margin: 30px 0;
+    font-size: 4em;
+    line-height: 1;
+    letter-spacing: -1px;
+  }
+</style>
+
+<div class="container">
+  <h1>404</h1>
+
+  <p><strong>Page not found :(</strong></p>
+  <p>The requested page could not be found.</p>
+</div>

jekyll/Gemfile

@@ -0,0 +1,35 @@
+source "https://rubygems.org"
+# Hello! This is where you manage which Jekyll version is used to run.
+# When you want to use a different version, change it below, save the
+# file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
+#
+#     bundle exec jekyll serve
+#
+# This will help ensure the proper Jekyll version is running.
+# Happy Jekylling!
+# gem "jekyll", "~> 4.4.1"
+# This is the default theme for new Jekyll sites. You may change this to anything you like.
+gem "minima", "~> 2.5"
+# If you want to use GitHub Pages, remove the "gem "jekyll"" above and
+# uncomment the line below. To upgrade, run `bundle update github-pages`.
+gem "github-pages", group: :jekyll_plugins
+# If you have any plugins, put them here!
+group :jekyll_plugins do
+#  gem "jekyll-feed", "~> 0.12"
+  gem 'jekyll-titles-from-headings'
+ # gem 'jekyll-mermaid-prebuild'
+end
+
+# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
+# and associated library.
+platforms :mingw, :x64_mingw, :mswin, :jruby do
+  gem "tzinfo", ">= 1", "< 3"
+  gem "tzinfo-data"
+end
+
+# Performance-booster for watching directories on Windows
+gem "wdm", "~> 0.1", :platforms => [:mingw, :x64_mingw, :mswin]
+
+# Lock `http_parser.rb` gem to `v0.6.x` on JRuby builds since newer versions of the gem
+# do not have a Java counterpart.
+gem "http_parser.rb", "~> 0.6.0", :platforms => [:jruby]