使用ShowDoc在線管理API接口文檔


ShowDoc是什么

每當接手一個他人開發好的模塊或者項目,看着那些沒有寫注釋的代碼,我們都無比抓狂。文檔呢?!文檔呢?!Show me the doc !!

ShowDoc就是一個非常適合IT團隊的在線文檔分享工具,它可以加快團隊之間溝通的效率。

它可以用來做什么

它可以用來非常方便快速地編寫出美觀的API文檔。

它可以用來記錄數據表結構,一份好的數據字典可以很方便地向別人說明你的數據庫結構,如各個字段的釋義等。

它還可以用來編寫一些工具的說明書,也可以編寫一些技術規范說明文檔以供團隊查閱。

另外它還支持文檔的分享與導出,默認使用markdown編輯以及模板插入,極大的提高工作效率。

安裝

先cd進入運行web的目錄,如/var/www/html/。執行以下命令:

composer create-project  showdoc/showdoc

隨后web目錄下會出現一個showdoc文件夾。

通過瀏覽器訪問http://xxx.com/showdoc/install (請將網址更改為你服務器域名或ip) 便可執行ShowDoc的初始化。

(請確保install 目錄、server/Application/Runtime、Application/Common/Conf/config.php、Application/Home/Conf/config.php、/Application/Runtime 、 /Public/Uploads 、 /Sqlite 、 /Sqlite/showdoc.db.php 有可寫權限)

如果你想安裝到域名的根目錄,請自行移動文件夾,或者設置apache/nginx綁定域名到showdoc目錄。

安裝成功之后就可以在線管理API文檔了

API實例:

數據庫結構實例:

更多查看文檔請查看ShowDoc官網


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM