Introduce ReHype Plugin to remove .md from links

This uses ReHype to remove the `.md` file extension. Also set the content directory to a root path for WebStorm so you get proper path checking and validation when authoring.

Author: khalidabuhakmeh

.idea/compiler.xml

@@ -1,4 +1,3 @@
-// @ts-check
 import { defineConfig, fontProviders } from "astro/config";
 import starlight from "@astrojs/starlight";
 import starlightLinksValidator from "starlight-links-validator";
@@ -10,10 +9,14 @@ import starlightHeadingBadges from "starlight-heading-badges";
 import starlightLlmsTxt from "starlight-llms-txt";
 import rehypeAstroRelativeMarkdownLinks from "astro-rehype-relative-markdown-links";
 import opengraphImages from "astro-opengraph-images";
-import { duendeOpenGraphImage } from "./src/components/duende-og-image.js";
 import rehypeExternalLinks from "rehype-external-links";
 import * as fs from "node:fs";
 
+// don't convert to path aliases, it doesn't work here
+// https://github.com/withastro/astro/issues/9782
+import { duendeOpenGraphImage } from "./src/plugins/duende-og-image.js";
+import removeMarkdownExtensions from "./src/plugins/remove-markdown-extensions.js";
+
 // https://astro.build/config
 export default defineConfig({
   site: "https://docs.duendesoftware.com",
@@ -199,6 +202,7 @@ export default defineConfig({
           rel: ["noopener", "noreferrer"],
         },
       ],
+      [removeMarkdownExtensions, {}],
     ],
   },
 });

.idea/webResources.xml

@@ -25,6 +25,7 @@
   "dependencies": {
     "@astrojs/markdown-remark": "^6.3.1",
     "@astrojs/starlight": "^0.34.0",
+    "@astrojs/ts-plugin": "^1.10.4",
     "@fontsource/roboto": "^5.2.5",
     "@pasqal-io/starlight-client-mermaid": "^0.1.0",
     "@resvg/resvg-js": "^2.6.2",

astro.config.mjs

@@ -10,7 +10,7 @@ redirect_from:
   - /identityserver/v7/apis/aspnetcore/confirmation/
 ---
 
-IdentityServer can [bind tokens to clients](/identityserver/tokens/pop#proof-of-possession-styles) using either mTLS or DPoP, creating a `Proof-of-Possession` (PoP) access token. When one of these mechanisms is used, APIs that use those access tokens for authorization need to validate the binding between the client and token. This document describes how to perform such validation, depending on which mechanism was used to produce a PoP token.
+IdentityServer can [bind tokens to clients](/identityserver/tokens/pop.md#proof-of-possession-styles) using either mTLS or DPoP, creating a `Proof-of-Possession` (PoP) access token. When one of these mechanisms is used, APIs that use those access tokens for authorization need to validate the binding between the client and token. This document describes how to perform such validation, depending on which mechanism was used to produce a PoP token.
 
 ### Validating mTLS
 

package-lock.json

@@ -0,0 +1,37 @@
+import { visit } from "unist-util-visit";
+import type { Node, Parent } from "unist";
+
+interface Element extends Parent {
+  type: "element";
+  tagName: string;
+  properties: {
+    [key: string]: unknown;
+  };
+  content: Node;
+  children: Node[];
+}
+
+export default function removeMarkdownExtensions(): (tree: Node) => void {
+  return (tree: Node) => {
+    visit(tree, "element", (node: Element) => {
+      if (
+        node.tagName === "a" &&
+        node.properties &&
+        typeof node.properties.href === "string"
+      ) {
+        const markdownExtensionRegex = /\.md(#.*)?$/;
+        if (markdownExtensionRegex.test(node.properties.href)) {
+          let date = new Date().toLocaleTimeString("en-US", { hour12: false });
+          console.log(
+            `\x1b[90m${date}\x1b[0m \x1b[95m[🔥 *.md]\x1b[0m ${node.properties.href}`,
+          );
+
+          node.properties.href = node.properties.href.replace(
+            markdownExtensionRegex,
+            "$1",
+          );
+        }
+      }
+    });
+  };
+}

package.json

@@ -3,9 +3,17 @@
   "include": [".astro/types.d.ts", "**/*"],
   "exclude": ["dist"],
   "compilerOptions": {
+    "verbatimModuleSyntax": true,
     "baseUrl": ".",
     "paths": {
-      "~/*": ["src/*"]
-    }
+      "~/*": ["src/*"],
+      "@plugins/*": ["src/plugins/*"],
+      "@components/*": ["src/components/*"]
+    },
+    "plugins": [
+      {
+        "name": "@astrojs/ts-plugin"
+      }
+    ]
   }
 }