Make documentation browseable with focused API pages

.github/workflows/pages.yml

@@ -12,6 +12,10 @@ on:
   pull_request:
     branches: [master]
   workflow_dispatch:
+  schedule:
+    - cron: "0 6 * * 1"
+  repository_dispatch:
+    types: [stdlib-updated]
 
 permissions:
   contents: read
@@ -29,6 +33,24 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v6
 
+      - name: Checkout standard library
+        uses: actions/checkout@v6
+        with:
+          repository: wurstscript/WurstStdlib2
+          ref: master
+          path: _stdlib
+
+      - name: Set up Deno
+        uses: denoland/setup-deno@v2
+        with:
+          deno-version: v2.x
+
+      - name: Verify and generate API reference
+        working-directory: tools/docgen
+        run: |
+          deno task test
+          deno task gen --src "$GITHUB_WORKSPACE/_stdlib/wurst" --out "$GITHUB_WORKSPACE"
+
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:
@@ -54,6 +76,9 @@ jobs:
       - name: Verify built dependency assets
         run: npm test
 
+      - name: Verify reference pages and links
+        run: node tools/check-reference-pages.mjs
+
       - name: Generate Pagefind search index
         run: npx -y pagefind@1.5.2 --site _site
 

.gitignore

@@ -9,3 +9,7 @@ _stdlib
 # with the content and breaks search.
 pagefind/
 node_modules/
+
+# API pages are generated from WurstStdlib2 during the site build.
+_doc/stdlib/ref/
+_data/stdlib_index.json

_config.yml

@@ -15,6 +15,7 @@ exclude:
 - vendor
 - tools
 - node_modules
+- _stdlib
 - package.json
 - package-lock.json
 - assets/plugins/elegant_font/css/index.html
@@ -80,6 +81,10 @@ collections:
   tutorials:
     output: true
 
+# Jekyll otherwise skips underscore-prefixed package/type files.
+include:
+  - "_*.md"
+
 
 #
 # Default values