chore: now DocLink works without keys

astro.config.mjs

@@ -10,7 +10,7 @@ import starlightHeadingBadges from "starlight-heading-badges";
 export default defineConfig({
   site: process.env.CPPDOC_SITE,
   base: process.env.CPPDOC_BASE,
-  trailingSlash: "never",
+  trailingSlash: "always",
   integrations: [
     starlight({
       title: "CppDoc",

src/components/DocLink.astro

@@ -1,16 +1,15 @@
 ---
-import { getLinkToKey } from "../lib/doc-index";
+import { isLinkMissing, normalizeLink } from "../lib/doc-link";
 
 interface Props {
   src: string;
   section?: string;
 }
 
 const { src, section } = Astro.props;
-const rawLink = await getLinkToKey(src);
 
-const missing = rawLink === undefined;
-const link = rawLink ? rawLink + (section ? "#" + section : "") : "";
+const missing = await isLinkMissing(src);
+const link = normalizeLink(src) + (section ? "#" + section : "");
 ---
 
 {

src/content/docs/development/migration/guideline.mdx

@@ -5,11 +5,12 @@ sidebar:
 ---
 
 import { Aside } from "@astrojs/starlight/components";
+import DocLink from "@components/DocLink.astro"
 
 This document gives guidelines to migrate content from cppreference to CppDoc.
 
 <Aside type="tip">
-  For a more detailed guideline about writing CppDoc contents, please check out the [development guideline](../guide).
+  For a more detailed guideline about writing CppDoc contents, please check out the <DocLink src="/development/guide">development guideline</DocLink>.
 </Aside>
 
 <Aside type="note">
@@ -35,4 +36,4 @@ The `since` and `until` fields are both optional.
 
 ## Cross References
 
-Cross references are links within a CppDoc page that point to another CppDoc page. Please make sure all cross references are established using the [`DocLink` component](../guide/doc-everything#link-to-another-cppdoc-page).
+Cross references are links within a CppDoc page that point to another CppDoc page. Please make sure all cross references are established using the <DocLink src="/development/guide/doc-everything" section="link-to-another-cppdoc-page">`DocLink` component</DocLink>.

src/lib/doc-link.ts

@@ -0,0 +1,27 @@
+import { getEntry } from "astro:content";
+
+function getIdFromLink(link: string): string {
+  if (link.startsWith("/")) {
+    link = link.slice(1);
+  }
+  if (link.endsWith("/")) {
+    link = link.slice(0, -1);
+  }
+  return link;
+}
+
+export function normalizeLink(link: string): string {
+  if (!link.startsWith("/")) {
+    link = "/" + link;
+  }
+  if (!link.endsWith("/")) {
+    link = link + "/";
+  }
+  return link;
+}
+
+export async function isLinkMissing(link: string): Promise<boolean> {
+  const id = getIdFromLink(link);
+  const entry = await getEntry("docs", id);
+  return entry === undefined;
+}