From 3e9a3aa70d58d964a1f6af58988ad0501423a45a Mon Sep 17 00:00:00 2001 From: xfy Date: Thu, 23 Jul 2026 17:48:06 +0800 Subject: [PATCH] =?UTF-8?q?docs(mhchem):=20=E4=BF=AE=E5=A4=8D=E6=A8=A1?= =?UTF-8?q?=E5=9D=97=E7=BA=A7=E6=96=87=E6=A1=A3=E4=B8=AD=E7=9A=84=20broken?= =?UTF-8?q?=20intra-doc=20links?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit cargo doc 在 --document-private-items 下报 7 个 unresolved link 警告， 全部源自 src/api/mhchem.rs 的模块级 //! 文档： - 公开 API ce/pu 用简写 [`ce`] 无法解析，改用全路径链接 [`ce`](crate::api::mhchem::ce) / [`pu`](crate::api::mhchem::pu)。 - 私有项 Buffer/Parsed/Field/find_observe_groups/build_transitions 即便 写全路径也无法被 intra-doc link 解析器识别（rustdoc 对私有项的限制）， 改回普通反引号代码，不再生成链接。这些是模块内部实现细节，本就无需 跨项跳转。 修复后 make doc 零警告。 --- src/api/mhchem.rs | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/src/api/mhchem.rs b/src/api/mhchem.rs index d7853d8..1058a55 100755 --- a/src/api/mhchem.rs +++ b/src/api/mhchem.rs @@ -8,14 +8,14 @@ //! `ce("H2O")` → `\mathrm{H}\sb{2}\mathrm{O}` 之类，无需嵌入 katex 内部解析树。 //! //! 移植要点（TS→Rust）： -//! - 动态 `buffer` 对象 → [`Buffer`] 结构体（`Option` 字段 + `clear`）。 -//! - 动态 `Parsed = string | object` → [`Parsed`] 枚举；节点字段用 [`Field`]（字符串或节点向量）。 +//! - 动态 `buffer` 对象 → `Buffer` 结构体（`Option` 字段 + `clear`）。 +//! - 动态 `Parsed = string | object` → `Parsed` 枚举；节点字段用 `Field`（字符串或节点向量）。 //! - 正则模式（含 lookahead `(?=)`/`(?!)`，Rust `regex` 不支持）→ `fancy-regex`（已被 //! syntect 间接引入，此处显式声明）。 -//! - `findObserveGroups` 花括号配对扫描 → [`find_observe_groups`]。 -//! - 状态机转移表 → [`build_transitions`] 展开（对应 `_mhchemCreateTransitions`）。 +//! - `findObserveGroups` 花括号配对扫描 → `find_observe_groups`。 +//! - 状态机转移表 → `build_transitions` 展开（对应 `_mhchemCreateTransitions`）。 //! -//! 公开 API：[`ce`] / [`pu`]。任意内部异常都回退为原样输出（绝不 panic，与 +//! 公开 API：[`ce`](crate::api::mhchem::ce) / [`pu`](crate::api::mhchem::pu)。任意内部异常都回退为原样输出（绝不 panic，与 //! katex.rs 的容错哲学一致）。 //! //! -----------------------------------------------------------------------