xfy/yggdrasil
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

docs(makefile): cargo doc 默认使用 ayu 主题

Browse Source 
通过 RUSTDOCFLAGS="--default-theme=ayu" 透传给 rustdoc，生成产物
根节点写入 data-theme="ayu"。默认值语义：浏览器未记住主题时生效。
This commit is contained in:
xfy 2026-06-26 10:17:12 +08:00
parent aa3bbdc522
commit 2b5cd5f64f
1 changed files with 5 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
Makefile
View File

@ -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