thoth-tech · rachelpatrao · Mar 26, 2026 · Apr 1, 2026
diff --git a/...-examples/terminal/write-1-example-oop.cs → ...les/terminal/write/write-1-example-oop.cs b/...-examples/terminal/write-1-example-oop.cs → ...les/terminal/write/write-1-example-oop.cs
diff --git a/...les/terminal/write-1-example-top-level.cs → ...rminal/write/write-1-example-top-level.cs b/...les/terminal/write-1-example-top-level.cs → ...rminal/write/write-1-example-top-level.cs
diff --git a/...age-examples/terminal/write-1-example.cpp → ...amples/terminal/write/write-1-example.cpp b/...age-examples/terminal/write-1-example.cpp → ...amples/terminal/write/write-1-example.cpp
diff --git a/...age-examples/terminal/write-1-example.gif → ...amples/terminal/write/write-1-example.gif b/...age-examples/terminal/write-1-example.gif → ...amples/terminal/write/write-1-example.gif
diff --git a/...sage-examples/terminal/write-1-example.py → ...xamples/terminal/write/write-1-example.py b/...sage-examples/terminal/write-1-example.py → ...xamples/terminal/write/write-1-example.py
diff --git a/...age-examples/terminal/write-1-example.txt → ...amples/terminal/write/write-1-example.txt b/...age-examples/terminal/write-1-example.txt → ...amples/terminal/write/write-1-example.txt
diff --git a/...ples/terminal/write_char-1-example-oop.cs → ...al/write_char/write_char-1-example-oop.cs b/...ples/terminal/write_char-1-example-oop.cs → ...al/write_char/write_char-1-example-oop.cs
diff --git a/...erminal/write_char-1-example-top-level.cs → ...te_char/write_char-1-example-top-level.cs b/...erminal/write_char-1-example-top-level.cs → ...te_char/write_char-1-example-top-level.cs
diff --git a/...xamples/terminal/write_char-1-example.cpp → ...minal/write_char/write_char-1-example.cpp b/...xamples/terminal/write_char-1-example.cpp → ...minal/write_char/write_char-1-example.cpp
diff --git a/...xamples/terminal/write_char-1-example.png → ...minal/write_char/write_char-1-example.png b/...xamples/terminal/write_char-1-example.png → ...minal/write_char/write_char-1-example.png
diff --git a/...examples/terminal/write_char-1-example.py → ...rminal/write_char/write_char-1-example.py b/...examples/terminal/write_char-1-example.py → ...rminal/write_char/write_char-1-example.py
diff --git a/...xamples/terminal/write_char-1-example.txt → ...minal/write_char/write_char-1-example.txt b/...xamples/terminal/write_char-1-example.txt → ...minal/write_char/write_char-1-example.txt
diff --git a/...es/terminal/write_double-1-example-oop.cs → ...rite_double/write_double-1-example-oop.cs b/...es/terminal/write_double-1-example-oop.cs → ...rite_double/write_double-1-example-oop.cs
diff --git a/...minal/write_double-1-example-top-level.cs → ...ouble/write_double-1-example-top-level.cs b/...minal/write_double-1-example-top-level.cs → ...ouble/write_double-1-example-top-level.cs
diff --git a/...mples/terminal/write_double-1-example.cpp → ...l/write_double/write_double-1-example.cpp b/...mples/terminal/write_double-1-example.cpp → ...l/write_double/write_double-1-example.cpp
diff --git a/...mples/terminal/write_double-1-example.png → ...l/write_double/write_double-1-example.png b/...mples/terminal/write_double-1-example.png → ...l/write_double/write_double-1-example.png
diff --git a/...amples/terminal/write_double-1-example.py → ...al/write_double/write_double-1-example.py b/...amples/terminal/write_double-1-example.py → ...al/write_double/write_double-1-example.py
diff --git a/...mples/terminal/write_double-1-example.txt → ...l/write_double/write_double-1-example.txt b/...mples/terminal/write_double-1-example.txt → ...l/write_double/write_double-1-example.txt
diff --git a/...mples/terminal/write_int-1-example-oop.cs → ...inal/write_int/write_int-1-example-oop.cs b/...mples/terminal/write_int-1-example-oop.cs → ...inal/write_int/write_int-1-example-oop.cs
diff --git a/...terminal/write_int-1-example-top-level.cs → ...rite_int/write_int-1-example-top-level.cs b/...terminal/write_int-1-example-top-level.cs → ...rite_int/write_int-1-example-top-level.cs
diff --git a/...examples/terminal/write_int-1-example.cpp → ...erminal/write_int/write_int-1-example.cpp b/...examples/terminal/write_int-1-example.cpp → ...erminal/write_int/write_int-1-example.cpp
diff --git a/...examples/terminal/write_int-1-example.png → ...erminal/write_int/write_int-1-example.png b/...examples/terminal/write_int-1-example.png → ...erminal/write_int/write_int-1-example.png
diff --git a/...-examples/terminal/write_int-1-example.py → ...terminal/write_int/write_int-1-example.py b/...-examples/terminal/write_int-1-example.py → ...terminal/write_int/write_int-1-example.py
diff --git a/...examples/terminal/write_int-1-example.txt → ...erminal/write_int/write_int-1-example.txt b/...examples/terminal/write_int-1-example.txt → ...erminal/write_int/write_int-1-example.txt
diff --git a/...ples/terminal/write_line-1-example-oop.cs → ...al/write_line/write_line-1-example-oop.cs b/...ples/terminal/write_line-1-example-oop.cs → ...al/write_line/write_line-1-example-oop.cs
diff --git a/...erminal/write_line-1-example-top-level.cs → ...te_line/write_line-1-example-top-level.cs b/...erminal/write_line-1-example-top-level.cs → ...te_line/write_line-1-example-top-level.cs
diff --git a/...xamples/terminal/write_line-1-example.cpp → ...minal/write_line/write_line-1-example.cpp b/...xamples/terminal/write_line-1-example.cpp → ...minal/write_line/write_line-1-example.cpp
diff --git a/...xamples/terminal/write_line-1-example.png → ...minal/write_line/write_line-1-example.png b/...xamples/terminal/write_line-1-example.png → ...minal/write_line/write_line-1-example.png
diff --git a/...examples/terminal/write_line-1-example.py → ...rminal/write_line/write_line-1-example.py b/...examples/terminal/write_line-1-example.py → ...rminal/write_line/write_line-1-example.py
diff --git a/...xamples/terminal/write_line-1-example.txt → ...minal/write_line/write_line-1-example.txt b/...xamples/terminal/write_line-1-example.txt → ...minal/write_line/write_line-1-example.txt
diff --git a/...ples/terminal/write_line-2-example-oop.cs → ...al/write_line/write_line-2-example-oop.cs b/...ples/terminal/write_line-2-example-oop.cs → ...al/write_line/write_line-2-example-oop.cs
diff --git a/...erminal/write_line-2-example-top-level.cs → ...te_line/write_line-2-example-top-level.cs b/...erminal/write_line-2-example-top-level.cs → ...te_line/write_line-2-example-top-level.cs
diff --git a/...xamples/terminal/write_line-2-example.cpp → ...minal/write_line/write_line-2-example.cpp b/...xamples/terminal/write_line-2-example.cpp → ...minal/write_line/write_line-2-example.cpp
diff --git a/...xamples/terminal/write_line-2-example.png → ...minal/write_line/write_line-2-example.png b/...xamples/terminal/write_line-2-example.png → ...minal/write_line/write_line-2-example.png
diff --git a/...examples/terminal/write_line-2-example.py → ...rminal/write_line/write_line-2-example.py b/...examples/terminal/write_line-2-example.py → ...rminal/write_line/write_line-2-example.py
diff --git a/...xamples/terminal/write_line-2-example.txt → ...minal/write_line/write_line-2-example.txt b/...xamples/terminal/write_line-2-example.txt → ...minal/write_line/write_line-2-example.txt
diff --git a/...erminal/write_line_empty-1-example-oop.cs → ...e_empty/write_line_empty-1-example-oop.cs b/...erminal/write_line_empty-1-example-oop.cs → ...e_empty/write_line_empty-1-example-oop.cs
diff --git a/...l/write_line_empty-1-example-top-level.cs → ...y/write_line_empty-1-example-top-level.cs b/...l/write_line_empty-1-example-top-level.cs → ...y/write_line_empty-1-example-top-level.cs
diff --git a/...s/terminal/write_line_empty-1-example.cpp → ...line_empty/write_line_empty-1-example.cpp b/...s/terminal/write_line_empty-1-example.cpp → ...line_empty/write_line_empty-1-example.cpp
diff --git a/...s/terminal/write_line_empty-1-example.png → ...line_empty/write_line_empty-1-example.png b/...s/terminal/write_line_empty-1-example.png → ...line_empty/write_line_empty-1-example.png
diff --git a/...es/terminal/write_line_empty-1-example.py → ..._line_empty/write_line_empty-1-example.py b/...es/terminal/write_line_empty-1-example.py → ..._line_empty/write_line_empty-1-example.py
diff --git a/...s/terminal/write_line_empty-1-example.txt → ...line_empty/write_line_empty-1-example.txt b/...s/terminal/write_line_empty-1-example.txt → ...line_empty/write_line_empty-1-example.txt
diff --git a/.../terminal/write_line_int-1-example-oop.cs → ..._line_int/write_line_int-1-example-oop.cs b/.../terminal/write_line_int-1-example-oop.cs → ..._line_int/write_line_int-1-example-oop.cs
diff --git a/...nal/write_line_int-1-example-top-level.cs → ...int/write_line_int-1-example-top-level.cs b/...nal/write_line_int-1-example-top-level.cs → ...int/write_line_int-1-example-top-level.cs
diff --git a/...les/terminal/write_line_int-1-example.cpp → ...ite_line_int/write_line_int-1-example.cpp b/...les/terminal/write_line_int-1-example.cpp → ...ite_line_int/write_line_int-1-example.cpp
diff --git a/...les/terminal/write_line_int-1-example.png → ...ite_line_int/write_line_int-1-example.png b/...les/terminal/write_line_int-1-example.png → ...ite_line_int/write_line_int-1-example.png
diff --git a/...ples/terminal/write_line_int-1-example.py → ...rite_line_int/write_line_int-1-example.py b/...ples/terminal/write_line_int-1-example.py → ...rite_line_int/write_line_int-1-example.py
diff --git a/...les/terminal/write_line_int-1-example.txt → ...ite_line_int/write_line_int-1-example.txt b/...les/terminal/write_line_int-1-example.txt → ...ite_line_int/write_line_int-1-example.txt
diff --git a/scripts/api-pages-script.cjs b/scripts/api-pages-script.cjs
@@ -75,20 +75,23 @@ const sk_colors = ["alice_blue", "antique_white", "aqua", "aquamarine", "azure",
 // ------------------------------------------------------------------------------
 // Get a list of all the files in a directory and it's subdirectories
 // ------------------------------------------------------------------------------
-function getAllFiles(dir, allFilesList = []) {
+function getAllFiles(dir, baseDir = dir, allFilesList = []) {
   try {
     const files = fs.readdirSync(dir);
-    files.map(file => {
-      const name = dir + '/' + file;
-      if (fs.statSync(name).isDirectory()) { // check if subdirectory is present
-        getAllFiles(name, allFilesList);     // do recursive execution for subdirectory
+
+    files.forEach((file) => {
+      const fullPath = path.join(dir, file);
+
+      if (fs.statSync(fullPath).isDirectory()) {
+        getAllFiles(fullPath, baseDir, allFilesList);
       } else {
-        allFilesList.push(file);             // push filename into the array
+        allFilesList.push(path.relative(baseDir, fullPath).replaceAll("\\", "/"));
       }
-    })
+    });
   } catch (err) {
     console.error(kleur.yellow(`Warning: Unable to access directory ${dir}`), err);
   }
+
   return allFilesList;
 }
 
@@ -247,19 +250,19 @@ function getUsageExampleImports(categoryKey, functionKey) {
   let categoryPath = '/usage-examples/' + categoryKey;
   let categoryFilePath = './public/usage-examples/' + categoryKey;
 
-  const functionFiles = getAllFiles(categoryFilePath).filter(file => file.startsWith(functionKey));
+  const functionFiles = getAllFiles(categoryFilePath).filter(file => path.basename(file).startsWith(functionKey));
   if (functionFiles.length > 0) {
     const txtFiles = functionFiles.filter(file => file.endsWith('.txt'))
     if (txtFiles.length > 0) {
       txtFiles.forEach((exampleTxtKey) => {
-        let exampleKey = exampleTxtKey.replaceAll(".txt", "");
+        let exampleKey = path.basename(exampleTxtKey).replaceAll(".txt", "");
 
         let importTitle = exampleKey.replaceAll("-", "_");
 
         languageOrder.forEach((lang) => {
           const languageFiles = functionFiles.filter(file => file.endsWith(languageFileExtensions[lang]));
-          let codeFilePath = categoryPath + "/" + exampleTxtKey.replaceAll(".txt", languageFileExtensions[lang]);
 
+          let codeFilePath = categoryPath + "/" + exampleTxtKey.replaceAll(".txt", languageFileExtensions[lang]);
           // import code if available
           if (languageFiles.length > 0) {
             languageCodeAvailable[lang] = true;
@@ -335,7 +338,7 @@ function getUsageExampleContent(jsonData, categoryKey, groupName, functionKey) {
   let categoryFilePath = './public/usage-examples/' + categoryKey;
 
   let exampleKey = functionKey.replaceAll(".txt", "");
-  const functionFiles = getAllFiles(categoryFilePath).filter(file => file.startsWith(exampleKey));
+  const functionFiles = getAllFiles(categoryFilePath).filter(file => path.basename(file).startsWith(exampleKey));
 
   if (functionFiles.length > 0) {
 
@@ -344,10 +347,10 @@ function getUsageExampleContent(jsonData, categoryKey, groupName, functionKey) {
 
       // import code if available
       if (functionFiles.length > 0) {
-        let importTitle = exampleKey.replaceAll("-", "_");
+        let importTitle = path.basename(exampleTxtKey).replaceAll(".txt", "").replaceAll("-", "_");
 
         // Description
-        let exampleNum = exampleKey.replace(/\D/g, '');
+        let exampleNum = path.basename(exampleTxtKey).replace(/\D/g, '');
         mdxData += `**Example ${exampleNum}**: `;
         let exampleTxt = fs.readFileSync(categoryFilePath + "/" + exampleTxtKey);
         mdxData += exampleTxt.toString();
@@ -368,7 +371,7 @@ function getUsageExampleContent(jsonData, categoryKey, groupName, functionKey) {
               // Check if both top level and oop code has been found for current function
               const csharpFiles = functionFiles.filter(file => file.endsWith("-top-level.cs") || file.endsWith("-oop.cs")).filter(file => file.includes(exampleKey));
               const cppFiles = functionFiles.filter(file => file.endsWith("-sk.cpp") || file.endsWith("-beyond.cpp")).filter(file => file.includes(exampleKey));
-              functionTag = exampleKey.split("-")[0];
+              functionTag = path.basename(exampleTxtKey).split("-")[0];
               if (lang == "cpp") {
                 functionTag = groupName;
               }
@@ -417,14 +420,14 @@ function getUsageExampleContent(jsonData, categoryKey, groupName, functionKey) {
       let outputFilePath = categoryPath + "/" + exampleTxtKey;
 
 
-      const imageFiles = functionFiles.filter(file => file.endsWith(exampleKey + '.png'));
+      const imageFiles = functionFiles.filter(file => path.basename(file) === path.basename(exampleTxtKey).replaceAll(".txt", ".png"));
       // Check for .png files
       if (imageFiles.length > 0) {
         outputFilePath = outputFilePath.replaceAll(".txt", ".png");
         mdxData += `![${exampleKey} example](${outputFilePath})\n`
       }
       else {
-        const gifFiles = functionFiles.filter(file => file.endsWith('.gif')).filter(file => file.startsWith(exampleKey));
+        const gifFiles = functionFiles.filter(file => file.endsWith('.gif')).filter(file => path.basename(file).startsWith(path.basename(exampleTxtKey).replaceAll(".txt", "")));
         // Check for .gif files
         if (gifFiles.length > 0) {
           outputFilePath = outputFilePath.replaceAll(".txt", ".gif");