Docco文档生成器

Docco 是一个应急用的文档生成器。使用 Literate CoffeeScript 编写。可生成 HTML 文档来显示你在代码中的注释。使用 Markdown 语法，代码通过 Pygments 语法高亮。

文档生成功能

通过复制静态代码，读取所有源文件，将它们分成注释 + 代码两个部分，用适当的语言突出显示每个文件并在 HTML 模板中将它们打印出来，来为我们配置的源文件生成文档。

document = (options = {}, callback) ->

  config = configure options



  fs.mkdirs config.output, ->



    callback or= (error) -> throw error if error

    copyAsset  = (file, callback) ->

      return callback() unless fs.existsSync file

      fs.copy file, path.join(config.output, path.basename(file)), callback

    complete   = ->

      copyAsset config.css, (error) ->

        return callback error if error

        return copyAsset config.public, callback if fs.existsSync config.public

        callback()



    files = config.sources.slice()



    nextFile = ->

      source = files.shift()

      fs.readFile source, (error, buffer) ->

        return callback error if error



        code = buffer.toString()

        sections = parse source, code, config

        format source, sections, config

        write source, sections, config

        if files.length then nextFile() else complete()



    nextFile()

更多详情请查看软件文档