docs: fix formula rendering issue and optimize ci ignore rule (#18184)

* docs: fix formula rendering issue

* ci: add paths-ignore

* ci: optimize ignore rule

* ci: optimize ignore rule

* ci: fix paddlex version error

* chore: add new line

.github/workflows/codestyle.yml

@@ -2,8 +2,16 @@ name: PaddleOCR Code Style Check
 
 on:
   pull_request:
+    paths-ignore:
+      - docs/**
+      - '**/*.md'
+      - .github/**
   push:
     branches: ['main', 'release/*']
+    paths-ignore:
+      - docs/**
+      - '**/*.md'
+      - .github/**
 
 jobs:
   check-code-style:

.github/workflows/test_gpu.yml

@@ -3,8 +3,16 @@ name: PaddleOCR PR Tests GPU
 on:
   push:
     branches: ["main"]
+    paths-ignore:
+      - docs/**
+      - '**/*.md'
+      - .github/**
   pull_request:
     branches: ["main"]
+    paths-ignore:
+      - docs/**
+      - '**/*.md'
+      - .github/**
   workflow_dispatch:
 env:
   PR_ID: ${{ github.event.pull_request.number }}
@@ -49,7 +57,7 @@ jobs:
               skip_gpu=false
               break
             fi
-            if [[ "$file" == paddleocr-js/* ]] || [[ "$file" == langchain-paddleocr/* ]] || [[ "$file" == skills/* ]] || [[ "$file" == mcp_server/* ]] || [[ "$file" == deploy/* ]] || [[ "$file" == *.md ]] || [[ "$file" == *.txt ]] || [[ "$file" == *.yml ]] || [[ "$file" == *.yaml ]]; then
+            if [[ "$file" == docs/* ]] || [[ "$file" == paddleocr-js/* ]] || [[ "$file" == langchain-paddleocr/* ]] || [[ "$file" == skills/* ]] || [[ "$file" == mcp_server/* ]] || [[ "$file" == deploy/* ]] || [[ "$file" == *.md ]] || [[ "$file" == *.txt ]] || [[ "$file" == *.yml ]] || [[ "$file" == *.yaml ]]; then
               continue
             fi
             skip_gpu=false

.github/workflows/tests.yml

@@ -80,6 +80,8 @@ jobs:
           echo "Failed to determine PaddleX version requirement from pyproject.toml" >&2
           exit 1
         fi
+
+        python -m pip install "paddlex>=3.7.0,<3.8.0"
         PADDLEX_BRANCH="release/${PADDLEX_SERIES}"
         echo "Installing PaddleX from branch: ${PADDLEX_BRANCH}"
         python -m pip install -e ".${PADDLEOCR_EXTRAS}" "paddlex@git+https://github.com/PaddlePaddle/PaddleX.git@${PADDLEX_BRANCH}"

docs/javascripts/katex.js

@@ -0,0 +1,10 @@
+document$.subscribe(({ body }) => {
+  renderMathInElement(body, {
+    delimiters: [
+      { left: "$$",  right: "$$",  display: true },
+      { left: "$",   right: "$",   display: false },
+      { left: "\\(", right: "\\)", display: false },
+      { left: "\\[", right: "\\]", display: true }
+    ],
+  })
+})

docs/version3.x/algorithm/PP-OCRv6/PP-OCRv6.md

@@ -14,8 +14,6 @@ PP-OCRv6 的主要贡献如下：
 
 <p align="center">图：PP-OCRv6 与 PP-OCRv5 及视觉语言模型的性能对比。左：文本检测平均 Hmean（%）；右：文本识别加权平均准确率（%）。</p>
 
-
-
 # 二、核心技术升级
 
 ## 1. 统一骨干网络 PPLCNetV4
@@ -253,8 +251,8 @@ paddleocr ocr -i general_ocr_002.png \
 
 # 七、部署与二次开发
 
-* **多系统支持**：兼容 Windows、Linux、Mac 等主流操作系统。
-* **多硬件支持**：支持英伟达 GPU、Intel CPU、昆仑芯、昇腾等硬件推理和部署。
-* **高性能推理插件**：推荐结合高性能推理插件进一步提升推理速度，详见[高性能推理指南](../../inference_deployment/local_inference/high_performance_inference.md)。
-* **服务化部署**：支持高稳定性服务化部署方案，详见[服务化部署指南](../../inference_deployment/serving/serving.md)。
-* **二次开发能力**：支持自定义数据集训练、字典扩展、模型微调，详见[文本检测模块使用教程](../../module_usage/text_detection.md)及[文本识别模块使用教程](../../module_usage/text_recognition.md)。
+- **多系统支持**：兼容 Windows、Linux、Mac 等主流操作系统。
+- **多硬件支持**：支持英伟达 GPU、Intel CPU、昆仑芯、昇腾等硬件推理和部署。
+- **高性能推理插件**：推荐结合高性能推理插件进一步提升推理速度，详见[高性能推理指南](../../inference_deployment/local_inference/high_performance_inference.md)。
+- **服务化部署**：支持高稳定性服务化部署方案，详见[服务化部署指南](../../inference_deployment/serving/serving.md)。
+- **二次开发能力**：支持自定义数据集训练、字典扩展、模型微调，详见[文本检测模块使用教程](../../module_usage/text_detection.md)及[文本识别模块使用教程](../../module_usage/text_recognition.md)。

mkdocs.yml

@@ -307,7 +307,7 @@ extra:
   expiry_days: 365
 
 extra_javascript:
-  - javascripts/katex.min.js
+  - javascripts/katex.js
   - https://unpkg.com/katex@0/dist/katex.min.js
   - https://unpkg.com/katex@0/dist/contrib/auto-render.min.js