我正在编写一个 C# winforms 应用程序,我想为我的代码创建带有 XML 注释的文档。但是,似乎我做错了什么,无法弄清楚它是什么。目前,为了生成 HTML 文档,我正在使用DocFX(但我也尝试了sandcastle,但结果相同)。创建 XML 文件和 HTML 文档时,它似乎只包含我的主Form1.cs
类(这很有趣,因为在那个特定文件中我没有任何 XML 注释)。不包括其他.cs
文件(由 XML 注释组成)(它们在整个开发过程中通过 Visual Studio 添加到项目中,右键单击项目 -> 添加 -> 新项目 -> C# 类)。这是我的docfx.json
:
{
"metadata": [
{
"src": [
{
"files": [
"*.cs"
],
"cwd": ".",
"exclude": [
"**/obj/**",
"**/bin/**",
"_site/**"
]
}
],
"dest": "obj/api"
}
],
"build": {
"content": [
{
"files": [
"api/**.yml"
],
"cwd": "obj"
},
{
"files": [
"api/*.md",
"articles/**.md",
"toc.yml",
"*.md"
],
"exclude": [
"obj/**",
"_site/**"
]
}
],
"resource": [
{
"files": [
"images/**"
],
"exclude": [
"obj/**",
"_site/**"
]
}
],
"overwrite": [
{
"files": [
"apidoc/**.md"
],
"exclude": [
"obj/**",
"_site/**"
]
}
],
"dest": "_site",
"template": [
"default"
]
}
}
如何在 XML 创建中包含其他文件?