Init Commit

source/_scripts/gen_index.py

@@ -0,0 +1,24 @@
+from pathlib import Path
+
+HARDWARE_INDEX = Path(__file__).parent.parent / "hardware/index.md"
+HARDWARE_DIR = Path(__file__).parent.parent / "hardware"
+
+def generate_hardware_index():
+    boards = []
+    for board_dir in HARDWARE_DIR.iterdir():
+        if board_dir.is_dir() and (board_dir / "index.md").exists():
+            # 关键修改：使用标准Sphinx路径格式
+            boards.append(f"{board_dir.name}/index")  # 移除了./和空格
+    
+    toctree_content = (
+        "# 硬件文档中心\n\n"
+        "```{toctree}\n"
+        ":maxdepth: 2\n"
+        ":caption: 板卡列表\n"
+        ":glob:\n\n" +  # 添加glob指令增强容错性
+        "\n".join(sorted(boards)) + "\n```")
+    
+    HARDWARE_INDEX.write_text(toctree_content, encoding="utf-8")
+
+if __name__ == "__main__":
+    generate_hardware_index()