来自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 (将#修改为@）