node.js自動生成api文件(apidocjs)

夜雨隨風發表於2018-10-23

1 win+R 輸入 cmd 回車 然後進入 nodejs 專案目錄

例如 D:\NodeTest\newApp1

2 用npm安裝 apidoc

直接輸入 npm install apidoc -g按回車

3 開啟專案的 package.json檔案

加入 "apidoc": { "title": "apiDoc在瀏覽器中的標題", "url" : "api.github.com/v1" }

4 給介面新增註釋

例如

/**
* @api {post} /api/User/register 使用者註冊
* @apiDescription 使用者註冊
* @apiName Register
* @apiGroup User
* @apiParam {string} name 使用者名稱
* @apiParam {string} password 密碼
* @apiVersion 1.0.0
*/
複製程式碼

5 生成 apidoc

輸入 apidoc -i api/ -o apidoc/

如果 提示error: Can not read: package.json, please check the format (e.g. missing comma).

說明package.json檔案格式不正確,或者編碼不對,需要改為utf8 無簽名 即可

如果提示 info: Done. 說明生成成功,

開啟專案資料夾 會發現生成新目錄apidoc,雙擊開啟裡面的index.html 即可。

官方地址 apidocjs.com/

參考 blog.csdn.net/soslinken/a…

相關文章