如何解决生成 rustdoc 时如何使用本地文件作为 crate 徽标? 编辑
可以使用以下方法为 crate 设置 favicon 和 logo 的 favicon :
如记录here。
但是,我不想公开上传我的徽标,因此希望自动将这些文件包含在 /target/doc
中并从那里引用它们。
目前,我已将相应的数据 url(base64 编码)放入这些字段中,并且它工作正常,但它极大地膨胀了设置这些属性的源文件。
我知道我可以在使用脚本生成文档后将图像复制到 target/doc
中,然后使用相对 url 引用它们,但我想避免这种情况,以便我仍然可以使用生成文档cargo doc
。
编辑
评论中使用 --output
中的 rustdocflags
设置 rustdoc
的 .cargo/config.toml
标志的建议也不起作用,因为它导致 error: Option 'output' given more than once
。除此之外,它不适合我,因为(至少据我所知)我只能在那里给出绝对路径,而我需要使用图像的相对路径的解决方案,因为我将这些图像存储在货物根目录的子目录,方便使用git等转移到另一个系统。
解决方法
感谢 eggyal 的最新评论,我终于想出了如何做到这一点:
在我的 build.rs
中,我将文件复制到 target/doc/
:
fn main() {
// Copy the images to the output when generating documentation
println!("cargo:rerun-if-changed=assets/doc");
std::fs::copy("assets/doc/logo.ico","target/doc/logo.ico").expect("Failed to copy crate favicon when building documentation.");
std::fs::copy("assets/doc/logo.png","target/doc/logo.png").expect("Failed to copy crate logo when building documentation.");
}
然后我只需要确保在引用它们时使用绝对路径,如下所示:
#![doc(html_favicon_url = "/logo.ico")]
#![doc(html_logo_url = "/logo.png")]
一般来说,最好读取 CARGO_TARGET_DIR
环境变量而不是硬编码 target/doc
,但这在构建脚本中是 not yet available。
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。