Add docfx website for documentation

.config/dotnet-tools.json

@@ -0,0 +1,13 @@
+{
+  "version": 1,
+  "isRoot": true,
+  "tools": {
+    "docfx": {
+      "version": "2.78.2",
+      "commands": [
+        "docfx"
+      ],
+      "rollForward": false
+    }
+  }
+}

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "docs/bonsai"]
+	path = docs/bonsai
+	url = https://github.com/bonsai-rx/docfx-tools

docs/.gitignore

@@ -0,0 +1 @@
+_site

docs/api/.gitignore

@@ -0,0 +1,2 @@
+*.yml
+.manifest

docs/articles/toc.yml

@@ -0,0 +1 @@
+- href: ../index.md

docs/build.ps1

@@ -0,0 +1,2 @@
+.\bonsai\modules\Export-Image.ps1 "..\Bonsai.Sgen\bin\Release\net6.0"
+dotnet docfx @args

docs/docfx.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "https://raw.githubusercontent.com/dotnet/docfx/main/schemas/docfx.schema.json",
+  "metadata": [
+    {
+      "src": [
+        {
+          "src": "../",
+          "files": [
+            "**/*.csproj"
+          ]
+        }
+      ],
+      "dest": "api",
+      "filter": "filter.yml",
+      "enumSortOrder": "declaringOrder",
+      "memberLayout": "separatePages"
+    }
+  ],
+  "build": {
+    "content": [
+      {
+        "files": [
+          "**/*.{md,yml}"
+        ],
+        "exclude": [
+          "_site/**",
+          "filter.yml",
+          "apidoc/**"
+        ]
+      }
+    ],
+    "resource": [
+      {
+        "files": [
+          "logo.svg",
+          "favicon.ico",
+          "images/**",
+          "workflows/**"
+        ]
+      }
+    ],
+    "overwrite": [
+      {
+        "files": [
+          "apidoc/**.md"
+        ],
+        "exclude": [
+          "obj/**",
+          "_site/**"
+        ]
+      }
+    ],
+    "output": "_site",
+    "template": [
+      "default",
+      "modern",
+      "bonsai/template",
+      "template"
+    ],
+    "globalMetadata": {
+      "_appName": "Bonsai - SGEN",
+      "_appTitle": "Bonsai.SGEN",
+      "_appFooter": "&copy; 2025 Bonsai Foundation CIC and Contributors. Made with <a href=\"https://dotnet.github.io/docfx\">docfx</a>",
+      "_enableSearch": true,
+      "pdf": false
+    },
+    "markdownEngineProperties": {
+      "markdigExtensions": [
+      "attributes",
+      "customcontainers"
+      ]
+    },
+    "xref": [
+      "https://bonsai-rx.org/docs/xrefmap.yml"
+    ]
+  }
+}

docs/filter.yml

@@ -0,0 +1,4 @@
+apiRules:
+- exclude:
+    hasAttribute:
+      uid: System.ObsoleteAttribute

docs/index.md

@@ -0,0 +1,4 @@
+---
+uid: intro
+title: "Introduction"
+---

docs/template/public/main.css

@@ -0,0 +1 @@
+@import "workflow.css";

docs/template/public/main.js

@@ -0,0 +1,13 @@
+import WorkflowContainer from "./workflow.js"
+
+export default {
+    defaultTheme: 'auto',
+    iconLinks: [{
+        icon: 'github',
+        href: 'https://github.com/bonsai-rx/sgen',
+        title: 'GitHub'
+    }],
+    start: () => {
+        WorkflowContainer.init();
+    }
+}

docs/toc.yml

@@ -0,0 +1,4 @@
+- name: Docs
+  href: articles/
+- name: API
+  href: api/

docs/workflows/.gitignore

@@ -0,0 +1,2 @@
+*.layout
+*.svg