Markdown DocFx参考标记不同的项目

Markdown DocFx参考标记不同的项目,markdown,documentation-generation,xml-documentation,docfx,Markdown,Documentation Generation,Xml Documentation,Docfx,我们正在开发一个多项目的*.sln解决方案,并且可以在单独的Asp.Net Web csproj中使用DocFx成功生成包含*.md文章的API文档,仅用于文档 但我们希望维护和引用单个*.csproj项目中的本地标记*.md文章和图像,并引用和重用全局文档站点中的那些,但不知何故,我们只从Web.csproj中的/Articles文件夹中获取*.md文件 以下是当前的docfx.json。正如您所看到的,我们正在尝试引用来自不同项目的图像和标记文件 “./Generator/MyDocServ

我们正在开发一个多项目的*.sln解决方案,并且可以在单独的Asp.Net Web csproj中使用DocFx成功生成包含*.md文章的API文档,仅用于文档

但我们希望维护和引用单个*.csproj项目中的本地标记*.md文章和图像,并引用和重用全局文档站点中的那些,但不知何故,我们只从Web.csproj中的/Articles文件夹中获取*.md文件

以下是当前的docfx.json。正如您所看到的,我们正在尝试引用来自不同项目的图像和标记文件

“./Generator/MyDocService.Contracts/**.png”,以及

“./Generator/MyDocService.Contracts/*.md”

但它们都没有出现在我们的“obj”或“_site”文件夹中


我可以从中生成分布式*.md文件的唯一方法
所有可用的子项目都是将docfx.json放在解决方案的根目录中

我可以从中生成分布式*.md文件的唯一方法 所有可用的子项目都是将docfx.json放在解决方案的根目录中

{
  "metadata": [
    {
      "src": [
        {
          "files": [
            "*.csproj"
          ],
          "src": "../Generator/GenBasics",
          "exclude": [
            "**/obj/**",
            "**/bin/**",
            "_site/**"
          ]
        },
        {
          "files": [
            "*.csproj"
          ],
          "src": "../DocFrameworkCore/GenCore",
          "exclude": [
            "**/obj/**",
            "**/bin/**",
            "_site/**"
          ]
        },
        {
          "files": [
            "*.csproj"
          ],
          "src": "../Generator/GenImpl",
          "exclude": [
            "**/obj/**",
            "**/bin/**",
            "_site/**"
          ]
        },
        {
          "files": [
            "*.csproj"
          ],
          "src": "../DocFrameworkCore/GenCoreBasics",
          "exclude": [
            "**/obj/**",
            "**/bin/**",
            "_site/**"
          ]
        },
        {
          "files": [
            "*.csproj",
            "**.md",
            "**.png"
          ],
          "src": "../Generator/MyDocService.Contracts",
          "exclude": [
            "**/obj/**",
            "**/bin/**",
            "_site/**"
          ]
        }
      ],
      "filter": "filterConfig.yml",
      "dest": "obj/api"
    }
  ],
  "build": {
    "content": [
      {
        "files": [
          "api/**.yml"
        ],
        "cwd": "obj"
      },
      {
        "files": [
          "api/*.md",
          "articles/**.md",
          "../Generator/MyDocService.Contracts/*.md",
          "toc.yml",
          "*.md"
        ],
        "exclude": [
          "obj/**",
          "_site/**"
        ]
      }
    ],
    "resource": [
      {
        "files": [
          "../Generator/MyDocService.Contracts/**.png",
          "images/**"
        ],
        "exclude": [
          "obj/**",
          "_site/**"
        ]
      }
    ],
    "overwrite": [
      {
        "files": [
          "apidoc/**.md"
        ],
        "exclude": [
          "obj/**",
          "_site/**"
        ]
      }
    ],
    "dest": "_site",
    "globalMetadata": {
      "_appTitle": "MyDoc API",
      "_appFooter": "",
      "_appLogoPath": "images/My.png",
      "_appFaviconPath": "favicon.ico",
      "_enableSearch": true,
      "_disableContribution": true
    },
    "template": [
      "default",
      "docfx-tmpl/src"
    ]
  }
}