Merge branch 'master' into Addition_Docs

Reviewed-on: #22

.gitea/workflows/sphinx_deploy.yml

@@ -37,7 +37,7 @@ jobs:
             
             if [ $REQ_MOD_TIME -gt $VENV_MOD_TIME ]; then
               echo "Master branch requirements updated, installing new dependencies..."
-              pip install -r requirements.txt
+              pip install -r requirements.txt --no-cache-dir
               echo $REQ_MOD_TIME > .venv-shared/last_update.txt
             fi
           fi

.gitea/workflows/sphinx_test.yml

@@ -23,7 +23,7 @@ jobs:
             cd /home/ly0kos/work/test_env
             
             # 创建共享虚拟环境
-            python -m venv .venv-shared
+            python3 -m venv .venv-shared
             source .venv-shared/bin/activate
             pip install --upgrade pip
             pip install sphinx sphinx-rtd-theme
@@ -89,7 +89,7 @@ jobs:
             fi
           fi
           
-          echo "Python: $(python --version)"
+          echo "python3: $(python3 --version)"
           echo "Sphinx: $(sphinx-build --version 2>/dev/null || echo 'Not installed')"
 
       # 第四步：在工作树中构建文档

source/_static/custom.js

@@ -0,0 +1,17 @@
+document.addEventListener('DOMContentLoaded', function() {
+    // 禁用右键菜单
+    document.addEventListener('contextmenu', function(e) {
+        e.preventDefault();
+    });
+    
+    // 禁用文本选择
+    document.styleSheets[0].addRule('body', '-webkit-user-select: none!important;');
+    document.styleSheets[0].addRule('body', '-moz-user-select: none!important;');
+    document.styleSheets[0].addRule('body', '-ms-user-select: none!important;');
+    document.styleSheets[0].addRule('body', 'user-select: none!important;');
+    
+    // 禁用拖拽
+    document.addEventListener('dragstart', function(e) {
+        e.preventDefault();
+    });
+});

source/conf.py

@@ -59,6 +59,10 @@ html_theme_options = {
 
 
 # ================= 高级功能 =================
+html_js_files = [
+    'custom.js'
+]
+
 # ================== Mermaid 配置 ==================
 def find_system_chrome():
     """自动检测系统 Chrome/Chromium 可执行路径"""
@@ -117,7 +121,6 @@ try:
 except Exception as e:
     print(f"⚠️ Mermaid 初始化失败: {e}")
     print("⚠️ 图表将显示为代码块，请安装 Chrome 和 mermaid-cli")
-    extensions.discard('sphinxcontrib.mermaid')
 
 # ================= CHM特化配置 =================
 if is_chm_build:

source/index.md

@@ -0,0 +1,32 @@
+---
+title: ManLin 硬件产品知识库
+---
+
+# ManLin 硬件产品知识库
+
+```{toctree}
+:maxdepth: 1
+:caption: 目录
+
+Mars_1KS/index
+Calibration/index
+Lab_Report/index
+```
+
+## 附加文档
+
+1. [AD5522](_static/data/add_docs/AD5522.pdf)
+
+2. :::{dropdown} Power DataSheets
+
+   - [LTM4655](_static/data/add_docs/Pwr_DataSheet/ltm4655.pdf)
+   - [MIC29502](_static/data/add_docs/Pwr_DataSheet/MIC29502.pdf)
+   - [LMR51450](_static/data/add_docs/Pwr_DataSheet/LMR51450.pdf)
+   - [TPS54627](_static/data/add_docs/Pwr_DataSheet/tps54627.pdf)
+   - [TPS54821](_static/data/add_docs/Pwr_DataSheet/tps54821.pdf)
+   - [TPS563209](_static/data/add_docs/Pwr_DataSheet/tps563209.pdf)
+   - [LT3091](_static/data/add_docs/Pwr_DataSheet/lt3091.pdf)
+  
+   :::
+
+3. 

source/index.rst

@@ -1,26 +0,0 @@
-.. ManLin_KnowledgeBase documentation master file, created by
-   sphinx-quickstart on Tue Aug 12 05:35:46 2025.
-   You can adapt this file completely to your liking, but it should at least
-   contain the root `toctree` directive.
-
-.. ManLin 硬件知识库主索引文件
-
-.. 注意：此文件使用 reStructuredText 语法，但支持包含 Markdown 文件
-
-##############################
-ManLin 硬件产品知识库
-##############################
-
-.. toctree::
-   :maxdepth: 1
-   :caption: Contents:
-
-   Mars_1KS/index
-   Calibration/index
-   Lab_Report/index
-
-
-
-*Additional Docs:*
-
-1. `AD5522 <_static/data/add_docs/AD5522.pdf>`_