🔧 Fix documentation generation and deployment issues

- Fix Doxygen nested directory structure issue
- Update OUTPUT_DIRECTORY to 'html' to avoid nested structure
- Add automatic file copying from html/html to docs/html for GitHub Pages
- Update CI workflow to handle the new directory structure
- Fix test script to properly detect and copy documentation files
- Ensure index.html and all HTML files are generated correctly

Author: WenyinWei

.github/workflows/ci.yml

@@ -242,9 +242,12 @@ jobs:
 
     - name: Check documentation output
       run: |
-        if [ -d "docs/html" ]; then
+        if [ -d "html" ]; then
           echo "Documentation generated successfully"
-          ls -la docs/html/
+          ls -la html/
+          # Move to docs/html for GitHub Pages
+          mkdir -p docs/html
+          cp -r html/* docs/html/
         else
           echo "Documentation directory not found, creating placeholder"
           mkdir -p docs/html

Doxyfile

@@ -12,8 +12,8 @@ PROJECT_NAME           = "ZLayout EDA Library"
 PROJECT_NUMBER         = "v1.0.0"
 PROJECT_BRIEF          = "Advanced Electronic Design Automation Layout Library with Bilingual Documentation"
 PROJECT_LOGO           = 
-OUTPUT_DIRECTORY       = docs/html
-CREATE_SUBDIRS         = YES
+OUTPUT_DIRECTORY       = html
+CREATE_SUBDIRS         = NO
 ALLOW_UNICODE_NAMES    = YES
 OUTPUT_LANGUAGE        = English
 BRIEF_MEMBER_DESC      = YES

scripts/test_docs.py

@@ -34,11 +34,11 @@ def test_doxygen_generation():
     try:
         print("Generating documentation...")
         result = subprocess.run(['doxygen', 'Doxyfile'], 
-                              capture_output=True, text=True, check=True)
+                              capture_output=True, text=True, check=True, encoding='utf-8')
         print("✅ Documentation generation completed successfully")
 
         # Check if output directory was created
-        output_dir = Path("docs/html")
+        output_dir = Path("html")
         if output_dir.exists():
             print(f"✅ Output directory created: {output_dir}")
 
@@ -53,6 +53,27 @@ def test_doxygen_generation():
             files = list(output_dir.glob("*.html"))
             print(f"✅ Generated {len(files)} HTML files")
 
+            # Also check docs/html if it exists (for CI compatibility)
+            docs_html = Path("docs/html")
+            if docs_html.exists():
+                docs_files = list(docs_html.glob("*.html"))
+                print(f"✅ Found {len(docs_files)} HTML files in docs/html")
+            
+            # Copy files to docs/html for GitHub Pages deployment
+            if not docs_html.exists():
+                docs_html.mkdir(parents=True, exist_ok=True)
+            
+            # Copy all files from html/html to docs/html
+            import shutil
+            nested_html = output_dir / "html"
+            if nested_html.exists():
+                for file_path in nested_html.rglob("*"):
+                    if file_path.is_file():
+                        relative_path = file_path.relative_to(nested_html)
+                        dest_path = docs_html / relative_path
+                        dest_path.parent.mkdir(parents=True, exist_ok=True)
+                        shutil.copy2(file_path, dest_path)
+                print("✅ Copied documentation files to docs/html for GitHub Pages")
         else:
             print("❌ Output directory not created")
             return False