fix(docs):調整文件建置的國際化語系格式以確保相容性

.github/workflows/build_docs.yml

@@ -70,6 +70,7 @@ jobs:
         run: cd docs_dev/.cache/plugin/social/fonts/Noto\ Sans\ TC; wget https://volunteer.coscup.org/doc/NotoSansTC-Bold.ttf -O Bold.ttf;
       - name: Load Iansui094 font
         run: cd docs_dev/.cache/plugin/social/fonts/Noto\ Sans\ TC; wget https://volunteer.coscup.org/doc/Iansui094-Regular.ttf -O Regular.ttf;
+
       - name: Build Docs
         env:
           PYTHONPATH: "../"

.gitignore

@@ -3,8 +3,9 @@
 __pycache__
 client_secret.json
 docs_dev/site/
+docs_dev/site_*/
 docs_dev/.cache
 log
 log_docker_celery
 setting.py
-venv
+venv

docs_dev/docs/index.zh-TW.md → docs_dev/docs/index.zh_TW.md

@@ -5,7 +5,7 @@
 
 ## 關於
 
-COSCUP Volunteer 志工平台是由[行政組](secretary_team/overview.zh-TW.md)維護營運。這個平台是希望能讓內部志工可以在每年申請加入 到所感興趣的組別、相關文件與福利的申請、 整合溝通平台 Mattermost 與 Telegram 帳號以及開始累計志工履歷與服務歷程。
+COSCUP Volunteer 志工平台是由[行政組](secretary_team/overview.zh_TW.md)維護營運。這個平台是希望能讓內部志工可以在每年申請加入 到所感興趣的組別、相關文件與福利的申請、 整合溝通平台 Mattermost 與 Telegram 帳號以及開始累計志工履歷與服務歷程。
 
 如果你有疑問或是想法，我們鼓勵你到我們在 Github 上的[專案討論區](https://github.com/COSCUP/COSCUP-Volunteer/discussions)來提出！
 

docs_dev/docs/secretary_team/instructions/overview.zh-TW.md → docs_dev/docs/secretary_team/instructions/overview.zh_TW.md

@@ -8,6 +8,6 @@ description: 在籌備期間如何運作與使用行政組
 
 行政組團隊在籌備期間內的工作手冊說明，依小組、項目或是工作流程來進行相關的說明與引導。
 
-- [組任務範圍](scope_of_team.zh-TW.md)
-- [任務流程方式](process_management.zh-TW.md)
-- [文件撰寫與紀錄](writing_documentation.zh-TW.md)
+- [組任務範圍](scope_of_team.zh_TW.md)
+- [任務流程方式](process_management.zh_TW.md)
+- [文件撰寫與紀錄](writing_documentation.zh_TW.md)

docs_dev/docs/secretary_team/overview.zh-TW.md → docs_dev/docs/secretary_team/overview.zh_TW.md

@@ -4,8 +4,8 @@
 
 ## 相關目錄
 
-- [招募訊息](recruit.zh-TW.md)
-- [行政組使用手冊](instructions/overview.zh-TW.md)
+- [招募訊息](recruit.zh_TW.md)
+- [行政組使用手冊](instructions/overview.zh_TW.md)
 
 ## 與籌備相關工具
 

docs_dev/docs/secretary_team/tasks/enhance_recruitment.zh-TW.md → docs_dev/docs/secretary_team/tasks/enhance_recruitment.zh_TW.md

@@ -31,5 +31,5 @@
 
 希望延伸「**療癒**」的主題嘗試舉辦比較偏屬**社會人文類型**並與 Open Source 相關的講座於「療癒市集」的活動空堂中。
 
-[^1]: 可以參考[行政組簡介](../recruit.zh-TW.md)
+[^1]: 可以參考[行政組簡介](../recruit.zh_TW.md)
 [^2]: 宣導講座可能會是錄影的方式提供給組員在限定期間內完成觀看。錄影內容可能會是先與組長群或是某一次全體線上會議錄製。

docs_dev/mkdocs.yml

@@ -183,20 +183,20 @@ extra:
 extra_css:
   - stylesheets/extra.css
 plugins:
+  - autorefs:
+      resolve_closest: true
   - i18n:
       docs_structure: suffix
       fallback_to_default: true
-      reconfigure_material: true
       reconfigure_search: true
       languages:
-        - build: true
-          default: true
-          locale: en
+        - locale: en
           name: English (en-US)
-        - build: true
-          default: false
-          locale: zh-TW
+          default: true
+          build: true
+        - locale: zh_TW
           name: 臺灣正體 (zh-TW)
+          build: true
           nav_translations:
             About COSCUP: 關於 COSCUP
             About Secretary Team: 關於行政組

pyproject.toml

@@ -41,11 +41,10 @@ cairosvg = "^2.7"
 certifi = "*"
 click = "^8.1.3"
 lxml = "^4.9.1"
-mkdocs-git-revision-date-localized-plugin = "1.2.6"
-mkdocs-material = "9.5.30"
-mkdocs-static-i18n = {extras = ["material"], version = "1.2.3"}
-mkdocstrings = {extras = ["python"], version = "0.25.2"}
-mkdocs_autorefs = "1.0.1"
+mkdocs-git-revision-date-localized-plugin = "^1.2"
+mkdocs-material = "^9.1"
+mkdocs-static-i18n = {extras = ["material"], version = "^1.2"}
+mkdocstrings = {extras = ["python"], version = "^0.25"}
 mongomock = "^4.2"
 mypy = "^1"
 pillow = "^10.0"