如何解决来自XML注释中另一个项目的DocFX参考成员
我正在尝试让DocFX在不同项目中包含的代码文件之间管理引用。
考虑以下docfx.json:
{
"Metadata": [
{
"src": [
{
"files": [
"ProjectA/**/*.csproj","ProjectB/**/*.csproj"
],"exclude": [ "**/bin/**","**/obj/**" ],"src": ".."
}
],"dest": "api","filter": "filterConfig.yml","properties": {
"DefineConstants": "MYCONST"
}
}
],...
}
说ProjectA包含此文件:
namespace Foo {
/// <summary>
/// Link to another doc page: <see cref="Baz"/>
/// </summary>
public class Bar {
...
#if MYCONST
public string MyField = "abc";
#endif
}
}
并且ProjectB包含以下文件:
namespace Foo {
/// <summary>
/// Link to another doc page: <see cref="Bar"/>
/// </summary>
public class Baz {
...
}
}
在这种情况下,我收到如下警告:
Warning:[MetadataCommand.ExtractMetadata]Invalid cref value "!:Baz" found in triple-slash-comments for Bar defined in ../ProjectA/Bar.cs Line 2,ignored.
是否有某种方法可以在XML注释中正确引用另一个项目中的成员?当对files
元数据部分使用* .cs时,它可以工作,但是文档中的预处理器部分未正确包含在文档中。
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。