Merge branch 'main' of https://github.com/sustech-cs304/team-project-25spring-88

Author: faintcicado

.github/workflows/main.yml

@@ -3,7 +3,7 @@ name: Unity CI
 on: [ push, pull_request ]
 
 permissions:
-  contents: read
+  contents: write
   pages: write
   id-token: write
 
@@ -105,11 +105,15 @@ jobs:
         dotnet-version: 9.x
 
     - name: Install DocFX
-      run: dotnet tool update -g docfx
+      run: |
+        dotnet tool update -g docfx
+        docfx template install default
+        docfx template install material-design
 
     - name: Build Documentation
       working-directory: team_project # 进入项目目录
       run: |
+        docfx metadata Documentation/docfx.json
         docfx build Documentation/docfx.json
 
     - name: Upload artifact

final-report-88.md

@@ -5,13 +5,13 @@
    Race through a detailed and immersive map inspired by SUSTech’s campus.
 
 2. **Regular Racing Mode**
-   Classic racing for speed enthusiasts.
+   Classic time trial mode for speed enthusiasts.
 
 3. **Item Race**
-   Use power-ups and items to outsmart opponents.  
+   A solo time trial mode with item boxes—collect random power-ups to boost your performance or add challenges.
 
 4. **Electric Vehicles vs Security Guard (PvE Mode)**
-   A unique player-vs-environment challenge.
+   Outrun an AI-controlled security guard in this thrilling PvE challenge—get caught and the race is over!
 
 5. **Racing with Friends**
    Connect with your friends via local networks and have a race together!

team_project/Documentation/docfx.json

@@ -26,32 +26,23 @@
         }
     ],
     "build": {
+        "template": ["default", "material-design"],
+        "exportApiNamespaceToc": true,
         "globalMetadata": {
-            "_appTitle": "Example Unity documentation",
-            "_appFooter": "Example Unity documentation",
-            "_enableSearch": true
+            "_appTitle": "SUSTech Racing Car Documentation",
+            "_appFooter": "Generated by DocFX",
+            "_enableSearch": true,
+            
+            "_appLandingPage": "index.html",
+            "_namespaceLayout": "NamespaceLayout.html"
         },
         "content": [
-            {
-                "files": [
-                    "toc.yml",
-                    "index.md"
-                ]
-            },
             {
                 "src": "api",
                 "files": [
                     "*.yml"
                 ],
-                "dest": "api"
-            },
-            {
-                "src": "manual",
-                "files": [
-                    "toc.yml",
-                    "*.md"
-                ],
-                "dest": "manual"
+                "dest": "./"
             }
         ],
         "overwrite": [
@@ -84,6 +75,7 @@
         "xrefService": [
             "https://xref.docs.microsoft.com/query?uid={uid}"
         ],
-        "dest": "../_site"
+        "dest": "../_site",
+        "homepage": "index.html"
     }
 }