.net - SHFB - .NET xml 文件中的变音符号问题

Question

我们正在使用 Sandcastle 和 SHFB 为 .NET 项目创建文档。基本上，这行得通。

不幸的是，我们正在使用带有德语语言包的 .NET（这将保持这种方式 ;-)），但显然 SHFB 在加载带有德语变音符号的 .NET 自己的 XML 文件时存在问题。

我们得到的是 XmlParser 抛出的异常，看起来它无法正确读取文件（尽管文件内的编码设置为 UTF8）。问题是这些文件不受我们控制，它们是由 Microsoft 创建的。

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

有官方解决方案吗？

Answer 1

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

取自 Sandcastle 帮助文件生成器页面：

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

注意： & 和 # 之间的空格是我插入的，以避免格式化。

请参阅此处的字符的数字表示