我们在sd方法中使用TFS 2015内部部署。这样做我们想使用Visual Studio Build步骤在TFS中创建我们的构建。在执行此操作时,我们希望在构建流程中插入Documentation(Doxygen)步骤,但每次我们包含此步骤时,构建都会失败。
我试图得到一些答案,无论我们将其参数化为错误还是什么,所以我挖掘了互联网。经过一番研究后,我来到了这个网站: https://www.visualstudio.com/en-us/docs/build/define/build 在这个网站上我看不到文档(Doxygen)了,虽然我之前看过它。此页面的最新更新时间是2016年9月7日。
我们的TFS 2015保持最新,但仍然有Doxygen步骤。
我的问题:是不是以某种方式从TFS中排除了Doxygen,或者它会是什么?我们还有什么其他选择来使用TFS Build创建docuentation?
提前致谢, Collapo
答案 0 :(得分:1)
微软从未对Doxygen提供过官方支持吗?
http://www.doxygen.nl/helpers.html
向下滚动到:
Visual Studio
如果您使用Visual Studio .NET,请查看Steve King的一套 加载项。 Greg Engelstad编写了一个perl脚本来解析Visual Studio .NET解决方案文件(.sln)并为每个单独的运行doxygen 其中包含的项目。
Jason Williams为Visual Studio 2005编写了一个Addin& 2008年 它能够自动生成doxygen(或DocXml)样式注释 大多数代码元素(文件,命名空间,类,结构,枚举,函数, 等等)。它解析C,C ++,C#和Java代码以生成完全形成的 doxygen注释,如果代码元素是,则可以更新这些注释 改变了,并对描述进行自动换行以使其保持整洁。它使用了 一组用户可编辑的规则,用于提供自动描述 元素,参数和返回代码,最大限度地减少了工作量 在生成文档评论。
jgallardo还为Visual Studio编写了一个缓动的插件 浏览doxygen生成的文档。
创建了一个名为DoxyComment的Visual Studio 2005插件 Troels克。它旨在帮助您插入上下文 敏感注释阻塞到C / C ++源文件中。 DoxyComment也 附带一个xslt模板,可以生成类似的文档 MSDN库。
如果您使用的是Microsoft的Developer Studio 6.0,则会调用一个加载项 DoxBar可用于从内部运行doxygen Developer Studio并搜索生成的HTML帮助文件。 注意:我没有足够的时间自己维护DoxBar,所以 我将DoxBar移动到sourceforge。 Olivier Sannier推出了一个号码 改进了DoxBar。如果你也想加入开发 团队,请在sourceforge注册为用户并将您的用户邮寄给我 名。
Bernhard Nowara写了一个个人资料编辑器,这是一个 适用于Windows的类似doxywizard的工具。他还创建了一个增强版本 DoxBar包括他的编辑器和Visual Studio的一些宏 轻松准备doxygen的源代码。这些改变了 已经被Olivier合并到更新版的doxygen中 Sannier。
FeinSoftware发布了Microsoft Visual的开发工具 Studio .NET(Visual C ++)称为CommentMaker,它创建 可自定义的函数头,开发人员可以调整到最多 具体文件要求。默认情况下它会生成doxygen 兼容的评论。
答案 1 :(得分:0)
文档(Doxygen)是第三方提供的扩展,它从未得到Microsoft的正式支持。
这是一个众所周知的问题,它无法与TFS2015内部部署服务器一起正常运行。有关详细信息,请参阅此链接:Documentation (Doxygen)。
已知问题
- 我们听说过扩展程序无法正常使用TFS 2015(OnPrem)服务器。
- 文档中心无法在Internet Explorer / Microsoft Edge中加载。 (请立即使用谷歌浏览器)