如何包含任意降价文件作为文档属性？ [复制]

Question

如果设置了 readme Cargo.toml 键，则 doc.rs 在 crate 的索引页上呈现自述文件。在本地运行 cargo doc 时有没有办法模拟这个？

如果我添加：

#![doc = r###"contents
of
README.md
here
"###]

作为文字，我得到了我正在寻找的行为，但是内联我的整个 README.md 的副本对于进行更新非常不方便。

我试过了：

#![doc = include!("README.md")]

但这会报错：

error: unexpected token: `include`
 --> src/lib.rs:3:10
  |
3 | #![doc = include!("README.md")]
  |          ^^^^^^^

Answer 1

有一个不稳定的功能，external-doc，可以实现这一点：

示例用法（仅夜间）：

#![feature(external_doc)]

#![doc(include = "../README.md")]