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:
parent
089fe88a75
commit
3e9a3aa70d
@ -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 的容错哲学一致)。
|
||||
//!
|
||||
//! -----------------------------------------------------------------------
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user