fix: generate api/index.html and improve DocFX search indexing

- Align docfx.json content section with docfx-local.json: include
  index.md and toc.yml so DocFX generates /api/index.html
- Add CI step to inject data-pagefind-body on DocFX <main> elements
  so Pagefind indexes only the article content, not navigation noise

Author: carldebilly

.github/workflows/deploy.yml

@@ -68,6 +68,10 @@ jobs:
         env:
           GOOGLE_ANALYTICS_ID: ${{ secrets.GOOGLE_ANALYTICS_ID }}
 
+      - name: Annotate DocFX pages for Pagefind indexing
+        run: |
+          find dist/api -name "*.html" -exec sed -i 's|<main class="container-xxl">|<main class="container-xxl" data-pagefind-body>|g' {} \;
+
       - name: Merge DocFX sitemap into Astro sitemap index
         run: |
           sed -i 's|</sitemapindex>|  <sitemap>\n    <loc>https://repl.yllibed.org/api/sitemap.xml</loc>\n  </sitemap>\n</sitemapindex>|' dist/sitemap-index.xml

docfx/docfx.json

@@ -48,9 +48,8 @@
   ],
   "build": {
     "content": [
-      {
-        "files": ["api/**.yml", "api/index.md"]
-      }
+      { "files": ["index.md", "toc.yml"] },
+      { "files": ["api/**.yml", "api/index.md", "api/toc.yml"] }
     ],
     "dest": "../public/api",
     "globalMetadata": {