微软开源全新的文档生成工具 DocFX - 开源中国社区
微软开源全新的文档生成工具 DocFX
oschina 2016年01月03日

微软开源全新的文档生成工具 DocFX

oschina oschina 发布于2016年01月03日 收藏 106 评论 16

有免费的MySQL,为什么还要买? >>>  

微软放弃Sandcastle有些年头了,微软最近开源了全新的文档生成工具 DocFX,目前支持C#和VB,类似JSDoc或Sphinx,可以从源代码中提取注释生成文档之外,而且还有语法支持你加入其他的文件链接到API添 加额外的说明,DocFX会扫描你的源代码和附加的文件为你生成一个完整的HTML模版网站,你可以自己通过模版定制,目前已经内嵌了几个模版,包括静态 的HTML页面和AngularJS页面。你还可以自己定制模版,具体参考 how to create custom template

源代码: https://github.com/dotnet/docfx

文档: http://dotnet.github.io/docfx/

  • 点击“查看源文件”的API来路由到GitHub的源代码(您的API必须推送到GitHub上)

  • 提供DNX版本跨平台支持。

  • Visual Studio的无缝内使用docfx注:官方docfx.msbuild的NuGet包现在在预发布版本。您也可以使用源代码编译,并在本地使用它。

  • 我们支持Docfx Flavored Markdown(DFM) 编写的文档。  DFM是Github上 Markdown(GFM),并增加了一些新的功能,包括文件包含交叉引用 ,和YAML头 100%兼容 。有关DFM详细说明,请参考DFM

 
dotnet core网站就是使用docfx生成的文档示例: 。
在docfx中,最重要的就是生成文档,把markdown文件(gfm语法)转换成html,微软还开源一个基于gfm的并且很容易扩展的语法的markdown组件 MarkdownLite,代码包含在docfx,nuget库里包的名字是Microsoft.DocAsCode.MarkdownLite。
有一篇文档详细介绍了如何使用docfx: Getting Started with docfx,具体怎么使用请看这篇文章, 这里还有个OpenLiveWriter 的例子 Use docfx to auto-generate documents for OLW。

FAQ:

Q: docfx是什么?

A: docfx是一个api文档编译软件,它能根据c#/vb源代码生成对应的文档元数据并生成文档(目前提供html),并支持普通md文件。

Q: docfx的输入和输出是什么?

A: docfx metadata需要源代码来生成文档元数据,docfx build使用文档元数据+普通md文件生成文档(html)

Q: docfx支持定制模板么?

A: 是的,可以参考文档

Q: docfx跨平台么?

A: docfx支持在dnx下运行。

转载自:http://www.cnblogs.com/shanyou/p/5084618.html

本站文章除注明转载外,均为本站原创或编译。欢迎任何形式的转载,但请务必注明出处,尊重他人劳动共创开源社区。
转载请注明:文章转载自 开源中国社区 [http://www.oschina.net]
本文标题: 微软开源全新的文档生成工具 DocFX
分享
评论(16)
最新评论
0

引用来自“永&恒”的评论

到时候盗版出来各种WIN系统 他不是死掉了

引用来自“龙哥九号”的评论

没有linux有前途,所以没必要盗。
但是现在个人电脑还是WIN系统方便
0
开源的有点晚了,我都快拥抱java了
0
没搞明白怎么用
0

引用来自“永&恒”的评论

到时候盗版出来各种WIN系统 他不是死掉了
没有linux有前途,所以没必要盗。
0
到时候盗版出来各种WIN系统 他不是死掉了
0

引用来自“颠落大帝”的评论

微软是要在开源届争取一席之地

引用来自“人生想绕几个圈”的评论

然而并没有什么卵用
还是有点卵用的
0
据说今年微软要把Windows NT开源
0

引用来自“原来我还注册过这个号”的评论

今天据说要开源windows了
今年
0
今天据说要开源windows了
0

引用来自“颠落大帝”的评论

微软是要在开源届争取一席之地
然而并没有什么卵用
0
就是c#里的///注释吧
0
Hmmm
0
eechen还有三十秒到达战场,碾碎他们!
0
不值一提
0
wd
0
微软是要在开源届争取一席之地
顶部