Merge pull request #85 from armstrongttwalker-alt/docs/fix-cn-search

armstrongttwalker-alt · web-flow · commit ef7b03d97cc1 · 2026-06-16T18:53:37.000+08:00
fix: patch stemWord method for Sphinx 9 search compatibility
diff --git a/docs/conf.py b/docs/conf.py
@@ -265,13 +265,18 @@ def get_project(projects):
 # =====================================================================
 
 # 1. Inject front-end fallback scripts early in HTML <head> for Chinese localization.
-# This bypasses the Sphinx 9+ 'ChineseStemmer is not defined' runtime crash.
+# This bypasses the Sphinx 9+ 'stemmer.stemWord is not a function' runtime crash.
 html_context = {}
 if docset == "zh":
     html_context["metatags"] = """
     <script>
         if (typeof Stemmer === 'undefined') {
-            window.Stemmer = function() { return { stem: function(w){return w;} }; };
+            window.Stemmer = function() { 
+                return { 
+                    stem: function(w){ return w; },
+                    stemWord: function(w){ return w; }
+                }; 
+            };
         }
         if (typeof ChineseStemmer === 'undefined') {
             window.ChineseStemmer = window.Stemmer;
