1. 創(chuàng)建項目

2. 獲取api_key和api_token

1. 打開設(shè)置

2. 獲取api_key和token

3. 生成文檔

1. 先cd進(jìn)入你的項目目錄，命令行模式下輸入：

wget https://www.showdoc.cc/script/showdoc_api.sh

下載完畢，編輯

vi showdoc_api.sh

腳本內(nèi)容的前面有兩個變量，api_key 和 api_token ，這個需要用戶自行填寫。關(guān)于這兩個變量的取值，請登錄showdoc，進(jìn)入某個項目的設(shè)置，點(diǎn)擊開放API，便可以看到說明。showdoc_api.sh生成的文檔會放進(jìn)你填寫的這個項目里。除了api_key 和 api_token ，還有一個url變量。如果是使用www.showdoc.cc ，則不需要修改。如果是使用開源版showdoc，則需要將地址改為http://xx.com/server/index.php?s=/api/open/fromComments ，其中，別忘記了url里含server目錄。

保存文件后。執(zhí)行以下命令，腳本會自動遞歸掃描本目錄和子目錄的所有文本代碼文件，并生成API文檔。

chmod +x showdoc_api.sh

./showdoc_api.sh

3. 文檔注釋規(guī)范

想要生成文檔，需要按照規(guī)范進(jìn)行注釋：

示例：

/**

* showdoc

* @catalog 測試文檔/用戶相關(guān)

* @title 用戶登錄

* @description 用戶登錄的接口

* @method get

* @url https://www.showdoc.cc/home/user/login

* @header token 可選 string 設(shè)備token

* @param username 必選 string 用戶名

* @param password 必選 string 密碼

* @param name 可選 string 用戶昵稱

* @return {"error_code":0,"data":{"uid":"1","username":"12154545","name":"吳系掛","groupid":2,"reg_time":"1436864169","last_login_time":"0"}}

* @return_param groupid int 用戶組id

* @return_param name string 用戶昵稱

* @remark 這里是備注信息

* @number 99

*/

以上示例顯示效果如下：

關(guān)鍵字

關(guān)鍵字

說明

@catalog

生成文檔要放到哪個目錄。如果只是二級目錄，則直接寫目錄名字。如果是三級目錄，而需要寫二級目錄/三級目錄，即用/隔開。如”一層/二層/三層”

@title

表示生成的文檔標(biāo)題

@description

是文檔內(nèi)容中對接口的描述信息

@method

接口請求方式。一般是get或者post

@url

接口URL。不要在URL中使用&符號來傳遞參數(shù)。傳遞參數(shù)請寫在參數(shù)表格中

@header

可選。header說明。一行注釋對應(yīng)著表格的一行。用空格或者tab符號來隔開每一列信息。

@param

參數(shù)表格說明。一行注釋對應(yīng)著表格的一行。用空格或者tab符號來隔開每一列信息。

@json_param

可選。當(dāng)請求參數(shù)是json的時候，可增加此標(biāo)簽。請把json內(nèi)容壓縮在同一行內(nèi)。

@return

返回內(nèi)容。請把返回內(nèi)容壓縮在同一行內(nèi)。如果是json，程序會自動進(jìn)行格式化展示。 如果是非json內(nèi)容，則原樣展示。

@return_param

返回參數(shù)的表格說明。一行注釋對應(yīng)著表格的一行。用空格或者tab符號來隔開每一列信息。

@remark

備注信息

@number

可選。文檔的序號。

總結(jié)

以上是生活随笔為你收集整理的showdoc如何创建文件夹_showDoc生成文档的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。