2016-09-21 55 views
-2

我們在sd方法中使用TFS 2015內部部署。爲此,我們希望使用Visual Studio Build步驟在TFS中創建我們的構建。在執行此操作時,我們希望將Documentation(Doxygen)步驟插入到構建流程中,但每次包含此步驟時,構建都會失敗。爲什麼/ Documentation(Doxygen)從msdn中刪除?

我試圖得到一些答案,不管我們是否參數化了它的錯誤或什麼,所以我挖掘了互聯網。經過一番研究後,我來到這個網站: https://www.visualstudio.com/en-us/docs/build/define/build 在這個網站上我看不到文檔(Doxygen)了,儘管我之前看到它。此頁面上的最新更新時間爲9/7/2016。

我們的TFS 2015保持最新狀態,但仍有Doxygen一步。

我的問題:Doxygen以某種方式排除在TFS之外,還是將它?我們還需要用TFS Build來創建文檔嗎?

由於提前, Collapo

回答

1

從未有過官方的支持,微軟的Doxygen?

http://www.stack.nl/~dimitri/doxygen/helpers.html

向下滾動到:

的Visual Studio

如果您使用Visual Studio .NET看看史蒂夫國王的一套 加載項。 Greg Engelstad編寫了一個perl腳本來解析Visual Studio解決方案文件(.sln)的Visual ,併爲其中包含的每個單獨的 項目運行doxygen。

賈森 - 威廉姆斯已經寫了一個加載項的Visual Studio 2005 ,它能夠自動生成doxygen的(或DocXml)從 大部分代碼元素風格的註釋(文件,命名空間,類,結構,枚舉功能, 等等)。它分析C,C++,C#和Java代碼,以生成完整的doxygen註釋,並且如果代碼元素被更改爲 ,則可以更新這些註釋,然後用文字包裝描述來保持它們整潔。它使用 用戶可編輯規則集來提供對 元素,參數和返回代碼的自動描述,從而最大程度地減少涉及 在生成doc註釋方面的工作量。

jgallardo還編寫了一個Addin for Visual Studio,可以簡化 瀏覽由doxygen生成的文檔。

一個名爲DoxyComment的Visual Studio 2005插件由 Troels Gram創建。它旨在幫助您將敏感註釋塊的上下文插入到C/C++源文件中。 DoxyComment也 附帶一個xslt模板,可以讓您生成文檔,如MSDN庫 。

如果您正在使用微軟的開發人員Studio 6.0,一個附加的所謂 DoxBar是可用的,可用於運行從內部 開發工作室,並通過生成的HTML幫助文件中搜索Doxygen的。 注意:我沒有足夠的時間來維護DoxBar,所以 我把DoxBar移到了sourceforge。Olivier Sannier已經爲DoxBar引入了 的改進。如果您也想加入開發團隊 ,請在sourceforge註冊爲用戶,並將您的用戶 名稱郵寄給我。

Bernhard Nowara寫了一個配置文件編輯器,這是一個 類似於doxywizard的Windows工具。他還創建了DoxBar的增強版 ,其中包括他的編輯器和用於Visual Studio的一些宏,以簡化爲doxygen編寫源代碼的工作。這些變化的 已合併到Olivier Sannier的doxygen的更新版本中。

FeinSoftware已發佈了Microsoft的Visual Studio .NET中(的Visual C++)稱爲CommentMaker,創造 自定義函數頭,開發人員可以調整至最 具體的文件要求開發工具。默認情況下,它會生成兼容的註釋doxygen 。

+0

這裏是17 fromt他同一頁面的鏈接2016年8月https://web.archive.org/web/20160817135253/https://www.visualstudio.com/en-us/docs/build/define/build – zerohero

+0

我假設你爲Doxygen安裝的任何外掛程序需要更新(或因爲某些原因而不再支持它) – zerohero

+0

那麼我很確定我看到我連接的站點上的文檔(Doxygen)節點,但我現在還不確定。謝謝反正 – Collapo

0

文檔(Doxygen)是第三方提供的擴展,它永遠不會被Microsoft正式支持。

這是一個已知問題,它無法與TFS2015內部部署服務器正常工作。詳情請參閱此鏈接:Documentation (Doxygen)

已知問題

  • ,我們曾聽到擴展不與TFS 2015年(OnPrem)服務器正常工作。
  • Documentation Hub無法在Internet Explorer/Microsoft Edge中加載。 (請使用谷歌瀏覽器現在)
相關問題