如何从用Sandcastle或SHFB生成的类帮助页面中删除内部接口？

Question

我有一个实现了许多内部接口的类，我希望文档读者看不到这个类实现了所有这些内部接口，因为这些信息与读者无关。

例如，如果我有以下类：

public class MyPublicClass : MyBasePublicClass, MyPublicInterface, MyInternalInterface1, MyInternalInterface2, MyInternalInterface3
{

}

public class MyBasePublicClass
{

}

public interface MyPublicInterface
{
    // Interface members...
}

internal interface MyInternalInterface1
{
    // Interface members...
}

internal interface MyInternalInterface2
{
    // Interface members...
}

internal interface MyInternalInterface3
{
    // Interface members...
}

我希望文档读者这样看待MyPublicClass：

public class MyPublicClass : MyBasePublicClass, MyPublicInterface
{

}

这可以通过沙堡或SHFB实现吗?如何实现？

谢谢!

Answer 1

我也在Sandcastle Codeplex讨论中问了这个问题-- How to remove internal interfaces from class help page?

由于我没有得到足够的答案，我最终创建了一个自定义的Sandcastle帮助文件生成器插件，该插件在生成反射信息后挂接到SHFB中。

然后打开反射信息文件，并从实现内部接口的类型中删除有关实现内部接口的信息，并保存修改后的反射信息文件。

Answer 2

我正在运行1.9.3.0版本的Sandcastle Help File Builder GUI，它在可见性部分有一个DocumentInternals设置。此设置仅移除指向内部接口的链接，并将其从文档中移除，但它们始终显示在类上。

因此，我认为没有简单的解决方案来实现这一点。编辑Sandcastle文件可能是一种解决方案。