celerity
diff --git a/‎package-lock.json‎
Lines changed: 1 addition & 1 deletion b/‎package-lock.json‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎scripts/import_api_docs.js‎
Lines changed: 27 additions & 14 deletions b/‎scripts/import_api_docs.js‎
Lines changed: 27 additions & 14 deletions
@@ -1,10 +1,6 @@
 const fs = require("fs");
 const path = require("path");
 
-// TODO: Change so we copy files from a source directory to a destination and only include what we actually need
-// TODO: Do we actually need the api_docs.js file? Or can we just write it inline?
-// TODO: Write a _category_.json file for each subdirectory
-
 if (process.argv[2] == null) {
   console.error(
     `Usage: node ${path.basename(process.argv[1])} <input directory>`
@@ -88,24 +84,39 @@ function parseTitle(html) {
   return title;
 }
 
+/**
+ * The URLs generated by leafy-green-doc are not directly compatible with our setup,
+ * so we need to do some post-processing.
+ *
+ * FIXME: We should have options to do this in leafy-green-doc
+ */
 function fixUrls(html, allDirs) {
-  // We have to remove links to `index.html` as well as all trailing `.html` to make it work with Docusaurus
-  // FIXME: This should be done during generation instead
-  html = html.replace(/index\.html/g, "");
-  html = html.replace(/\.html/g, "");
-  // We also have to replace all relative "../" links with "../../", since in Docusaurus each file becomes a subdirectory in the URL
-  // FIXME: We should have an option to generate all URLs relative to some base URL
-
   for (const subdir of allDirs) {
+    // Replace all links to category index pages with the category directory
+    html = html.replace(
+      new RegExp(`${subdir}\/index\.html`, "g"),
+      `${subdir}/`
+    );
+    // Replace all relative "../" links with absolute paths
     html = html.replace(
-      new RegExp(`"\.\.\/${subdir}/`, "g"),
-      `"${baseUrl}/${subdir}/`
+      new RegExp(`\.\.\/${subdir}/`, "g"),
+      `${baseUrl}/${subdir}/`
     );
   }
 
+  // Finally, replace all ".html" extensions with a slash
+  html = html.replace(/\.html/g, "/");
+
   return html;
 }
 
+// Since AdaptiveCpp (formerly hipSYCL) aliases the sycl namespace to hipsycl::sycl,
+// we have to replace it in the generated HTML files.
+// TODO: We should have an option to do this in leafy-green-doc
+function replaceSyclNamespace(html) {
+  return html.replace(/hipsycl::sycl/g, "sycl");
+}
+
 function processSubdir(subdir, allDirs) {
   fs.mkdirSync(path.join(outputPath, subdir), { recursive: true });
   writeCategorySettings(subdir);
@@ -124,9 +135,11 @@ function processSubdir(subdir, allDirs) {
       const title = parseTitle(html);
       const withFixedUrls = fixUrls(html, allDirs);
 
+      const withSyclNamespace = replaceSyclNamespace(withFixedUrls);
+
       fs.writeFileSync(
         path.join(outputPath, subdir, `${fileName}.html`),
-        withFixedUrls
+        withSyclNamespace
       );
 
       writeMdx(subdir, fileName, title);