Merge pull request flagos-ai#47 from armstrongttwalker-alt/docs/fix-homepage

docs: fix zh-CN translation warnings

Author: armstrongttwalker-alt

docs/source/_static/css/custom.css

@@ -7,4 +7,33 @@
 .sidebar-primary-item .logo__image {
     max-height: 45px !important;
     width: auto !important;
-}
+}
+
+/* ============================================
+    SPHINX-TIPPY BUG FIX
+    Ensures tooltips are visible and layered correctly
+   ============================================ */
+
+.tippy-box {
+    background-color: var(--pst-color-surface) !important;
+    color: var(--pst-color-text-base) !important;
+    border: 1px solid var(--pst-color-border) !important;
+    box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15) !important;
+    z-index: 10000 !important; /* Forces tooltips above the book-theme sidebar/navbar content */
+}
+
+/* Fix the tooltip arrow color to match the card background */
+.tippy-box[data-placement^='top'] > .tippy-arrow::before {
+    border-top-color: var(--pst-color-surface) !important;
+}
+.tippy-box[data-placement^='bottom'] > .tippy-arrow::before {
+    border-bottom-color: var(--pst-color-surface) !important;
+}
+.tippy-box[data-placement^='left'] > .tippy-arrow::before {
+    border-left-color: var(--pst-color-surface) !important;
+}
+.tippy-box[data-placement^='right'] > .tippy-arrow::before {
+    border-right-color: var(--pst-color-surface) !important;
+}
+
+tippy_tip_selector = "figure, table, img, p, aside, div.admonition, div.literal-block-wrapper, dl.glossary dd"

docs/source/conf.py

@@ -74,7 +74,7 @@
 
 html_theme = "sphinx_book_theme"
 html_static_path = ["_static"]
-# html_css_files = ["css/custom.css"]
+html_css_files = ["css/custom.css"]
 # html_js_files = []
 
 # Logo and favicon configuration based on build language

docs/source/index.md

@@ -3,7 +3,7 @@
 A benchmark framework for evaluating LLM and agent-based Triton kernel generation across multiple hardware platforms.
 
 ```{button-ref} getting-started/index
-:ref-type: myst
+:ref-type: doc
 :color: primary
 :class: sd-btn-lg sd-px-4 sd-py-2 sd-fw-bold
 

docs/source/locale/zh_CN/LC_MESSAGES/development/contributing.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: KernelGenBench Documentation \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2026-06-15 10:42+0800\n"
+"POT-Creation-Date: 2026-06-18 11:36+0800\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: zh_CN\n"
@@ -150,6 +150,6 @@ msgstr "许可证"
 #: ../../source/development/contributing.md:68
 msgid ""
 "By contributing, you agree that your contributions will be licensed under"
-" the MIT License."
-msgstr ""
-"通过贡献，您同意您的贡献将根据 MIT 许可证授权。"
+" the Apache 2.0 License."
+msgstr "通过贡献，您同意您的贡献将根据 Apache 2.0 许可证授权。"
+

docs/source/locale/zh_CN/LC_MESSAGES/getting-started/index.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: KernelGenBench Documentation \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2026-06-17 11:11+0800\n"
+"POT-Creation-Date: 2026-06-18 11:36+0800\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: zh_CN\n"
@@ -40,8 +40,8 @@ msgid "Before installing {term}`KernelGenBench`, ensure you have:"
 msgstr "在安装 {term}`KernelGenBench` 之前，请确保您具备："
 
 #: ../../source/getting-started/index.md:9
-msgid "Python 3.8 or higher"
-msgstr "Python 3.8 或更高版本"
+msgid "Python 3.10 or higher"
+msgstr "Python 3.10 或更高版本"
 
 #: ../../source/getting-started/index.md:10
 #, python-brace-format
@@ -149,56 +149,48 @@ msgid "Description"
 msgstr "描述"
 
 #: ../../source/getting-started/index.md
-#, python-brace-format
-msgid "`{term}`KernelGenBench``"
-msgstr "{term}`KernelGenBench`"
+msgid "`KernelGenBench`"
+msgstr "`KernelGenBench`"
 
 #: ../../source/getting-started/index.md
 msgid "210"
 msgstr "210"
 
 #: ../../source/getting-started/index.md
-#, python-brace-format
-msgid "Full set ({term}`ATen` + {term}`vLLM` + {term}`cuBLAS`)"
-msgstr "完整集合（{term}`ATen` + {term}`vLLM` + {term}`cuBLAS`）"
+msgid "Full set (ATen + vLLM + cuBLAS, NVIDIA)"
+msgstr "完整集合 (ATen + vLLM + cuBLAS, NVIDIA)"
 
 #: ../../source/getting-started/index.md
-#, python-brace-format
-msgid "`{term}`KernelGenBench-aten``"
-msgstr "{term}`KernelGenBench-aten`"
+msgid "`KernelGenBench-aten`"
+msgstr "`KernelGenBench-aten`"
 
 #: ../../source/getting-started/index.md
 msgid "110"
 msgstr "110"
 
 #: ../../source/getting-started/index.md
-#, python-brace-format
-msgid "{term}`ATen` operators only"
-msgstr "仅 {term}`ATen` 算子"
+msgid "ATen operators only"
+msgstr "仅 ATen 算子"
 
 #: ../../source/getting-started/index.md
-#, python-brace-format
-msgid "`{term}`KernelGenBench-vllm``"
-msgstr "{term}`KernelGenBench-vllm`"
+msgid "`KernelGenBench-vllm`"
+msgstr "`KernelGenBench-vllm`"
 
 #: ../../source/getting-started/index.md
 msgid "50"
 msgstr "50"
 
 #: ../../source/getting-started/index.md
-#, python-brace-format
-msgid "{term}`vLLM` operators only (NVIDIA only)"
-msgstr "仅 {term}`vLLM` 算子（仅限 NVIDIA）"
+msgid "vLLM operators only (NVIDIA only)"
+msgstr "仅 vLLM 算子 (仅限 NVIDIA)"
 
 #: ../../source/getting-started/index.md
-#, python-brace-format
-msgid "`{term}`KernelGenBench-cublas``"
-msgstr "{term}`KernelGenBench-cublas`"
+msgid "`KernelGenBench-cublas`"
+msgstr "`KernelGenBench-cublas`"
 
 #: ../../source/getting-started/index.md
-#, python-brace-format
-msgid "{term}`cuBLAS` operators only (NVIDIA only)"
-msgstr "仅 {term}`cuBLAS` 算子（仅限 NVIDIA）"
+msgid "cuBLAS operators only (NVIDIA only)"
+msgstr "仅 cuBLAS 算子 (仅限 NVIDIA)"
 
 #: ../../source/getting-started/index.md:124
 #, python-brace-format

docs/source/locale/zh_CN/LC_MESSAGES/index.po

@@ -59,7 +59,7 @@ msgstr "一个用于评估 LLM 和智能体驱动的 Triton 内核生成的基
 
 #: ../../source/index.md:5
 msgid "Getting Started"
-msgstr "<getting-started/index>快速开始"
+msgstr "快速开始"
 
 #: ../../source/index.md:17
 msgid ""