SHFB - .NET xml文件中的元音变音问题

Question

我们使用Sandcastle和SHFB为.NET项目创建文档。基本上，这是有效的。

不幸的是，我们正在使用带有德语语言包的.NET（并且这样会保持这种方式;-)），但显然SHFB在使用德语元音变音器加载.NET自己的XML文件时遇到了问题。

我们得到的是由XmlParser引发的异常，因为它似乎无法正确读取文件（尽管文件内的编码设置为UTF8）。问题是这些文件不在我们的控件下，它们是由Microsoft创建的。

一个可能的解决方案可能是卸载.NET的德语语言包，但首先这是一种解决方法，而不是解决方案，第二个卸载程序警告我们“一个或多个产品停止工作”.. 。为了试用它，这有点太关键了。

有没有官方的解决方案呢？

Answer 1

我不确定这是否能解决您的问题，但您可以尝试使用变音符号的数字表示。

从沙堡帮助文件生成器页面摘自：

当使用实体来表示XML 语言资源文件或标题文本的特殊字符，版权文本等， 使用数字形式，而因为XML解析器将不会识别它们并会抛出异常。例如，如果您 指定Ä（带分音符的拉丁文大写字母A），则会生成例外 。要修复它，请改用数字形式（&＃196;）。 这也适用于版权文本中的符号，例如©。 相反，你应该使用&＃169;获得版权符号。

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

见here字符