我们正在开发一个多项目的*.sln解决方案,可以使用单独的API Web csproj中的DocFx为它成功地生成*.md文档,仅用于文档。但是,我们希望在各个*.csproj项目中维护和引用本地Markdown *.md文章和图像,并在全局文档站点中引用和重用这些文章和图像,但不知何故,我们只能从Web.csproj中的/articles这是当前的docfx.json。如您所见,我们正在尝试引用<
我一直在使用DocFX为C#生成代码文档,并且在很大程度上取得了很大的成功。这些文章是灵活的,我非常喜欢使用标记来维护它们,同时让它们与API引用并行使用。我还花了很多时间记录Markdown中的演练,并构建了CI管道。我想解决的问题是,我需要找到一种方法,使我的代码文档(xml )输出成为标记,而不是html,这样它就可以由标记wiki解决方案,特别是Azure DevOps (又名TFS)托管。Azure Dev
docfx文档站点展示了如何自定义默认模板中使用的各种.partial文件(参见)。我遵循了这些说明,创建了一个新的模板文件夹,并在其中放置了一个修改过的styles\main.css文件,并在下执行了步骤--应用模板部分,其中除了默认值之外还指定了自定义模板名: "templates/<name of your your HTML template folder>"但是,当我构建站点时,_ site /