docs(mhchem): 修复模块级文档中的 broken intra-doc links

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 零警告。
This commit is contained in:
xfy 2026-07-23 17:48:06 +08:00
parent 089fe88a75
commit 3e9a3aa70d

View File

@ -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 的容错哲学一致)。
//!
//! -----------------------------------------------------------------------