SHFB - .NET xml文件中的元音變音問題

Question

我們使用Sandcastle和SHFB爲.NET項目創建文檔。基本上，這是有效的。

不幸的是，我們正在使用帶有德語語言包的.NET（並且這樣會保持這種方式;-)），但顯然SHFB在使用德語元音變音器加載.NET自己的XML文件時遇到了問題。

我們得到的是由XmlParser引發的異常，因爲它似乎無法正確讀取文件（儘管文件內的編碼設置爲UTF8）。問題是這些文件不在我們的控件下，它們是由Microsoft創建的。

一個可能的解決方案可能是卸載.NET的德語語言包，但首先這是一種解決方法，而不是解決方案，第二個卸載程序警告我們「一個或多個產品停止工作」.. 。爲了試用它，這有點太關鍵了。

有沒有官方的解決方案呢？

Answer 1

我不確定這是否能解決您的問題，但您可以嘗試使用變音符號的數字表示。

從沙堡幫助文件生成器頁面摘自：

當使用實體來表示XML 語言資源文件或標題文本的特殊字符，版權文本等， 使用數字形式，而因爲XML解析器將不會識別它們並會拋出異常。例如，如果您 指定Ä（帶分音符的拉丁文大寫字母A），則會生成例外 。要修復它，請改用數字形式（&＃196;）。 這也適用於版權文本中的符號，例如©。 相反，你應該使用&＃169;獲得版權符號。

注：&和＃之間空白被我插入，避免格式化。

見here字符