首页
学习
活动
专区
圈层
工具
发布
社区首页 >问答首页 >在rustdoc上的交互式依赖映射?

在rustdoc上的交互式依赖映射?
EN

Stack Overflow用户
提问于 2022-09-16 20:06:27
回答 1查看 104关注 0票数 2

当我使用C++进行项目时,我经常使用doxygen生成文档,doxygen有一个简洁的特性,可以生成交互式依赖图(如调用依赖关系、继承依赖关系等)。

该工具嵌入到html文档中,允许您放大、缩小和拖动东西。

我试图为一个项目的当前板条箱生成一个依赖关系图,如下所示:

图像是使用象形图生成的。

我有两个问题。

问题1)是,随着依赖关系图的增长,图像变得越来越难读:

这可以通过像doxygen这样的缩放和pan功能来解决,但我不知道如何生成和注入这种html (或者js?)从铁锈变成了自动文档。

问题2) svg文件不受css的影响,白色和黑色的配色方案看起来有点难看,这不太重要,但是如果svg能够反映css主题,那就太好了。

EN

回答 1

Stack Overflow用户

回答已采纳

发布于 2022-09-26 20:21:03

Rustdoc允许在生成内容之前和之后注入自定义CSS和HTML/JS。您可以通过各种命令行参数来实现这一点。

请参阅:https://doc.rust-lang.org/rustdoc/command-line-arguments.html

若要向标头中添加自定义HTML,可以使用--html-in-header参数。

代码语言:javascript
复制
$ rustdoc src/lib.rs --html-in-header header.html

其中header.html是您的自定义头HTML

此标志接受文件列表,并将它们插入<body>标记中,但在呈现的文档中通常在其他内容rustdoc生成之前插入。

请参阅:https://doc.rust-lang.org/rustdoc/command-line-arguments.html#--html-before-content-include-more-html-before-the-content

代码语言:javascript
复制
$ rustdoc src/lib.rs --html-after-content extra.html

其中,extra.html是您要在内容之后包含的自定义HTML。

此标志接受文件列表,并将其插入到</body>标记之前,但插入到通常呈现的文档中的其他内容rustdoc之后。

请参阅:https://doc.rust-lang.org/rustdoc/command-line-arguments.html#--html-after-content-include-more-html-after-the-content

最后用于自定义CSS

代码语言:javascript
复制
$ rustdoc src/lib.rs --extend-css extra.css

其中extra.css是自定义的css定义。

使用此标志,您传递的文件的内容将包含在Rustdoc的theme.css文件的底部。虽然这个标志是稳定的,但theme.css的内容并不稳定,所以要小心!更新可能会破坏主题扩展。

请参阅:https://doc.rust-lang.org/rustdoc/command-line-arguments.html#-e--extend-css-extend-rustdocs-css

不幸的是,我没有任何示例锈迹文档html -因此很难确切地说应该在注入的HTML/CSS/JS中包含什么来实现您想要的结果。我的建议是,如果你想问一个更具体的问题,并提供一个代码的例子,你可以尝试。

票数 1
EN
页面原文内容由Stack Overflow提供。腾讯云小微IT领域专用引擎提供翻译支持
原文链接:

https://stackoverflow.com/questions/73749853

复制
相关文章

相似问题

领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档