Codo - Coffeescript的文档生成工具

CODO

概述

  • Codo就是相对javascript的jsdoc,codo是coffeescript的文档生成工具。(真绕口..)
  • 以前并没有太在意文档,随着能力提升,发现开发文档是有多么的重要,真的很重要!
  • 那么介绍就到这里吧!

例子

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
# 这是一个用来造人的类
#
# @example 演示怎么造一个人
# jason = new Human 'jason', '男'
#
# @todo 下次进化就增加更多的实例方法
#
class Human
# 默认有头
@head = true

# 默认有身体
@body = true

# 默认有四肢
@limbs = true

# 构造一个人出来
#
# @param name [String] 姓名
# @param sex [String] 性别
# @param birthDate [Date] 生日
#
constructor: (@name, @sex, @birthDate = Date.now()) ->

# 会说话
#
# @example 默认说中文
# jason.talk '大家好,我是jason,我中国人,中文名?我没有哦!'
#
# @param word [String] 要说的话
# @param language [Object] 语言
# @option language [String] country 国家
# @option language [String] localism 口音
# @return [String] word
#
talk: (word, language = {country: 'cn', localism: 'normal'}) ->
return word

使用方法

CODO

是的,并不麻烦,以上的方式会自动在当前目录下寻找.coffee文件,然后生成文档,更多的参数可以查看文档。

生成结果

CODO

结语

遗憾的是目前没有找到构建工具gulp对应的插件,如果有的真的太方便了。


技术: coffeescript
时间: 2014年9月
参考: codo
博客: think2011