refactor: 更新依赖版本与覆盖样式写法，及更多规范化设置 (#260)

 - 更新依赖到最新版
 - 重写覆盖主题，使之不依赖于固定 material 版本
 - 修改自定义 giscus 暗色主题至 transparent_dark
 - 增加 instant 加载与进度条
 - 明确指定不在 nav 中的 markdown 文件（某历年卷源码）
 - 修改所有 HTML 目标的链接
 - 更新 workflow，去掉 gh-pages 分支并添加手动触发
 - 更新贡献指南与模板页面
 - TuringPlugins 全部功能移至 hooks，弃用 TuringPlugins

Author: TonyCrane

.github/workflows/deploy.yml

@@ -1,25 +1,50 @@
-name: deploy
+name: Build and Deploy to GitHub Pages
+
 on:
   push:
     branches:
       - master 
+  workflow_dispatch:
+
 permissions:
-  contents: write
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: 'deploy'
+  cancel-in-progress: true
+
 jobs:
-  deploy:
+  build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - name: Checkout
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
-      - uses: actions/setup-python@v4
+      - name: Setup GitHub Pages
+        uses: actions/configure-pages@v5
+      - name: Setup Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.x'
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+      - name: Build site
+        run: FULL=1 mkdocs build
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
         with:
-          python-version: 3.x
-      - run: pip install -r requirements.txt
-      - name: Install TuringPlugins
-        run: |
-          git clone https://github.com/ZJU-Turing/TuringPlugins.git
-          cd TuringPlugins
-          pip install -e .
-          cd ..
-      - run: mkdocs gh-deploy --force
+          path: ./site
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -1,2 +1,3 @@
 .DS_Store
 site
+__pycache__

docs/changelog.md

@@ -12,6 +12,7 @@ nocounter: true
     - 对应的 commit sha 值点击可以跳转到 GitHub 上对应的 commit 页面
     - commit message 中带有课程名的部分点击可以跳转到网站上对应页面
         - 该 commit 中有修改，但没有体现在 message 中的会将跳转链接列在二级列表中
+        - 2025.7.20 之前的 commit 会跳转到[存档站](https://zju-turing.github.io/TuringCoursesGrave/)中对应页面
     - 从 pull request 而来的 commit 可以通过末尾的 `#pr` 跳转到对应的 pull request 页面
 
 <style>

docs/contributing.md

@@ -11,18 +11,11 @@
     $ git clone https://github.com/ZJU-Turing/TuringCourses.git
     $ cd TuringCourses
     ```
-2. 安装 python 依赖（mkdocs 以及 material）
+2. 安装 python 依赖
     ```shell
     $ pip install -r requirements.txt
     ```
-3. 安装本文档专用插件
-    ```shell
-    $ git clone https://github.com/ZJU-Turing/TuringPlugins.git
-    $ cd TuringPlugins
-    $ pip install -e .
-    $ cd ..
-    ```
-4. 启动 mkdocs 本地服务
+3. 启动 mkdocs 本地服务
     ```shell
     $ mkdocs serve
     ```
@@ -44,14 +37,13 @@
 │   ├── general/            # 通识选修课
 │   ├── images/             # 仅用来保存网站图标
 │   ├── js/                 # 本站用到的所有 js 脚本
-│   ├── major_basic/        # 专业基础课
-│   ├── major_elective/     # 专业选修课
-│   ├── major_mandatory/    # 专业必修课
+│   ├── major/              # 所有专业课程
 │   ├── math_phys/          # 数理基础课
 │   ├── others/             # 其他课程
 │   ├── political/          # 思政军体课
-│   ├── readings/           # 书评专区
+│   ├── readings/           # 书评专区（待建设）
 │   └── short_term/         # 短学期课程
+├── hooks/              # 本文档专用扩展功能（默认仅开启 evaluations）
 ├── mkdocs.yml          # mkdocs 站点设置
 ├── overrides/          # mkdocs-material 个性主题设置
 └── requirements.txt    # 本站构建所需全部 python 依赖
@@ -69,12 +61,12 @@
 - 尽量不要上传有版权的文件，例如课件等
 - 对于自己的笔记、复习提纲等材料：
     - 如果有自己的网站，推荐放在自己的网站并在此插入链接
-    - 也可以将文件上传到对应课程文件夹中，并插入相对链接，例如[数分一](math_phys/math_analysis1/)页面中的历年卷
+    - 也可以将文件上传到对应课程文件夹中，并插入相对链接，例如[数分一](math_phys/math_analysis1/index.md)页面中的历年卷
 - 尽量规范编写 markdown，避免出现格式错误
     - 如果你实在搞不定，不要担心，尽管上传，我们发现后会及时进行修改
 
 !!! note
-    针对还完全没有内容的空页面，我们提供了一个[模板](../template/)，可以在模板的[源码](https://github.com/ZJU-Turing/TuringCourses/blob/master/docs/template.md?plain=1)基础上修改使用。
+    针对还完全没有内容的空页面，我们提供了一个[模板](template.md)，可以在模板的[源码](https://github.com/ZJU-Turing/TuringCourses/blob/master/docs/template.md?plain=1)基础上修改使用。
 
 ### 贡献方式
 #### Pull Request（推荐）

docs/css/custom.css

@@ -68,7 +68,7 @@ html .md-footer-meta.md-typeset a:is(:focus,:hover) {
   --md-code-bg-color: #fafafa;
 }
 
-[data-md-color-scheme="slate"] {
+[data-md-color-scheme="slate"][data-md-color-primary="indigo"] {
   --md-default-bg-color: #161616;
   --md-default-bg-color--light: #161616;
   --md-default-bg-color--lighter: #161616;

docs/general/index.md

@@ -12,6 +12,6 @@
 
 “上课学得好，不如选课选得好”，有些课程讲得好、有些课程讲得差；有些课程给分好、有些课程给分普遍偏低。所以说通识类课程的分数不一定和对课程内容掌握程度以及认真程度正相关。由于此类课程数量较多，所以采用分类、分课，评分、评价的方式来展示。分为三个子页面，供参考。
 
-- [通识核心课](core/)
-- [通识选修课](elective/)
-- [其他选修课](others/)
+- [通识核心课](core.md)
+- [通识选修课](elective.md)
+- [其他选修课](others.md)

docs/js/scheme.js

@@ -90,7 +90,7 @@ window.toggleScheme = () => {
   body.setAttribute("data-md-color-scheme", scheme)
 
   var frame = document.querySelector(".giscus-frame")
-  var theme = scheme === "slate" ? "https://gcore.jsdelivr.net/gh/TonyCrane/note/docs/css/giscus.css" : "light"
+  var theme = scheme === "slate" ? "transparent_dark" : "light"
   frame.contentWindow.postMessage(
     { giscus: { setConfig: { theme } } },
     "https://giscus.app"

docs/major/advanced_data_structure/index.md

@@ -1,4 +1,6 @@
 ---
+abbrs:
+    - ads
 grave: https://zju-turing.github.io/TuringCoursesGrave/major_basic/advanced_data_structure/
 ---
 

docs/major/compilers_principles/index.md

@@ -1,4 +1,6 @@
 ---
+abbrs:
+    - compiler
 grave: https://zju-turing.github.io/TuringCoursesGrave/major_mandatory/compilers_principles/
 ---
 

docs/major/computer_system1/index.md

@@ -1,4 +1,7 @@
 ---
+abbrs:
+    - 计算机系统 I
+    - 计算机系统Ⅰ
 grave: https://zju-turing.github.io/TuringCoursesGrave/major_basic/computer_system1/
 ---