From ee10f4a81eea4b4468383b33f3d2c926dbcc68bd Mon Sep 17 00:00:00 2001 From: Mengyang Gao Date: Thu, 30 Apr 2026 22:25:41 +0800 Subject: [PATCH 1/2] Fix MkDocs edit links --- .gitignore | 3 ++- hooks.py | 26 ++++++++++++++++++++++++++ mkdocs.yml | 6 +++++- 3 files changed, 33 insertions(+), 2 deletions(-) create mode 100644 hooks.py diff --git a/.gitignore b/.gitignore index 96c0ecc..58f5895 100644 --- a/.gitignore +++ b/.gitignore @@ -1 +1,2 @@ -docs/ \ No newline at end of file +docs/ +__pycache__/ diff --git a/hooks.py b/hooks.py new file mode 100644 index 0000000..6fa1860 --- /dev/null +++ b/hooks.py @@ -0,0 +1,26 @@ +from pathlib import PurePosixPath + + +def on_files(files, config): + for file in files: + src_uri = file.src_uri + + # docs/index.md 在 MkDocs 内部通常表现为 index.md + # 目标:/edit/main/README.md + if src_uri == "index.md": + file.edit_uri = "README.md" + continue + + path = PurePosixPath(src_uri) + + # 生成页: + # 01-基础必修课/C++编程基础.md + # + # 原始源文件: + # 01-基础必修课/C++编程基础/README.md + if path.suffix == ".md" and len(path.parts) >= 2: + course_group = path.parts[0] + course_name = path.stem + file.edit_uri = f"{course_group}/{course_name}/README.md" + + return files diff --git a/mkdocs.yml b/mkdocs.yml index adde017..c7ca8d1 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -1,3 +1,7 @@ site_name: 华南理工未来技术学院课程攻略 theme: readthedocs -repo_url: https://github.com/OpenFuTech/SCUT-FT-Guide \ No newline at end of file +repo_url: https://github.com/OpenFuTech/SCUT-FT-Guide +edit_uri: edit/main/ + +hooks: + - hooks.py From 6ec0898f863e5be3519b3cfc8f47845ec656053f Mon Sep 17 00:00:00 2001 From: Snowflake-Pink Date: Sun, 3 May 2026 12:24:26 +0800 Subject: [PATCH 2/2] Add README for digital system design lab --- .../README.md" | 14 ++++++++++++++ 1 file changed, 14 insertions(+) create mode 100644 "02-\344\270\223\344\270\232\345\237\272\347\241\200\350\257\276/\346\225\260\345\255\227\347\263\273\347\273\237\350\256\276\350\256\241\345\256\236\351\252\214/README.md" diff --git "a/02-\344\270\223\344\270\232\345\237\272\347\241\200\350\257\276/\346\225\260\345\255\227\347\263\273\347\273\237\350\256\276\350\256\241\345\256\236\351\252\214/README.md" "b/02-\344\270\223\344\270\232\345\237\272\347\241\200\350\257\276/\346\225\260\345\255\227\347\263\273\347\273\237\350\256\276\350\256\241\345\256\236\351\252\214/README.md" new file mode 100644 index 0000000..f9d4ad8 --- /dev/null +++ "b/02-\344\270\223\344\270\232\345\237\272\347\241\200\350\257\276/\346\225\260\345\255\227\347\263\273\347\273\237\350\256\276\350\256\241\345\256\236\351\252\214/README.md" @@ -0,0 +1,14 @@ +## 一、课程内容 +待补充 + +## 二、考核方式 +待补充 + +## 三、修读攻略 +202X级XXX: + +- 待补充 +- 待补充 + +## 四、注意事项 +待补充