From 2b5cd5f64f26742b4831d69303d102c5a7e3a63c Mon Sep 17 00:00:00 2001
From: xfy <i@rua.plus>
Date: Fri, 26 Jun 2026 10:17:12 +0800
Subject: [PATCH] =?UTF-8?q?docs(makefile):=20cargo=20doc=20=E9=BB=98?=
 =?UTF-8?q?=E8=AE=A4=E4=BD=BF=E7=94=A8=20ayu=20=E4=B8=BB=E9=A2=98?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

通过 RUSTDOCFLAGS="--default-theme=ayu" 透传给 rustdoc，生成产物
根节点写入 data-theme="ayu"。默认值语义：浏览器未记住主题时生效。
---
 Makefile | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/Makefile b/Makefile
index b36b3d5..dfa0a85 100644
--- a/Makefile
+++ b/Makefile
@@ -60,12 +60,15 @@ test:
 
 # 只编译当前 crate 的文档（--no-deps 跳过依赖，--document-private-items
 # 让纯 binary crate 的内部模块/私有项也进文档，否则页面基本是空的）。
+# RUSTDOCFLAGS 把 rustdoc 的 --default-theme=ayu 透传过去——cargo doc 本身
+# 无主题参数，但会把该环境变量转交给底层 rustdoc。注意它是默认值，浏览器
+# 若已记住上次的主题选择（localStorage）则不会被覆盖。
 doc:
-	@cargo doc --no-deps --document-private-items
+	@RUSTDOCFLAGS="--default-theme=ayu" cargo doc --no-deps --document-private-items
 
 # 同 doc，生成完自动用浏览器打开。
 doc-open:
-	@cargo doc --no-deps --document-private-items --open
+	@RUSTDOCFLAGS="--default-theme=ayu" cargo doc --no-deps --document-private-items --open
 
 clean:
 	@cargo clean