Pagefind smoke

Co-authored-by: Copilot <copilot@github.com>

Author: p1c2u

.readthedocs.yaml

@@ -13,10 +13,14 @@ build:
   os: ubuntu-24.04
   tools:
     python: "3.12"
+    nodejs: "20"
   jobs:
     post_system_dependencies:
       - asdf plugin-add poetry
       - asdf install poetry 2.2.1
       - asdf global poetry 2.2.1
     post_install:
       - VIRTUAL_ENV=$READTHEDOCS_VIRTUALENV_PATH poetry install --no-interaction --with docs
+    post_build:
+      - poetry run make docs-publish
+      - mkdir -p $READTHEDOCS_OUTPUT/html && cp -r docs_build/* $READTHEDOCS_OUTPUT/html/

Makefile

@@ -34,6 +34,14 @@ test-cleanup: test-cache-cleanup reports-cleanup
 docs-html:
 	python -m mkdocs build --clean --site-dir docs_build --config-file mkdocs.yml
 
+docs-pagefind: docs-html
+	@npx --yes pagefind --site docs_build
+
+docs-manifest:
+	@cp docs/manifest.json docs_build/manifest.json
+
+docs-publish: docs-html docs-pagefind docs-manifest
+
 docs-cleanup:
 	@rm -rf docs_build
 

docs/manifest.json

@@ -0,0 +1,36 @@
+{
+  "manifestVersion": 1,
+  "projectSlug": "openapi-core",
+  "displayName": "openapi-core",
+  "themeContractVersion": 1,
+  "latestStableVersion": "0.23.1",
+  "routes": {
+    "publicProjectPath": "/openapi-core",
+    "latestDocsPath": "/openapi-core/docs/",
+    "versionedDocsPrefix": "/openapi-core/docs/"
+  },
+  "versions": [
+    {
+      "version": "0.23.1",
+      "label": "0.23.1",
+      "channel": "stable",
+      "isLatestStable": true,
+      "publicBasePath": "/openapi-core/docs/0.23.1/",
+      "originUrl": "https://docs-origin.example.com/openapi-core/0.23.1/",
+      "sitemapUrl": "https://docs-origin.example.com/openapi-core/0.23.1/sitemap.xml",
+      "searchBundleUrl": "https://docs-origin.example.com/openapi-core/0.23.1/pagefind/",
+      "publishedAt": "2026-04-29T00:00:00Z"
+    },
+    {
+      "version": "next",
+      "label": "next",
+      "channel": "next",
+      "isLatestStable": false,
+      "publicBasePath": "/openapi-core/docs/next/",
+      "originUrl": "https://docs-origin.example.com/openapi-core/next/",
+      "sitemapUrl": "https://docs-origin.example.com/openapi-core/next/sitemap.xml",
+      "searchBundleUrl": "https://docs-origin.example.com/openapi-core/next/pagefind/",
+      "publishedAt": "2026-04-29T00:00:00Z"
+    }
+  ]
+}