• Javascript:前端利器 之 JSDuck


    背景

    文档的重要性不言而喻,对于像Javascript这种的动态语言来说就更重要了,目前流行的JDoc工具挺多的,最好的当属JSDuck,可是JSDuck在Windows下的安装非常麻烦,这里就写下来做个备忘。

    JSDuck生成的文档效果

    JSDuck安装步骤

    第一步:安装Ruby

    Ruby下载地址:http://rubyinstaller.org/downloads/

    我是64位操作系统,下载的文件如下:

    第二步:安装Development Kit

    1、将DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe解压到指定目录,下图是我解压后的位置:

    2、使用批处理程序生成config.yml,下面是使用的批处理程序:

    1 cd /d D:Ruby200-x64dev
    2 ruby dk.rb init

    3、修改config.yml的内容:

     1 # This configuration file contains the absolute path locations of all
     2 # installed Rubies to be enhanced to work with the DevKit. This config
     3 # file is generated by the 'ruby dk.rb init' step and may be modified
     4 # before running the 'ruby dk.rb install' step. To include any installed
     5 # Rubies that were not automagically discovered, simply add a line below
     6 # the triple hyphens with the absolute path to the Ruby root directory.
     7 #
     8 # Example:
     9 #
    10 # ---
    11 # - C:/ruby19trunk
    12 # - C:/ruby192dev
    13 #
    14 ---
    15 - D:Ruby200-x64

    4、使用批处理执行安装,下面是使用的批处理程序:

    1 cd /d D:Ruby200-x64dev
    2 ruby dk.rb install

    第三步:安装rdiscount

    执行如下批处理程序:

    1 gem install rdiscount

    第四步:安装jsduck

    执行如下批处理程序:

    1 gem install jsduck

    JSDuck教程

    官方永远是最好的学习地方:https://github.com/senchalabs/jsduck/wiki

    备注

    写文档是个好习惯,当然我也相信好代码是最好的文档。

  • 相关阅读:
    XOR linked list
    Doubly Linked List&DLL(双向链表)
    circular linked list&CLL(循环链表)
    Linked list(单链表)
    malloc() & free()
    Mysql 1045
    DoublePointer (**)
    java.sql.SQLException: Operation not allowed after ResultSet closed
    Array
    java-方法
  • 原文地址:https://www.cnblogs.com/happyframework/p/3226667.html
Copyright © 2020-2023  润新知