docfx相关内容

我如何为C#生成文档,并将其作为Azure DevOps Wiki的Markdown输出?

我一直在使用DocFX为C#生成代码文档,并且在很大程度上取得了很大的成功。这些文章很灵活,我真的很喜欢我可以使用markdown来维护它们,同时让它们与API引用并存。我还花时间记录了Markdown中的演练,并构建了CI管道。 我试图解决的问题是,我需要找出一种方法来将我的代码文档(XML注释)输出标记为markdown,而不是html,这样它就可以托管在markdown wiki解决方 ..
发布时间:2022-04-08 16:17:25 C#/.NET

DocFx:如何在网站上创建目录导航?

我想创建一个目录,看起来像 DocFx他们的官方网站: 使用默认的 docfx init 命令使用所有默认值,我的网站在构建时如下所示: \ 我试过篡改 toc.yml 文件,但没有这样的运气.我如何获得这种导航,以及与 DocFx 相关的顶级导航? 解决方案 原来问题是试图在本地提供我的文件 - 安全沙箱阻止了一些 JavaScript 的运行.使用 docfx --s ..
发布时间:2021-11-24 18:10:56 C#/.NET

使用本地TFS连续部署DocFx文档

我正在努力使用本地TFS为DocFX项目建立一个连续的部署过程. 此处描述了该过程,但是示例演练是针对VSTS的,并且我具有本地TFS(2013版).基本思想是在每次签入时构建和部署文档网站.该过程使用的 DocFx构建任务扩展确实支持-前提TFS ...我只是看不到如何使它正常工作! 我有一个包含单个C#项目的VS解决方案,该项目的Nuget引用了docfx.console版本2.3 ..
发布时间:2020-07-21 20:03:35 其他开发

如何自定义Docfx文档(主题或模板)?

我刚刚开始使用Docfx并设置了一些基本的概念性文档.现在,我想对主题进行一些调整(公司徽标,也许一些字体更改等). 官方文档仅给出了如何创建的高级描述一个新的模板.我以前从未使用过模板语言,因此,如果可能的话,我现在暂时避免使用这种语言. 我的问题是:我如何才能对默认主题进行一些小的调整,例如对CSS进行一些更改,或者添加外部资源(如字体真棒)? 我是否必须创建整个模板(或模板 ..
发布时间:2020-07-21 20:03:30 其他开发

PackageReference条件被忽略

在我的VS 2017项目中,我引用了docfx.console包,我希望仅在满足特定条件时使用它.但是该软件包可用于所有构建. 这是我项目的一部分.我希望在配置为Installer/AnyCPU并且VS正在构建net40风格时使用docfx.console. ..
发布时间:2020-05-13 00:01:57 其他开发