如何從用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
{

}

使用Sandcastle或SHFB可以實現這一點嗎？如何實現？

謝謝！

Answer 1

我正在運行Sandcastle幫助文件生成器GUI的1.9.3.0版，在“可見性”部分中具有DocumentInternals設置。 此設置僅刪除到內部接口的鏈接並將其從文檔中刪除，但是它們始終顯示在類中。

因此，我認為沒有簡單的解決方案可以完成此任務。 編輯Sandcastle文件可能是一種解決方案。

Answer 2

我也在Sandcastle Codeplex討論中提出了這個問題- 如何從類幫助頁面中刪除內部接口？

由於沒有得到足夠的答案，我最終創建了一個自定義的Sandcastle幫助文件構建器插件，該插件在生成反射信息后掛接到SHFB。

然后，它將打開反射信息文件，並從實現內部接口的類型中刪除有關實現內部接口的信息，並保存修改的反射信息文件。