一.javascript注释规范 我们在编写javascript文件的时候,一般会添加一些注释.例如一些文件.类.方法和属性都应该用合适的标记和类型进行注释.这里不但方便我们的阅读,也能养成一个好的习惯.更大的好处是,我们可以根据这些注释生成帮助文档. 二.JSDoc 3 JSDoc 3是一个生成为Javascript生成API文档的工具.下载地址为:https://github.com/jsdoc3/jsdoc .使用JSDoc 3 我们需要有Node.js环境.Node.js安装好之后,我们

www.doxygen.org 的使用非常方便,下面分成2步介绍一下 1. 注释风格,需要在c/c++代码中按照下面的风格添加注释,基本上还是很顺手的 C++的注释风格 主要使用下面这种样式:即在注释块开始使用三个反斜杠‘/’ 文件注释 /** *@file 文件名 *@brief 概述 * *详细概述 * *@author 作者,包含email等 *@version 版本号(maj.min,主版本.分版本格式) *@date 日期 */ 命名空间的注释 ///@brief 简单概述 /// /

在使用python中,我们一般在模块,类,函数下使用docstring添加字符串说明性文档,使开发人员更好的可以看懂此代码是做什么用的.然而写了那么多的注释,我们想要一篇文档怎么办,第一种办法不可能将写完的注释直接手动的ctrl+c  ctrl+v的,此时sphinx就出现了,解决了这一问题. 要想使用它,首先得需要安装它,安装方式: pip install sphinx 安装完成之后,在主项目下创建docs文档 #创建完docs项目并切换到 docx目录下 cd docx 在 docx下运行

对于开发人员来说,构建一个消费应用程序时去了解各种各样的 API 是一个巨大的挑战.在你的 Web API 项目中使用 Swagger 的 .NET Core 封装 Swashbuckle 可以帮助你创建良好的文档和帮助页面. Swashbuckle 可以通过修改 Startup.cs 作为一组 NuGet 包方便的加入项目.Swashbuckle 是一个开源项目,为使用 ASP.NET Core MVC 构建的 Web APIs 生成 Swagger 文档.Swagger 是一个机器可读的 R

新生开学,各院系辅导员代领校园卡.需要打印一份领取卡的协议,协议模版固定,但各院系卡的数量不同.需要从excel表格中抽取数据往word文件中填,同事咨询是否可以用word中的邮件合并功能,心想有这功夫研究还不如自己写代码实现.一共三个问题:1)读取Excel表格数据,2)往word模板文件中写数据,3)生成word文件. 1)C#读取Excel文件中的数据:创建OleDb连接,将Excel作为数据源,读取至DataTable中,待使用 private static DataSet LoadDa

来源:fasiondog 许多UML建模工具可以自动生成文档,让需求人员.开发人员专心于需求.设计的建模.当然为了能够生成符合自己要求的模板,需对建模时的目录结构(模型和包)有所规划和要求,否则很难生成相应的文档.这要求提前了解相应的建模工具如何生成文档以及如何配置文档模板.不同的建模工具配置文档模板的方式和要求,如StarUML使用Word中的批注命令对元素模型进行遍历,而EA则通过RTF标注以及模型目录,相比之下EA的文档生成和模型的目录结构绑定的更紧,如果没有事先规划,更难生成文档.这里简

Sphinx是一个可以用于Python的自动文档生成工具,可以自动的把docstring转换为文档,并支持多种输出格式包括html,latex,pdf等. 安装 创建一个sphinx项目 下面的命令会自动生成一个默认的Sphinx模板 执行期间,它会一步步的询问对模板的设置,除了一些必须填写的选项,大部分填写默认值就行了,你会遇到这样一条叫autodoc的,需要选择yes 然后默认的目录就生成了,大概是这个样子 现在执行如下指令,就会生成一份空文档,存放在/build/html里,点击index

Python中本身带有很多实用的工具,如pydoc.pydoc模块主要用来从Python模块中提取信息并生成文档. 使用方法 在Windows和Linux下的使用方法有些区别. Windows python -m pydoc <modulename> 如: C:\>python -m pydoc module_test NB:module_test是自定义的模块,不要添加文件后缀. Linux pydoc <modulename> 如: $ pydoc module_test

主页:http://html5ify.com/doxmate/ 在windows下面使用doxmate 1. 下载node.js(msi)并安装 http://www.nodejs.org/download/ 2. 添加环境变量 (看你具体安装路径);C:\Users\Administrator\AppData\Roaming\npm 3. 安装doxmate : 打开cmd 运行 npm install doxmate -g 到此已安装完成: 在包含package.json .readme.m

sphinx 前言 Sphinx是一个可以用于Python的自动文档生成工具,可以自动的把docstring转换为文档,并支持多种输出格式包括html,latex,pdf等 开始 建一个存放文档的docs目录(跟项目路径同级),进入docs目录执行命令: sphinx-quickstart 填写相关信息 修改配置文件 conf.py 设置要处理的路径 import os import sys # path_one为当前路径 path_one = '..' # path_two为项目路径 path

JavaDoc生成文档 javadoc命令是用来生成自己的API文档 参数信息: @author 作者名 @version 版本号 @since 指明需要最早使用的jdk版本 @param 参数名 @return 返回情况 @throws 异常抛出情况 package com.kuang.base; /** * @author * @version * @since */ public class Doc { String name; /** * * @param name * @return

python代码测试并自动生成文档 Tips:两大工具:doctest--单元测试.Sphinx--自动生成文档 1.doctest doctest是python自带的一个模块.doctest有两种使用方式:一种是嵌入到python源码中,另外一种是放到一个独立文件. 1.1 嵌入源码 新建test.py import doctest ''' '>>>' 开头的行就是doctest测试用例. 不带 '>>>' 的行就是测试用例的输出. 如果实际运行的结果与期望的结果不一

Ldoc介绍 LDoc是一个Lua的文档生成工具,过去,比较常用的Lua生成文档的工具是LuaDoc,可惜作者自从2008年之后就再也没有发布过新的版本了,说明作者基本上已经放弃维护了.而LDoc则是一直在更新中,所以现在选择LDoc来给Lua生成文档是更好的选择,LDoc的Github主页. LDoc的一个优点就是,它的目的是为了和LuaDoc兼容并且拓展LuaDoc的功能而制作的,所以LuaDoc能够使用的标签LDoc也都可以使用.LDoc还有一些其他的LuaDoc不具备的优点,比如 LDo

一,网站根目录执行 $ composer require --dev phpdocumentor/phpdocumentor 二,进入vendor/bin/目录执行 $phpdoc -d D:\server\www\app\0.4.0\src\app\controllers\media -t D:\docs 生成文档完毕  

原创文章,欢迎阅读,禁止转载. doxygen是个好用的文档生成工具,他的强大功能有很多介绍,我就不说了.自带的chm帮助手册很全面,包括功能.注释规范.怎么配置.工具用法等.doxygen的用法共3步:1. 按照注释规范对代码加注释.2. 配置选项.3. 生成文档.配置选项可以使用命令行工具 doxyfen -g 生成一个配置模版,我直接使用带界面的配置向导来配.向导中的三个选项卡:1. wizard 进行大致的配置选择2. expert 进行精细的配置3. run 生成文档配置界面第一步如图

配置WCF同时支持WSDL和REST,SwaggerWCF生成文档 VS创建一个WCF工程,通过NuGet添加SwaggerWcf 创建完成后通过 程序包管理控制台 pm>Install-Package SwaggerWcf 也可在 工具 -> NuGet包管理器 -> 管理解决方案的NuGet程序包 安装. 配置 首先对项目添加Global.asax文件,改动如下: protected void Application_Start(object sender, EventArgs e)

github:https://github.com/domaindrivendev/Ahoy 之前文章有介绍在ASP.NET WebAPI 中使用Swagger生成文档,ASP.NET Core 1.0中同样也支持. 依赖包 "dependencies": { "Swashbuckle.SwaggerGen": "6.0.0-rc1-final", "Swashbuckle.SwaggerUi": "6.0.0-rc

Unity项目生成文档 接着上篇文章:为Unity项目生成文档(一) .Net项目可在VS配置XML 我们可以在VS中通过配置来生成xml文件,但是unity的project,就算同样配置了xml文档文件,但运行生成时不会生成这个xml文件 为Unity项目生成文档的讨论 关于这个的讨论可移步: http://forum.unity3d.com/threads/create-documentation-from-source-code.146730/ http://docs.unity3d.co

利用gensim 直接生成文档向量 def gen_d2v_corpus(self, lines): with open("./data/ques2_result.txt", "wb") as fw: for line in lines: fw.write(" ".join(jieba.lcut(line)) + "\n") sents = doc2vec.TaggedLineDocument("./data/que

使用eclipse生成文档(javadoc)主要有三种方法:1,在项目列表中按右键,选择Export(导出),然后在Export(导出)对话框中选择java下的javadoc,提交到下一步.在Javadoc Generation对话框中有两个地方要注意的: 1.需要导入android-sdk-windows\platforms\android-17  android.jar 包2.javadoc command:应该选择jdk的bin/javadoc.exe--(C:\Program Files

一.自动生成注释代码        添加一个快捷键,生成 注释代码        ThisService 下载连接:http://wafflesoftware.net/thisservice/          Doxygen.rb 下载连接:http://www.brokenrul.es/blog/wp-content/uploads/2011/03/Doxygen.rb_.zip   1.打开ThisService,进行以下配置 Name:右键菜单中的名字 Script:将Doxygen.r