使用 /doc 时的自定义文档主题
Custom documentation topics when using /doc
我正在解析当您将 /doc 作为编译器选项传递时生成的 XML 文件。我们之前一直使用 VSDocman 来处理解析和文档网站生成以及自定义主题。我们最终不喜欢 VSDocman 生成的网站,并希望使用 MVC 做一些更健壮的事情。
解析 XML 文件很容易,但我还想像在 VSDocman 中那样将自定义主题添加到 XML 文件中。 Visual Studio 中的内置文档支持不可能做到这一点吗?我是否必须创建一个自定义 XML 文件来管理所有这些,手动编写(或构建一个自定义工具来生成它)并在我的 /doc 解析期间解析它?
Microsoft 本身并未定义额外文档的标准格式。因此,您必须决定接下来使用什么工具,然后使用它支持的格式。
此外,XML 非常灵活,您可以尝试将其从一种格式转换为另一种格式,所以我认为这没什么大不了的。
我正在解析当您将 /doc 作为编译器选项传递时生成的 XML 文件。我们之前一直使用 VSDocman 来处理解析和文档网站生成以及自定义主题。我们最终不喜欢 VSDocman 生成的网站,并希望使用 MVC 做一些更健壮的事情。
解析 XML 文件很容易,但我还想像在 VSDocman 中那样将自定义主题添加到 XML 文件中。 Visual Studio 中的内置文档支持不可能做到这一点吗?我是否必须创建一个自定义 XML 文件来管理所有这些,手动编写(或构建一个自定义工具来生成它)并在我的 /doc 解析期间解析它?
Microsoft 本身并未定义额外文档的标准格式。因此,您必须决定接下来使用什么工具,然后使用它支持的格式。
此外,XML 非常灵活,您可以尝试将其从一种格式转换为另一种格式,所以我认为这没什么大不了的。