电商网站开发目的,有几个网站能在百度做推广,开发公司注销时剩余未售房产如何处理,网站建设代码怎么写由于这三项技术涉及到的要点以及内容较多#xff0c;希望大家有空能自己挖掘一下更多更深的用法。0x01、介绍VS#xff0c;即VS2017以及以上版本#xff0c;宇宙最好的IDE#xff0c;集成了宇宙最有前景的平台#xff0c;前阶段也支持了宇宙最好的语言。Github#xff0c… 由于这三项技术涉及到的要点以及内容较多希望大家有空能自己挖掘一下更多更深的用法。 0x01、介绍 VS即VS2017以及以上版本宇宙最好的IDE集成了宇宙最有前景的平台前阶段也支持了宇宙最好的语言。 Github知名的代码/项目托管平台不想赘述了如果干两三年了这个都不认识自觉转行吧我不在文章里说什么但你得晓得我肯定偷偷的鄙视你了。 Docfx类似JSDoc或Sphinx可以从源代码中提取注释生成文档之外而且还有语法支持你加入其他的文件链接到API添加额外的说明DocFX会扫描你的源代码和附加的文件为你生成一个完整的HTML模版网站你可以自己通过模版定制目前已经内嵌了几个模版包括静态的HTML页面和AngularJS页面。 哎呀说白了就是根据你的.cs 文件生成一些API注释首页之类的就是说你用吹灰之力就能免去文档的烦恼就这码事。 0x02、吐槽 我觉得VS上的github插件巨难用反正我用它上不来气儿。之前本人用惯了PC端高端大气上档次同时也保证了简洁清爽功能全。PC端下载地址https://desktop.github.com/ 我用的是旧版(相比于前两天的release来说新版我下载不下来可能宇宙发生了什么大事影响到了)。 docfx生成默认环境的那个地方有点不妥不能覆盖文件夹。 0x03、搭建环境 1、VS得有Github扩展。 2、有Github账号 3、下载docfx,配置环境变量(让你的命令行能找到docfx.exe) 4、接下来咱就走一种情况尽量能覆盖你所有的操作的情况。 0x04、请开始表演 1、用Github创建一个库记得创建readme和协议协议如果你不知道用啥就用MIT如图。 建库的方式有很多种别再这里跟我鸡蛋挑骨头明白咋回事就行了。 2、想尽一切办法拉到本地。 PC你所需要的操作就是在红框里用鼠标点点点加号-用户-clone。 VS先登陆登陆完了打开团队资源管理器Path是你的库的本地路径。如果本地已经存在这个路径了它不允许这点我也想吐吐槽。 3、拉到本地之后打开它Vs里: 打开-文件-文件夹。 4、打开PM(程序包管理控制台)在该目录下(注意你当前环境的路径位置)敲命令: docfx init -q 这个命令是让你生成一个默认的文档编辑框架。当然了还有其他选项比如-o 和上面的操作是一个德行虽然说可以指定目录但是不能指定一个存在的目录。 5、你敲完了之后会有一个新的文件夹叫“docfx_project”, 别害怕把里面你的东西都剪切出来放到外面(就是你clone出来的本地文件夹)然后删掉这个docfx_project文件夹。此时你可以向Github上提交一次你的改动。 a、 b、 c、 d、提交失败的话可能服务器版本中某些文件比你新那你就点蓝色的同步。没有就点推送推过去。 6、打开一个新的VS开始创建你的项目。注意看图 这里有个src文件夹是它帮咱们创建的咱们就可以把项目建在这里面。写你的接口写你的注释写你一切想写的方法。然后更改-提交-同步/推送。此时你应该打开了两个VS了已经。 7、改文件打开docfx.json metadata节点下src/files的内容 改成 src/**.cs. 这个就是寻找你的C#文件然后帮你生成接口页面。 src/exclude的内容 添加 docs/** 这个就是你生成的时候这下面的东西都排除掉不参与生成。 之后此文件中还有挺多exclude你也都填上因为docs这个文件夹很重要一会讲。 build 节点下 dest节点内容改成 docs。就是这东西把结果都放在docs文件夹里。 template节点内容也可以改成statictoc 使用残暴模式不用服务器本地双击就看到页面的那种。 其他选项可以意会参考文档见:http://dotnet.github.io/docfx/tutorial/docfx_getting_started.html 8、生成PM里敲: docfx .\docfx.json --server 然后去docs 文件夹里看看效果 9、配置Github, 当前代码库的页面上面有个Setting-往下拉找到Github Page-选那个带有docs的选项然后save然后记录一下地址。你以后发布用。 10、效果 11、其他一些高级的编辑技巧参见makedown另外也可以参考我的另一个开源项目的文档https://github.com/NMSLanX/Mellivora 注Github库里的文件图片可能在你发布的项目主页上引用不到请直接在你的docfx工程里进行本地添加引用。 0x05、广告时间 0x06、结尾 各位这东西多而杂若有遗漏请知乎一声。 欢迎大家在飞雪或连天群里进行讨论和补充感谢各位。原文地址:http://www.cnblogs.com/NMSLanX/p/8283878.html.NET社区新闻深度好文欢迎访问公众号文章汇总 http://www.csharpkit.com
