Include OpenAPI types in API Browser, fix docfx logo, enable Google Analytics

bkoelman · bkoelman · commit 8bc560c8432d · 2025-05-05T17:16:43.000+02:00
diff --git a/docs/build-dev.ps1 b/docs/build-dev.ps1
@@ -35,6 +35,8 @@ if (-Not $NoBuild -Or -Not (Test-Path -Path _site)) {
     VerifySuccessExitCode
 
     Invoke-Expression ./generate-examples.ps1
+} else {
+    Remove-Item _site/xrefmap.yml -ErrorAction Ignore
 }
 
 dotnet tool restore
diff --git a/docs/docfx.json b/docs/docfx.json
@@ -1,4 +1,5 @@
 {
+  "$schema": "https://raw.githubusercontent.com/dotnet/docfx/main/schemas/docfx.schema.json",
   "metadata": [
     {
       "properties": {
@@ -8,30 +9,21 @@
         {
           "files": [
             "**/JsonApiDotNetCore.csproj",
-            "**/JsonApiDotNetCore.Annotations.csproj"
+            "**/JsonApiDotNetCore.Annotations.csproj",
+            "**/JsonApiDotNetCore.OpenApi.Swashbuckle.csproj",
+            "**/JsonApiDotNetCore.OpenApi.Client.NSwag.csproj",
+            "**/JsonApiDotNetCore.OpenApi.Client.Kiota"
           ],
           "src": "../"
         }
       ],
-      "dest": "api",
-      "disableGitFeatures": false
+      "output": "api"
     }
   ],
   "build": {
     "content": [
       {
-        "files": [
-          "api/**.yml",
-          "api/index.md",
-          "ext/openapi/index.md",
-          "getting-started/**.md",
-          "getting-started/**/toc.yml",
-          "usage/**.md",
-          "request-examples/**.md",
-          "internals/**.md",
-          "toc.yml",
-          "*.md"
-        ],
+        "files": "**.{md|yml}",
         "exclude": [
           "**/README.md"
         ]
@@ -44,25 +36,14 @@
         ]
       }
     ],
-    "overwrite": [
-      {
-        "exclude": [
-          "obj/**",
-          "_site/**"
-        ]
-      }
-    ],
-    "dest": "_site",
-    "globalMetadataFiles": [],
-    "fileMetadataFiles": [],
+    "output": "_site",
     "template": [
       "default",
       "modern"
     ],
-    "postProcessors": [],
-    "noLangKeyword": false,
-    "keepFileLink": false,
-    "cleanupCacheHistory": false,
-    "disableGitFeatures": false
+    "globalMetadata": {
+      "_appLogoPath": "styles/img/favicon.png",
+      "_googleAnalyticsTagId": "G-78GTGF1FM2"
+    }
   }
 }
diff --git a/docs/home/index.html b/docs/home/index.html
@@ -31,6 +31,13 @@
       darkModeStyleSheet.disabled = true;
     }
   </script>
+  <script async src="https://www.googletagmanager.com/gtag/js?id=G-78GTGF1FM2"></script>
+  <script>
+    window.dataLayer = window.dataLayer || [];
+    function gtag() { dataLayer.push(arguments); }
+    gtag('js', new Date());
+    gtag('config', 'G-78GTGF1FM2');
+  </script>
 </head>
 <body>
   <div class="container-xl">

Original file line number	Diff line number	Diff line change
`@@ -35,6 +35,8 @@ if (-Not $NoBuild -Or -Not (Test-Path -Path _site)) {`
`35`	`35`	`VerifySuccessExitCode`
`36`	`36`
`37`	`37`	`Invoke-Expression ./generate-examples.ps1`
	`38`	`+} else {`
	`39`	`+ Remove-Item _site/xrefmap.yml -ErrorAction Ignore`
`38`	`40`	`}`
`39`	`41`
`40`	`42`	`dotnet tool restore`