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-x64\dev
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-x64\dev
2 ruby dk.rb install

第三步：安装rdiscount

执行如下批处理程序：

1 gem install rdiscount

第四步：安装jsduck

执行如下批处理程序：

1 gem install jsduck

JSDuck教程

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

备注

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