2015-10-28 41 views
0

我記錄了一個C#項目,它是由包含8個接口,類和枚舉的單個命名空間構建的。C#文檔 - 可能在名稱空間內添加父節點?

我正在使用sandcastle的最後一個版本(2015年7月)。 因爲所有的接口,類和枚舉都在同一個命名空間下,所以sandcastle的結果我得到了所有在同一個API內容父節點下,這不是我想要的。 相反,我希望所有接口在一個父代下,所有類在另一個父節點下,並且所有枚舉在另一個下。另外(如果可能)我想爲每個API父節點提供一個概念性的兄弟節點,來描述概念。

可能嗎?如果沒有,你可以建議其他解決方案嗎? 注意我無法添加命名空間。

隨着沙堡 - 將有可能通過使用幾個內容佈局,每個接口一個? (不確定可以爲命名空間使用多於1個內容佈局)。

感謝

回答

1

我找到了解決這一問題,並決定分享,以防萬一它可以是有用的人。

Sandcastle不支持將API文檔分解爲幾個節點。所以我找到的解決方法是使用HTML Workshop Manager根據需要重新排列HTML。只需在HTML Workshop經理中創建一個項目,並將其設置爲使用由Sandcastle生成的HTML。通知Sandcastle HTML文件名稱只是數字,所以需要根據html內容以某種方式重命名它。

HTML Workshop Manager具有命令行界面,因此可以自動從Sandcastle的htmls創建CHM的整個過程。爲此,您需要預先在HTML Workshop管理器中創建一個項目,然後編寫一個代碼來更新其內容表(.hhc文件)和索引文件(.hhk),以便使用Sandcastle的HTML。我建議使用HTML Agility pack,因爲.hhc和.hhk文件是htmls。

評論將是appretiated。

相關問題