update onnxruntime docs, sync CANN quick start from upstream at build…

.gitignore

@@ -8,3 +8,4 @@ sources/_generated/
 .tasks/
 venv/
 _repos/
+_static/ascend_config.json

Makefile

@@ -24,18 +24,40 @@ ASCEND_CONFIG := _static/ascend_config.json
 # Fetch script
 FETCH_SCRIPT := scripts/fetch_ascend_data.py
 
+# Official ONNX Runtime CANN EP quick start source
+ONNXRUNTIME_CANN_MD_URL := https://raw.githubusercontent.com/microsoft/onnxruntime/gh-pages/docs/execution-providers/community-maintained/CANN-ExecutionProvider.md
+ONNXRUNTIME_CANN_MD_LOCAL := sources/_generated/sources/onnxruntime/quick_start.md
+
 # Put it first so that "make" without argument is like "make help".
 help:
 	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 
-.PHONY: help Makefile copy-docs clean-submodules fetch-config
+.PHONY: help Makefile copy-docs clean-submodules fetch-config sync-onnxruntime-doc
 
 # Fetch ascend config (always run to ensure freshness)
 .PHONY: $(ASCEND_CONFIG)
 fetch-config:
 	@echo "Fetching ascend configuration data..."
 	@python3 $(FETCH_SCRIPT)
 
+# Sync latest ONNX Runtime CANN EP doc from official gh-pages branch
+sync-onnxruntime-doc:
+	@echo "Syncing ONNX Runtime CANN quick start from upstream..."
+	@mkdir -p $(dir $(ONNXRUNTIME_CANN_MD_LOCAL))
+	@curl -fsSL "$(ONNXRUNTIME_CANN_MD_URL)" -o "$(ONNXRUNTIME_CANN_MD_LOCAL).tmp"
+	@awk 'BEGIN{in_fm=0} \
+		{sub(/\r$$/, "", $$0)} \
+		NR==1 && $$0=="---" {in_fm=1; next} \
+		in_fm && $$0=="---" {in_fm=0; next} \
+		in_fm {next} \
+		$$0 ~ /^##[[:space:]]+Contents[[:space:]]*$$/ {next} \
+		$$0 ~ /^\{:[[:space:]]*\.no_toc[[:space:]]*\}$$/ {next} \
+		$$0 ~ /^\{:[[:space:]]*toc[[:space:]]*\}$$/ {next} \
+		$$0 ~ /^\*[[:space:]]*TOC[[:space:]]+placeholder[[:space:]]*$$/ {next} \
+		{print}' "$(ONNXRUNTIME_CANN_MD_LOCAL).tmp" > "$(ONNXRUNTIME_CANN_MD_LOCAL)"
+	@rm -f "$(ONNXRUNTIME_CANN_MD_LOCAL).tmp"
+	@echo "Synced to $(ONNXRUNTIME_CANN_MD_LOCAL)"
+
 # Initialize submodules if not exists (use pinned commits for reproducibility)
 _repos/verl _repos/VeOmni _repos/LLaMA-Factory _repos/ms-swift:
 	@echo "Initializing submodules..."
@@ -65,7 +87,7 @@ clean-submodules:
 	@git submodule deinit -f _repos/*
 
 # Explicit build targets with prerequisites
-html dirhtml singlehtml latex pdf: fetch-config copy-docs
+html dirhtml singlehtml latex pdf: fetch-config copy-docs sync-onnxruntime-doc
 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 
 # Catch-all target for other Sphinx targets (clean, help, etc.)

_static/custom.css

@@ -318,6 +318,45 @@
    margin-bottom: 5%;
 }
 
+body.onnxruntime-quickstart-page .rst-content {
+   color: #27384a;
+   font-size: 16px;
+   line-height: 1.75;
+}
+
+body.onnxruntime-quickstart-page .rst-content h1,
+body.onnxruntime-quickstart-page .rst-content h2,
+body.onnxruntime-quickstart-page .rst-content h3 {
+   color: #1f4b8f;
+}
+
+body.onnxruntime-quickstart-page .rst-content h1 {
+   border-bottom: 1px solid #d8e3f2;
+   padding-bottom: 8px;
+}
+
+body.onnxruntime-quickstart-page .rst-content a {
+   color: #1f63d8;
+}
+
+body.onnxruntime-quickstart-page .rst-content table.docutils {
+   border: 1px solid #d8e3f2;
+}
+
+body.onnxruntime-quickstart-page .rst-content table.docutils th {
+   background: #f2f7ff;
+}
+
+body.onnxruntime-quickstart-page .rst-content table.docutils tr:nth-child(even) td {
+   background: #f9fbff;
+}
+
+body.onnxruntime-quickstart-page .rst-content .highlight {
+   background: #f7faff;
+   border: 1px solid #d8e3f2;
+   border-radius: 6px;
+}
+
 .box .flex-grow {
    flex-grow: 1; /* 让文本内容占据剩余空间 */
 }

_static/onnxruntime_quickstart.js

@@ -0,0 +1,14 @@
+(function () {
+  function isQuickstartPage() {
+    var pathname = window.location.pathname.toLowerCase();
+    return pathname.indexOf('onnxruntime') !== -1 && pathname.indexOf('quick_start') !== -1;
+  }
+
+  document.addEventListener('DOMContentLoaded', function () {
+    if (!isQuickstartPage()) {
+      return;
+    }
+
+    document.body.classList.add('onnxruntime-quickstart-page');
+  });
+})();

conf.py

@@ -73,6 +73,7 @@ def setup(app):
     app.add_css_file('custom.css')
     app.add_js_file('package_info.js')
     app.add_js_file('statistics.js')
+    app.add_js_file('onnxruntime_quickstart.js')
 
     # Generate ascend_config.json if it doesn't exist (for RTD/CI builds)
     import os.path

index.rst

@@ -233,7 +233,7 @@
       <div class="project-card">
          <div class="card-top"><div class="card-icon" style="background-image: url('_static/images/onnxruntime.png')"></div><h3 class="card-title">onnxruntime</h3></div>
          <p class="card-desc">跨平台高性能推理加速器，v1.13.1 起支持昇腾。</p>
-         <div class="card-footer"><a href="https://github.com/microsoft/onnxruntime">官方链接</a><span class="split">|</span><a href="sources/onnxruntime/install.html">安装指南</a><span class="split">|</span><a href="sources/onnxruntime/quick_start.html">快速上手</a></div>
+         <div class="card-footer"><a href="https://github.com/microsoft/onnxruntime">官方链接</a><span class="split">|</span><a href="sources/onnxruntime/install.html">安装指南</a><span class="split">|</span><a href="sources/_generated/sources/onnxruntime/quick_start.html">快速上手</a></div>
       </div>
 
       <!-- Sentence Transformers -->

sources/onnxruntime/index.rst

@@ -5,4 +5,4 @@ onnxruntime
    :maxdepth: 2
 
    install.rst
-   quick_start.rst
+   ../_generated/sources/onnxruntime/quick_start