Render the API reference as Hugo content instead of embedding javadoc HTML

.github/workflows/website-docs.yml

@@ -36,6 +36,10 @@ on:
       # The Hugo build embeds JavaDocs produced by this script, so a change
       # to how the docs are generated must redeploy the website too.
       - '.github/scripts/build_javadocs.sh'
+      # The doclet that renders the API pages themselves. It is outside the
+      # maven reactor and built only by this workflow, so nothing else would
+      # catch a change to it.
+      - 'maven/javadoc-hugo-doclet/**'
       - '.github/workflows/website-docs.yml'
   push:
     branches: [main, master]
@@ -61,6 +65,10 @@ on:
       # The Hugo build embeds JavaDocs produced by this script, so a change
       # to how the docs are generated must redeploy the website too.
       - '.github/scripts/build_javadocs.sh'
+      # The doclet that renders the API pages themselves. It is outside the
+      # maven reactor and built only by this workflow, so nothing else would
+      # catch a change to it.
+      - 'maven/javadoc-hugo-doclet/**'
       - '.github/workflows/website-docs.yml'
   workflow_dispatch:
     inputs:
@@ -206,6 +214,41 @@ jobs:
           # on their actual date.
           HUGO_BUILD_FUTURE: ${{ github.event_name == 'pull_request' && 'true' || 'false' }}
 
+      - name: Validate API reference output
+        run: |
+          set -euo pipefail
+          test -f docs/website/public/javadoc/index.html
+          # Pages are published at the directory URL, because Cloudflare Pages
+          # will not serve a .html one: see check-javadoc-urls.sh.
+          test -f docs/website/public/javadoc/com/codename1/ui/Component/index.html
+          test -f docs/website/public/javadoc/com/codename1/ui/package-summary/index.html
+          test -f docs/website/public/javadoc-search.json
+          # The fragment encoding is the compatibility surface, so assert one of
+          # the awkward spellings rather than only that the page exists. This is
+          # a canary for the parity gate rather than a duplicate of it: the gate
+          # compares two trees, and a gate that ends up comparing nothing reports
+          # nothing missing.
+          #
+          # Quotes are optional because the site is built with --minify and the
+          # minifier drops them wherever HTML allows: this page really does carry
+          # id=createImage(byte[],int,int) with no quotes at all.
+          grep -Eq 'id="?createImage\(byte\[\],int,int\)"?' \
+            docs/website/public/javadoc/com/codename1/ui/Image/index.html
+          # The old integration copied the standard doclet's tree into static/
+          # and scoped its stylesheet with a script. Nothing should reintroduce
+          # either: they are what broke dark mode.
+          test ! -e docs/website/static/javadoc
+          test ! -e docs/website/assets/js/cn1-javadoc.js
+
+      - name: Validate API URLs on the Pages runtime
+        run: |
+          set -euo pipefail
+          # Asks the server rather than the filesystem. Everything else was green
+          # on a build where clicking any class left the site: Pages redirects
+          # /x.html to /x before an asset is considered, so the page published at
+          # the extension was one nobody could reach.
+          scripts/website/check-javadoc-urls.sh docs/website/public 8789
+
       - name: Validate Port Status page output
         run: |
           set -euo pipefail

.gitignore

@@ -114,6 +114,15 @@ dependency-reduced-pom.xml
 # docs/developer-guide on every run, so a committed copy is both duplicated
 # source and guaranteed stale. 485 files of it were committed by accident once.
 /docs/website/static/developer-guide/
+# The API reference is generated into the content tree by the Hugo doclet on
+# every run of scripts/website/build.sh, one file per documented type. Roughly
+# 1850 generated pages have no business in the history: the sources they are
+# rendered from are already committed.
+/docs/website/content/javadoc/
+/docs/website/static/javadoc-search.json
+# Left behind by the previous integration, which copied the whole standard
+# doclet tree into static/ and served it through a scoping script.
+/docs/website/static/javadoc/
 /docs/website/.hugo_build.lock
 /docs/website/hugo_stats.json
 /docs/website/resources/