新建

.idea/.gitignore

@@ -0,0 +1,8 @@
+# 默认忽略的文件
+/shelf/
+/workspace.xml
+# 基于编辑器的 HTTP 客户端请求
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

.idea/MKDocs_university_pro.iml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="jdk" jdkName="Python 3.12 (python)" jdkType="Python SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,16 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="Eslint" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="HtmlUnknownAttribute" enabled="true" level="WARNING" enabled_by_default="true">
+      <option name="myValues">
+        <value>
+          <list size="1">
+            <item index="0" class="java.lang.String" itemvalue="lay-affix" />
+          </list>
+        </value>
+      </option>
+      <option name="myCustomValuesEnabled" value="true" />
+    </inspection_tool>
+  </profile>
+</component>

.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

.idea/misc.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectRootManager" version="2" project-jdk-name="Python 3.12 (python)" project-jdk-type="Python SDK" />
+  <component name="PyPackaging">
+    <option name="earlyReleasesAsUpgrades" value="true" />
+  </component>
+</project>

.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/MKDocs_university_pro.iml" filepath="$PROJECT_DIR$/.idea/MKDocs_university_pro.iml" />
+    </modules>
+  </component>
+</project>

.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

README.md

@@ -0,0 +1,9 @@
+# GiteePage入门指南
+
+![](https://api.travis-ci.org/Bohan-hu/HITSZ-COMP2008-Course.svg?branch=master)
+
+- 声明：本课程资料仅限于哈尔滨工业大学（深圳）《XXXXX》202X秋/春/夏季课程使用，严禁扩散或用作其他用途。
+
+- 课程主页及指导书地址：[https://hitsz-cslab.gitee.io/gitee-page-demo/](https://hitsz-cslab.gitee.io/gitee-page-demo/)
+
+- 学生实验包下载地址：[stupkt目录](https://gitee.com/hitsz-cslab/gitee-page-demo/tree/master/stupkt)

docs/homewk.md

@@ -0,0 +1,71 @@
+# 作业提交说明
+
+## 1. 登陆
+
+&emsp;&emsp;学生端登陆网址：<a href="http://labgrader.hitsz.edu.cn:8000/" target="_blank">labgrader.hitsz.edu.cn:8000</a>。推荐使用Chrome浏览器，初始用户名/密码均为学号。
+
+&emsp;&emsp;初始登陆之后建议修改自己的密码，步骤见本页的“5.修改密码”。
+
+![](homewk.assets/000.png)
+
+![](homewk.assets/000.png)
+
+## 2. 查看课程
+
+&emsp;&emsp;登录之后即可查看自己所选的课程。
+
+![](homewk.assets/000.png)
+
+&emsp;&emsp;点击进入课程即可查看课程详细内容。
+
+&emsp;&emsp;特别注意作业提交的 **截止时间**！
+
+![](homewk.assets/000.png)
+
+## 3. 提交作业
+
+&emsp;&emsp;点击 **开始作答** 进行作业作答或提交。
+
+![](homewk.assets/000.png)
+
+&emsp;&emsp;开始作答页面：
+
+![](homewk.assets/000.png)
+
+&emsp;&emsp;点击File input选择需要提交的文件进行作业提交
+
+![](homewk.assets/000.png)
+
+&emsp;&emsp;选择完成后，点击页面右下角提交按钮完成提交
+
+&emsp;&emsp;**看到页面跳转后，表示已提交成功。中途关闭浏览器将导致提交失败！**
+
+![](homewk.assets/000.png)
+
+![](homewk.assets/000.png)
+
+![](homewk.assets/000.png)
+
+## 4. 重新提交作业
+
+&emsp;&emsp;提交作业后，截止时间前仍可重新提交作业。
+
+![](homewk.assets/000.png)
+
+## 5. 修改密码
+
+&emsp;&emsp;点击右上角账号信息即可进入密码修改
+
+![](homewk.assets/000.png)
+
+![](homewk.assets/000.png)
+
+## 6. 注意事项
+
+&emsp;&emsp;（1）截止时间前可重新提交作业，目前不限提交次数；
+
+&emsp;&emsp;（2）请注意提交截止时间，截止时间后无法提交作业；
+
+&emsp;&emsp;（3）注意提交作业时文件压缩包后缀目前仅支持.zip；
+
+&emsp;&emsp;（4）目前不支持提交大于100MB的文件。

docs/index.md

@@ -0,0 +1,19 @@
+# 课程概况
+
+<!-- 网页用途声明————建议保留！ -->
+!!! warning "声明 :loudspeaker:"
+    &emsp;&emsp;本课程资料仅限哈尔滨工业大学（深圳）《XXXXX》202X秋/春/夏季课程使用，严禁扩散或用作其他用途。
+
+&emsp;&emsp;本实验文档为哈尔滨工业大学（深圳）《XXXXX》课程实验指导材料。页面顶端为各个实验项目的指导书；页面左侧为指导书的各个小节目录，右侧为小节内的索引，页面右上角可详细搜索，页面下方可切换上下小节。请务必按顺序阅读指导书，有问题积极在群内提出。
+
+&emsp;&emsp;
+
+# 其他
+
+## 1. 参考资料及实验包下载
+
+&emsp;&emsp;<a href="https://gitee.com/hitsz-cslab/gitee-page-demo/tree/master/stupkt" target="_blank">点击下载参考资料和实验包</a>
+
+## 2. 作业提交方式
+
+&emsp;&emsp;提交作业的方法和流程见页面左侧《[作业提交说明](./homewk/)》。

docs/lab1/extra.md

@@ -0,0 +1,14 @@
+# 附加题
+
+## 题目1：XXX（<font color=green>**+1**</font>分）
+
+&emsp;&emsp;XXXXX
+
+
+## 题目2：XXX（<font color=green>**+2**</font>分）
+
+&emsp;&emsp;XXXXX
+
+!!! hint "提示 :bulb:"
+    &emsp;&emsp;XXXXX
+

docs/lab1/overview.md

@@ -0,0 +1,12 @@
+## 实验目的
+
+  1. XXXXX；
+
+  2. XXXXX；
+
+  3. XXXXX。
+
+
+## 实验内容
+
+  XXXXX

docs/lab1/step.md

@@ -0,0 +1,13 @@
+# 实验步骤
+
+## 1. XXX
+
+  XXXXX
+
+## 2. XXX
+
+  XXX
+
+### 2.1 XXX
+
+  XXXXX

docs/lab1/submit.md

@@ -0,0 +1,24 @@
+# 验收与提交
+
+## 实验报告要求
+
+  实验报告需包含以下内容：
+
+  （1）XXX；
+
+  （2）XXX；
+
+  （3）XXX。
+
+## 验收与提交要求
+
+- 必做题：
+
+    检查实验现象（XX%）；
+
+&emsp;&emsp;&emsp;&emsp;将源码及实验报告打包成.zip，以“<font color=orange>**学号_姓名_XXX实验1.zip**</font>”命名并提交（XX%）。
+
+- 附加题：打包提交源码；实验报告的要求见题目。
+
+!!! warning "作业提交 :calendar:"
+    &emsp;&emsp;作业提交<font color = red>**Deadline**</font>：<font color = purple>**下周同一上课时间前**</font>。

docs/lab1/theory.md

@@ -0,0 +1,99 @@
+# 实验原理
+
+## 1. 字体及链接
+
+无缩进
+
+<!-- &emsp;是全角空格，相当于4个英文空格 -->
+&emsp;&emsp;添加空格缩进
+
+&emsp;&emsp;默认字体
+
+&emsp;&emsp;*斜体*
+
+&emsp;&emsp;**粗体**
+
+&emsp;&emsp;^^下划线^^
+
+&emsp;&emsp;~~删除线~~
+
+&emsp;&emsp;更改字体<font color=orange>颜色</font>
+
+&emsp;&emsp;使用Markdown原生语法添加的超链接（当前标签页打开）：[Bing搜素引擎](https://cn.bing.com)。
+
+&emsp;&emsp;使用内嵌HTML添加的超链接（新标签页打开）：<a href="https://cn.bing.com/" target="_blank">Bing搜索引擎</a>。
+
+
+## 2. 图表
+
+### 2.1 图片示例
+
+&emsp;&emsp;使用Markdown原生语法添加的图片：
+
+![图片描述](assets/3-1.png)  <!-- 可以是本地图片或网络图片 -->
+
+&emsp;&emsp;使用内嵌HTML添加的图片（支持居中、调节大小等）：
+
+<center><img src="../assets/3-1.png" width = 150></center>
+<center>图3-1 XXXXX</center>
+
+!!! tip "提示框 :bulb:"
+    &emsp;&emsp;使用Markdown原生语法添加图片时，使用的是图片相对于当前`.md`文件的路径。  
+    &emsp;&emsp;使用内嵌HTML添加图片时，使用的是`site`文件夹下，图片相对于当前`.md`文件所生成的`.html`文件的路径，故需在图片路径前添加`../`。
+
+    &emsp;&emsp;PS：更多关于提示框使用方法，请参考<a href="https://squidfunk.github.io/mkdocs-material/reference/admonitions/" target="_blank">Material for MkDocs/References/Admonitions</a>。
+
+### 2.2 表格示例
+
+&emsp;&emsp;表格示例：
+
+<center>        <!-- 设置表格居中 -->
+<center>表3-1 XXXXX</center>
+
+| 表头1 | 表头2 | 表头3 |
+| :-: | :- | -: |
+| 本列居中 | 本列左对齐 | 本列右对齐 |
+| ... | ... | ... |
+
+</center>       <!-- 设置表格居中 -->
+
+
+
+## 3. 代码及公式
+
+### 3.1 代码示例
+
+&emsp;&emsp;代码块示例：
+
+``` C
+int main(void)
+{
+    return 0;
+}
+```
+
+&emsp;&emsp;行内代码示例：主函数的返回类型是`int`，参数是`void`。
+
+### 3.2 公式示例
+
+&emsp;&emsp;公式块示例：
+
+$$
+\sum_{i=1}^n a_i=0
+$$
+
+&emsp;&emsp;行内公式示例：$ \sum_{i=1}^n a_i=0 $.
+
+&emsp;&emsp;关于数学公式的编写，请参考<a href="https://blog.csdn.net/wzk4869/article/details/126863936" target="_blank">此博客</a>。
+
+
+---
+<script src="https://gissues.gitee.io/client.js"
+        repo="HITSZ-CSLab/gitssue"
+        issue-term="pathname"
+        theme="github-light"
+        author="hitsz_cslab_admin"
+        crossorigin="anonymous"
+        async>
+</script>
+---

docs/lab2/extra.md

@@ -0,0 +1,14 @@
+# 附加题
+
+## 题目1：XXX（<font color=green>**+1**</font>分）
+
+&emsp;&emsp;XXXXX
+
+
+## 题目2：XXX（<font color=green>**+2**</font>分）
+
+&emsp;&emsp;XXXXX
+
+!!! hint "提示 :bulb:"
+    &emsp;&emsp;XXXXX
+

docs/lab2/overview.md

@@ -0,0 +1,12 @@
+## 实验目的
+
+  1. XXXXX；
+
+  2. XXXXX；
+
+  3. XXXXX。
+
+
+## 实验内容
+
+  XXXXX

docs/lab2/step.md

@@ -0,0 +1,13 @@
+# 实验步骤
+
+## 1. XXX
+
+  XXXXX
+
+## 2. XXX
+
+  XXX
+
+### 2.1 XXX
+
+  XXXXX

docs/lab2/submit.md

@@ -0,0 +1,24 @@
+# 验收与提交
+
+## 实验报告要求
+
+  实验报告需包含以下内容：
+
+  （1）XXX；
+
+  （2）XXX；
+
+  （3）XXX。
+
+## 验收与提交要求
+
+- 必做题：
+
+    检查实验现象（XX%）；
+
+&emsp;&emsp;&emsp;&emsp;将源码及实验报告打包成.zip，以“<font color=orange>**学号_姓名_XXX实验2.zip**</font>”命名并提交（XX%）。
+
+- 附加题：打包提交源码；实验报告的要求见题目。
+
+!!! warning "作业提交 :calendar:"
+    &emsp;&emsp;作业提交<font color = red>**Deadline**</font>：<font color = purple>**下周同一上课时间前**</font>。

docs/lab2/theory.md

@@ -0,0 +1,18 @@
+# 实验原理
+
+  XXXXX
+
+## 1. XXX
+
+  XXXXX
+
+<center><img src="../assets/3-1.png" width = 200></center>
+<center>图3-1 XXXXX</center>
+
+## 2. XXX
+
+&emsp;&emsp;XXX
+
+### 2.1 XXX
+
+&emsp;&emsp;XXXXX

docs/mkdocs_guide/mkdocs_guide.md

@@ -0,0 +1,135 @@
+# MkDocs入门指南
+
+&emsp;&emsp;MkDocs是一个便捷易用的静态网页生成工具，详见<a href="https://www.mkdocs.org/" target="_blank">官网</a>。
+
+
+
+## 1. 环境安装
+
+&emsp;&emsp;此处仅介绍Windows 10系统下如何搭建MkDocs开发环境。其他系统下的环境搭建过程类似，此处不赘述。
+
+### 1.1 Python环境安装
+
+&emsp;&emsp;首先，从<a href="https://www.python.org/downloads/windows/" target="_blank">Python官网</a>下载适用于Windows的最新的Python3环境安装包，如图1-1所示。
+
+<center><img src="../assets/1-1.png"></center>
+<center>图1-1 从Python官网下载最新的Python环境安装包</center>
+
+&emsp;&emsp;双击所下载的`python-3.XX.X-amd64.exe`安装包，勾选`Add Python 3.XX to PATH`，并点击`Install Now`，如图1-2所示。
+
+<center><img src="../assets/1-2.png" width = 600></center>
+<center>图1-2 为Windows 10安装Python环境</center>
+
+### 1.2 依赖包安装
+
+&emsp;&emsp;安装完毕后，在Windows 10搜索栏输入`powershell`，并在其上右键，选择`以管理员权限运行`，如图1-3所示。
+
+<center><img src="../assets/1-3.png" width = 400></center>
+<center>图1-3 以管理员权限打开PowerShell</center>
+
+&emsp;&emsp;在PowerShell中输入`pip install mkdocs`命令并回车，以安装mkdocs。类似地，使用同样的命令依次安装`mkdocs-material`、`mkdocs-material-extensions`、`mkdocs-minify-plugin`、`pymdown-extensions`与`python-markdown-math`。
+
+!!! info "PS :bulb:"
+    &emsp;&emsp;也可以从本仓库的stupkt目录下载<a href="https://gitee.com/hitsz-cslab/gitee-page-demo/blob/master/stupkt/requirements.txt" target="_blank">requirements.txt文件</a>，然后在PowerShell中执行`pip install -r <file-path>/requirements.txt`命令安装依赖包。
+
+&emsp;&emsp;至此，环境搭建完毕。
+
+
+
+## 2. MkDocs开发
+
+### 2.1 创建MkDocs工程
+&emsp;&emsp;如果希望从零开始创建MkDocs工程，则可以在指定的路径下执行`mkdocs new <proj-name>`命令以创建新的MkDocs工程。
+
+&emsp;&emsp;如果对MkDocs不熟悉，也可以在模板工程或现有工程的基础上进行修改和定制。
+
+### 2.2 MkDocs工程配置
+
+&emsp;&emsp;一个MkDocs工程通常包括`docs文件夹`、`site文件夹`、`mkdocs.yml配置文件`和`README.md`四部分。
+
+- `docs文件夹`
+
+&emsp;&emsp;该文件夹存放的是需要开发者编辑的由Markdown语言描述的静态文本。MkDocs工具将对该文件夹下的Markdown文本进行解析和转换，生成对应的HTML文本。
+
+- `site文件夹`
+
+&emsp;&emsp;该文件夹存放的是MkDocs生成的HTML网页。
+
+- `mkdocs.yml`
+
+&emsp;&emsp;该文件是MkDocs工程的配置文件。开发者通过修改该文件中的配置，不仅可以选择静态网页的主题、自定义网页配色，还可以将`docs文件夹`下的Markdown文本组织成指定的层次结构。
+
+&emsp;&emsp;配置文件内各项配置的含义请参考<a href="https://gitee.com/hitsz-cslab/gitee-page-demo/blob/master/mkdocs.yml" target="_blank">本模板工程的配置文件</a>中的注释。
+
+- `README.md`
+
+&emsp;&emsp;该文档用于说明MkDocs工程的用途、使用声明等信息。该文件的内容将显示在GitHub或Gitee仓库的首页。
+
+!!! info "PS :bulb:"
+    &emsp;&emsp;`stupkt文件夹`可用于存放PDF、压缩包等材料。
+
+### 2.3 Markdown编写
+
+&emsp;&emsp;关于Markdown语法，请查阅<a href="https://markdown.com.cn/" target="_blank">官方文档</a>。
+
+### 2.4 静态网页预览及调试
+
+&emsp;&emsp;开发过程中，若想预览静态网页，可以在MkDocs工程的根目录上打开PowerShell，并执行`mkdocs serve`命令。然后打开浏览器，访问`http://localhost:8000/`即可预览静态网页。
+
+!!! info "PS :bulb:"
+    &emsp;&emsp;预览效果通常和最终部署的效果一致。另外，在调试过程中，可能出现因为网页缓存导致的预览效果与实际Markdown代码不一致的情况。此时，可打开网页的开发者工具，禁用缓存，然后刷新网页。
+
+&emsp;&emsp;需要注意的是，预览时MkDocs工具生成的静态网页是临时的。因此，当文档撰写完毕，在正式部署前，必须在MkDocs工程的根目录上执行`mkdocs build`命令以生成HTML文本。此时，`docs文件夹`下的Markdown文件才与`site目录`下的HTML文件一一对应。
+
+
+## 3. GiteePage部署
+
+### 3.1 GitHub Desktop安装
+
+&emsp;&emsp;如果熟悉Git工具，可通过相应的命令将本地的MkDocs工程提交到GitHub或Gitee平台，并进行后续的部署工作。否则，也可以先从GitHub官网上下载并安装<a href="https://desktop.github.com/" target="_blank">GitHub Desktop工具</a>。
+
+### 3.2 创建并同步Gitee仓库
+
+&emsp;&emsp;登录Gitee，加入<a href="https://gitee.com/hitsz-cslab" target="_blank">Gitee组织</a>后，于组织内新建Gitee空白仓库。
+
+!!! info "PS :bulb:"
+    &emsp;&emsp;视情况可创建开源仓库或私有仓库。若创建私有仓库，则无权限用户不可访问仓库本身，但仍可访问GiteePage静态网页。
+
+&emsp;&emsp;然后，在GitHub Desktop工具中，点击`File`->`Clone repository`，并在`URL`处填入上述建立的Gitee仓库链接以及本地文件夹路径，如图1-4所示。
+
+<center><img src="../assets/1-4.png" width = 500></center>
+<center>图1-4 通过GitHub Desktop工具将Gitee仓库克隆到本地文件夹</center>
+
+!!! info "PS :bulb:"
+    &emsp;&emsp;克隆时，需要输入Gitee仓库创建者或仓库成员的账号密码。
+
+&emsp;&emsp;打开所克隆仓库的本地文件夹，使用快捷键`Ctrl`+`A`选中所有文件并删除，并将MkDocs工程根目录下的所有文件拷贝进来。
+
+&emsp;&emsp;接下来，回到GitHub Desktop工具。此时，该工具将自动显示当前仓库的变更内容。
+
+&emsp;&emsp;在`Summary (required)`编辑框中输入本次更新内容的概要，点击`Commit to master`按钮，如图1-5所示。
+
+<center><img src="../assets/1-5.png"></center>
+<center>图1-5 提交仓库更新内容至master分支</center>
+
+&emsp;&emsp;点击`Push origin`按钮，将更新上传到Gitee仓库，如图1-6所示。
+
+<center><img src="../assets/1-6.png"></center>
+<center>图1-6 上传仓库更新内容至Gitee</center>
+
+### 3.3 开启GiteePage服务
+
+&emsp;&emsp;上传完成后，在Gitee仓库页面即可看到已上传的MkDocs工程。此时，点击`服务`->`Gitee Pages`，如图1-7所示。
+
+<center><img src="../assets/1-7.png"></center>
+<center>图1-7 进入GiteePage服务</center>
+
+&emsp;&emsp;进入GiteePage服务页面后，在部署目录处输入`site`，并勾选`强制使用HTTPS`，再点击启动按钮，如图1-8所示。
+
+<center><img src="../assets/1-8.png" width = 550></center>
+<center>图1-8 启动GiteePage服务</center>
+
+&emsp;&emsp;启动成功后，可点击所显示的链接打开静态网页，如图1-9所示。
+
+<center><img src="../assets/1-9.png" width = 600></center>
+<center>图1-9 访问GiteePage静态网页</center>

mkdocs.yml

@@ -0,0 +1,85 @@
+# 所有网页的统一标题
+# 标题建议统一格式，如：XXXXXX实验（2023春季） | 哈工大（深圳）
+site_name: GiteePage入门指南（202X秋/春/夏季） | 哈工大（深圳）
+# 版权信息————记得更新年份
+copyright: 'Copyright © 2019 - 2023 哈尔滨工业大学（深圳）'
+# 仓库名称(非必须)————可自定义
+repo_name: 'GiteePageDemoRepo'
+# 仓库URL(非必须)
+repo_url: 'https://gitee.com/hitsz-cslab/gitee-page-demo'
+
+# 所使用的Markdown扩展————一般不需要改动
+markdown_extensions:
+  - pymdownx.betterem:
+      smart_enable: all
+  - pymdownx.caret
+  - pymdownx.critic
+  - pymdownx.details
+  # 支持emoji表情
+  - pymdownx.emoji:
+      emoji_index: !!python/name:pymdownx.emoji.twemoji
+      emoji_generator: !!python/name:pymdownx.emoji.to_svg
+  - pymdownx.inlinehilite
+  - pymdownx.magiclink
+  - pymdownx.mark
+  - pymdownx.smartsymbols
+  - pymdownx.superfences
+  - pymdownx.tasklist:
+      custom_checkbox: true
+  - pymdownx.tabbed
+  - pymdownx.tilde
+  - admonition
+  - mdx_math:
+      enable_dollar_delimiter: True
+
+extra_javascript:
+  - https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.0/MathJax.js?config=TeX-MML-AM_CHTML
+  # - mathjaxhelper.js
+
+# GiteePage主题————使用统一模板：material
+theme:
+  language: 'zh'
+  name: material
+  custom_dir: overrides
+  features:
+    - navigation.tabs
+  icon:
+    # 网页标题左侧的图标————可更换成其他fontawesome图标，详见https://fontawesome.com/
+    logo: fontawesome/solid/microchip
+    repo: fontawesome/brands/git-alt
+    # favicon: fontawesome/solid/microchip
+  palette:
+    - scheme: 'default'     # 白天模式
+      primary: 'blue'       # 网页底色
+      accent: 'red'         # 交互元素颜色
+      toggle:
+        icon: material/weather-sunny
+        name: 切换到夜晚模式
+    - scheme: 'slate'       # 夜晚模式
+      primary: 'blue'       # 网页底色
+      accent: 'red'         # 交互元素颜色
+      toggle:
+        icon: material/weather-night
+        name: 切换到白天模式
+
+# 导航设置
+# （1）最多三级缩进，每一级缩进对应一个级别层次
+# （2）可使用中文或其他语言的字符，但文字与markdown文件之间的冒号必须是英文冒号
+nav:
+  - 首页:
+    - 实验须知: index.md
+    - 作业提交说明: homewk.md
+  - 实验1：XXX:
+    - 实验概述: lab1/overview.md
+    - 实验原理: lab1/theory.md
+    - 实验步骤: lab1/step.md
+    - 附加题: lab1/extra.md
+    - 验收与提交: lab1/submit.md
+  - 实验2：XXX:
+    - 实验概述: lab2/overview.md
+    - 实验原理: lab2/theory.md
+    - 实验步骤: lab2/step.md
+    - 附加题: lab2/extra.md
+    - 验收与提交: lab2/submit.md
+  - MkDocs使用说明: mkdocs_guide/mkdocs_guide.md
+ 

overrides/partials/comments.html

@@ -0,0 +1,41 @@
+<!--
+  Copyright (c) 2016-2023 Martin Donath <martin.donath@squidfunk.com>
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to
+  deal in the Software without restriction, including without limitation the
+  rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+  sell copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in
+  all copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+  FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+  IN THE SOFTWARE.
+-->
+
+<!-- Comment system -->
+
+{% if page.meta.comments %}
+  <h2 id="__comments">{{ lang.t("meta.comments") }}</h2>
+  <!-- Insert generated snippet here -->
+  <script src="https://gissues.gitee.io/client.js"
+        repo="HITSZ-CSLab/gitssue"
+        issue-term="pathname"
+        theme="github-light"
+        author="hitsz-cslab_admin"
+        crossorigin="anonymous"
+        async>
+  </script>
+
+  <!-- Synchronize Giscus theme with palette -->
+
+  
+{% endif %}
+

stupkt/requirements.txt

@@ -0,0 +1,6 @@
+mkdocs
+mkdocs-material
+mkdocs-material-extensions
+mkdocs-minify-plugin
+pymdown-extensions
+python-markdown-math