• API文档生成 -JS


    前言

    上一篇写了关于C#中类和方法的帮助文档生成,本篇介绍JS的文档生成。

    这是JS文档生成的效果图:

    一、需要用到的工具:

    1、jdk,因为js的这个文档生成工具是用JAVA写的,所以需要有JAVA环境,JDK的安装和配置简单介绍如下:

    下载链接在文末!

    JAVA系统环境的配置:

    配置环境变量:右击“我的电脑”-->"高级"-->"环境变量"

    1)、在系统变量里新建JAVA_HOME变量,变量值为:C:Program FilesJavajdk1.6.0_14(根据自己的安装路径填写)

    2)、新建classpath变量,变量值为:.;%JAVA_HOME%lib;%JAVA_HOME%lib ools.jar

    3)、在path变量(已存在不用新建)添加变量值:%JAVA_HOME%in;%JAVA_HOME%jrein(注意变量值之间用“;”隔开)

    4)、“开始”-->“运行”-->输入“javac”-->"Enter",如果能正常打印用法说明配置成功!

    2、jsdoc_toolkit

    使用到的工具叫jsdoc_toolkit,下载链接在文末,下载后解压即可使用。

    3、js文档生成

    java -jar jsrun.jar app/run.js -a -e=GB18030 -t=templates/jsdoc src/*.js 

    通过命令行执行上面语句,也可以在jsdoc_toolkit解压目录下将上述语句保存批处理文件,这样执行更方便。

    上述语句参数说明如下:

    -a 表示全部的方法
    -e 表示对应的文件的编码根式 这里对应的是GB18030 默认的是utf-8
    -t  表示生产doc的文档样式模板
    这里的src/*.js表示在test目录下的全部javascript文件
    执行完毕后将文档结果默认输出到/out/jsdoc目录下。

    二、JS注释规范

    注释以/**开头,以*/结束,关键字以@开头

     三、工具包

    链接:https://pan.baidu.com/s/1c5NnhhHAqdp40pOR5ZY84g
    提取码:bkrm

  • 相关阅读:
    linux开机启动服务的修改与查看
    我从百度来30万IP的经验
    JavaScript静态页面值传递之Cookie篇
    采用HttpModules来重写URLs(实践篇)
    JavaScript,5种调用函数的方法
    [JS]详尽解析window.event对象
    mysql锁定单个表的方法
    mysql常见错误提示及解决方法
    浏览器Chrome 3.0.195.21 Final
    svn windows和linux安装笔记
  • 原文地址:https://www.cnblogs.com/Alenliu/p/15141031.html
Copyright © 2020-2023  润新知