Updated docs generation

Author: jeremyfa

gen-docs-and-copy.sh

@@ -0,0 +1,2 @@
+#!/bin/bash
+./gen-docs.sh && rm -rf ../ceramic-engine.github.io/content/api-docs && cp -r docs-md ../ceramic-engine.github.io/content/api-docs

gen-docs.sh

@@ -49,8 +49,16 @@ for xml_file in docs-xml/*.xml; do
     # Generate table of contents
     echo "Generating table of contents for $base_name..."
     node gen-docs/bin/gen-docs.js toc "$xml_file" "docs-md/$base_name/toc.json"
+    
+    # Generate index
+    echo "Generating index for $base_name..."
+    node gen-docs/bin/gen-docs.js index "docs-md/$base_name/toc.json" "docs-md/$base_name/index.md" "$base_name"
 done
 
+# Generate root index
+echo "Generating root index..."
+node gen-docs/bin/gen-docs.js root-index "docs-md"
+
 # Old dox command (commented out since we're using our own generator now)
 # $(ceramic haxelib) run dox -i ./docs --output-path docs --keep-field-order --exclude 'zpp_nape|microsoft|unityengine|fuzzaldrin|gif|timestamp|stb|sys|spec|sdl|polyline|poly2tri|opengl|openal|ogg|js|hsluv|hscript|glew|format|earcut|cs|cpp|com|assets|ceramic.scriptable|ceramic.macros' --title 'Ceramic API'
 

gen-docs/src/Main.hx

@@ -38,6 +38,22 @@ class Main {
                 }
                 generateToc(args[1], args[2]);
 
+            case "index":
+                if (args.length < 4) {
+                    Sys.println("Error: Missing toc file, output file, or target");
+                    printUsage();
+                    Sys.exit(1);
+                }
+                generateIndex(args[1], args[2], args[3]);
+                
+            case "root-index":
+                if (args.length < 2) {
+                    Sys.println("Error: Missing output directory");
+                    printUsage();
+                    Sys.exit(1);
+                }
+                generateRootIndex(args[1]);
+                
             default:
                 // Legacy mode: if first argument is a file, generate JSON
                 if (FileSystem.exists(command) && !FileSystem.isDirectory(command)) {
@@ -55,11 +71,15 @@ class Main {
         Sys.println("  node gen-docs.js json <xml-file>");
         Sys.println("  node gen-docs.js markdown <xml-file> <output-dir>");
         Sys.println("  node gen-docs.js toc <xml-file> <output-file>");
+        Sys.println("  node gen-docs.js index <toc-file> <output-file> <target>");
+        Sys.println("  node gen-docs.js root-index <output-dir>");
         Sys.println("");
         Sys.println("Examples:");
         Sys.println("  node gen-docs.js json ../docs-xml/clay-native.xml");
         Sys.println("  node gen-docs.js markdown ../docs-xml/clay-native.xml ../docs-md/clay-native");
         Sys.println("  node gen-docs.js toc ../docs-xml/clay-native.xml ../docs-md/clay-native/toc.json");
+        Sys.println("  node gen-docs.js index ../docs-md/clay-native/toc.json ../docs-md/clay-native/index.md clay-native");
+        Sys.println("  node gen-docs.js root-index ../docs-md");
     }
 
     static function generateJson(xmlPath:String):Void {
@@ -99,9 +119,12 @@ class Main {
 
             Sys.println('Parsed ${apiData.types.length} types from $xmlPath');
 
+            // Extract target from output directory (e.g., "docs-md/clay-native" -> "clay-native")
+            var target = Path.withoutDirectory(outputDir);
+            
             // Generate markdown files
             var generator = new MarkdownGenerator();
-            generator.generateMarkdown(apiData, outputDir);
+            generator.generateMarkdown(apiData, outputDir, target);
 
             Sys.println('Generated markdown documentation in $outputDir');
 
@@ -141,4 +164,60 @@ class Main {
             Sys.exit(1);
         }
     }
+    
+    static function generateIndex(tocFile:String, outputFile:String, target:String):Void {
+        if (!FileSystem.exists(tocFile)) {
+            Sys.println('Error: File not found: $tocFile');
+            Sys.exit(1);
+        }
+        
+        try {
+            // Generate index from TOC
+            var generator = new TocGenerator();
+            generator.generateIndexFromToc(tocFile, outputFile, target);
+            
+            Sys.println('Generated index in $outputFile');
+            
+        } catch (e:Dynamic) {
+            Sys.println('Error: $e');
+            #if debug
+            Sys.println(haxe.CallStack.toString(haxe.CallStack.exceptionStack()));
+            #end
+            Sys.exit(1);
+        }
+    }
+    
+    static function generateRootIndex(outputDir:String):Void {
+        if (!FileSystem.exists(outputDir)) {
+            Sys.println('Error: Directory not found: $outputDir');
+            Sys.exit(1);
+        }
+        
+        try {
+            // Find all subdirectories in the output directory
+            var targets = [];
+            for (item in FileSystem.readDirectory(outputDir)) {
+                var path = Path.join([outputDir, item]);
+                if (FileSystem.isDirectory(path) && FileSystem.exists(Path.join([path, "index.md"]))) {
+                    targets.push(item);
+                }
+            }
+            
+            // Sort targets for consistent output
+            targets.sort(Reflect.compare);
+            
+            // Generate root index
+            var generator = new TocGenerator();
+            generator.generateRootIndex(targets, Path.join([outputDir, "index.md"]));
+            
+            Sys.println('Generated root index in $outputDir/index.md');
+            
+        } catch (e:Dynamic) {
+            Sys.println('Error: $e');
+            #if debug
+            Sys.println(haxe.CallStack.toString(haxe.CallStack.exceptionStack()));
+            #end
+            Sys.exit(1);
+        }
+    }
 }