使用 DocFX 生成 .Net/Unity项目文档

栏目: ASP.NET · 发布时间: 7年前

内容简介:使用 DocFX 生成 .Net/Unity项目文档

孙广东  2017.5.27

http://blog.csdn.NET/u010019717

微软开源全新的文档生成工具 DocFX 类似JSDoc或Sphinx     如何使用看 :       

http://dotnet.github.io/docfx/tutorial/walkthrough/walkthrough_create_a_docfx_project.html

DocFX会扫描你的源代码和附加的文件为你生成一个完整的HTML模版网站。

比如我的测试  使用的Unity  UGUI 的源代码库!(突然发现 Unity 官方UI  源代码居然也是用了 .editorconfig 项目跟目录下)

在浏览器中  输入: http://localhost:8080/api/

使用 DocFX 生成 .Net/Unity项目文档

我好奇的是如何生成  Unity相关的文档:

我百度搜索类似的, 发现了一个Unitysdk 有使用:

https://github.com/mapbox/mapbox-unity-sdk

其中的documentation 下有 配置文件

https://github.com/mapbox/mapbox-unity-sdk/blob/develop/documentation/docfx_project/docfx.json

使用docfx 命令

  1. 下载

https://github.com/dotnet/docfx/releases

  1. 使用

创建初始项目

docfx init -q

此命令生成一个名为docfx_project的默认项目。

  1. 生成网站   (每次需要跟新API或者 修改了配置 都要在执行这个命令重新生成)

docfxdocfx_project\docfx.json --serve

现在你可以访问http://localhost:8080查看生成的网站。使用 -p 端口 可以指定端口。

注意 不要有中文路径, 特别是在docfx.json  配置中!

使用 DocFX 生成 .Net/Unity项目文档

我只是 修改了docfx.json 中的:

"metadata": [

{

"src": [

{

"src": "src/Unity-Technologies-ui-0155c39e05ca",

"files":["**/**.cs"]

}

],

"dest": "api"

}

],

"build": {

……………………………………..

然后执行生成网站的命令。

配置的路径要和  程序的执行路径要注意啊!

使用 DocFX 生成 .Net/Unity项目文档

工具的功能肯定不仅如此, 更多配置就自己看吧!

设置Unity项目 也是一样可以正常生成的:

使用 DocFX 生成 .Net/Unity项目文档

{

"metadata": [

{

"src": [

{

"src": "src/NiuGames",

"files":["**/**.cs"]

}

],

"dest": "api"

}

],

"build": {

因为Unity项目中什么都有, 第三方插件等等!

使用 DocFX 生成 .Net/Unity项目文档

你可以细化具体包含的路径 和 排除的路径!

完!


以上所述就是小编给大家介绍的《使用 DocFX 生成 .Net/Unity项目文档》,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对 码农网 的支持!

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

结构化计算机组成

结构化计算机组成

Andrew S.Tanenbaum / 刘卫东 / 机械工业出版社 / 2001-10-1 / 46.00

AndrewcS.Tanenbaum获得过美国麻省理工学院的理学学士学位和加利福尼亚大学伯克利分校的哲学博士学位,目前是荷兰阿姆斯特丹Vrije大学计算机科学系的教授,并领导着一个计算机系统的研究小组.同时,他还是一所计算与图像处理学院的院长,这是由几所大学合作成立的研究生院.尽管社会工作很多,但他并没有中断学术研究. 多年来,他在编译技术.操作系统.网络及局域分布式系统方面进行了大量的一起来看看 《结构化计算机组成》 这本书的介绍吧!

在线进制转换器
在线进制转换器

各进制数互转换器

图片转BASE64编码
图片转BASE64编码

在线图片转Base64编码工具

正则表达式在线测试
正则表达式在线测试

正则表达式在线测试