文档生成器

deno doc 将处理一个或一组源文件,为每个模块的导出成员打印出 JSDoc 文档。

目前只支持两种导出声明:

  • export <declaration>
  • export ... from ...

例如,对于这样的一个文件 add.ts

  1. /**
  2. * Adds x and y.
  3. * @param {number} x
  4. * @param {number} y
  5. * @returns {number} Sum of x and y
  6. */
  7. export function add(x: number, y: number): number {
  8. return x + y;
  9. }

运行 Deno doc 命令,把该函数的 JSDoc 注释打印到 stdout

  1. deno doc add.ts
  2. function add(x: number, y: number): number
  3. Adds x and y. @param {number} x @param {number} y @returns {number} Sum of x and y

使用 --json 选项,用 JSON 格式输出文档。该格式在 deno doc website 使用,用以生成模块文档。