Fix broken p5.* reference links in reference pages

rakesh2OO5 · ksen0 · commit ed6608ba3f81 · 2026-02-11T11:04:11.000+01:00
diff --git a/src/layouts/ReferenceItemLayout.astro b/src/layouts/ReferenceItemLayout.astro
@@ -90,7 +90,15 @@ const descriptionParts = description.split(
   /(<pre><code class="language-js(?: example)?">[\s\S]+?<\/code><\/pre>)/gm
 );
 
----
+// Normalizes malformed p5.* reference anchors (e.g. "#/p5.Element")
+// to proper reference routes ("/reference/p5/p5.Element/")
+function normalizeP5ReferenceLinks(html) {
+  if (!html) return html;
+  return html.replace(
+    /href="#\/(p5\.[^"]+)"/g,
+    'href="/reference/p5/$1/"'
+  );
+}
 
 <Head title={entry.data.title} locale={currentLocale} />
 
@@ -208,7 +216,7 @@ const descriptionParts = description.split(
                           class="col-span-5 [&_p]:m-0 [&_p]:inline [&_a]:underline"
                     >
                       {param.type && <span>{param.type}: </span>}
-                      <span set:html={param.description} />
+                      <span set:html={normalizeP5ReferenceLinks(param.description)} />
                     </div>
                   </div>
                 ))}
@@ -226,7 +234,7 @@ const descriptionParts = description.split(
                           class="col-span-5 [&_p]:m-0 [&_p]:inline [&_a]:underline"
                         >
                           {param.type && <span>{param.type}: </span>}
-                          <span set:html={param.description} />
+                          <span set:html={normalizeP5ReferenceLinks(param.description)} />
                         </div>
                       </div>
                     )
@@ -246,7 +254,7 @@ const descriptionParts = description.split(
                       class="col-span-5 [&_p]:m-0 [&_p]:inline [&_a]:underline"
                 >
                   {entry.data.return.type && <span>{entry.data.return.type}: </span>}
-                  <span set:html={entry.data.return.description} />
+                  <span set:html={normalizeP5ReferenceLinks(entry.data.return.description)} />
                 </div>
               </div>
             </div>
