showdoc(api文檔工具)

showdoc(api文檔工具)對于it行業的工作者來說相當實用，通過它能夠更加快捷的編寫出精美api技術文檔，使用方法簡單，而且軟件內自帶多種模板，包括api接口模板、數據字典模板等等，新手如果不熟練的話可以先使用模板來練手。

showdoc電腦版介紹：

showdoc就是一個非常適合IT團隊的在線文檔分享工具，它可以加快團隊之間溝通的效率，通過showdoc，你可以方便地使用markdown語法來書寫出美觀的API文檔、數據字典文檔、技術文檔、在線excel文檔等等。

showdoc怎么用？

首先編寫API接口的人員需要注冊一個賬號，便于不同設備的同步管理。

登錄成功后，首先展示的是各項目列表，如果未創建過項目，官方也給出了基本實例。

實例文檔如下，左側是目錄（支持多級目錄），右側主區域為左側所選的接口實際內容，默認展示第一條。

一個基礎的接口示例，接口文檔使用人員需要的時候，只需要將地址欄鏈接復制即可，不登錄的情況下是無法做修改的。

軟件功能：

分享與導出

響應式網頁設計，可將項目文檔分享到電腦或移動設備查看。同時也可以將項目導出成word文件，以便離線瀏覽。

markdown編輯

ShowDoc采用markdown編輯器，無論是編輯還是閱讀體驗都極佳很棒。如果你不了解Markdown，請在搜索引擎搜索”認識與入門 Markdown”。

歷史版本

ShowDoc為頁面提供歷史版本功能，你可以方便地把頁面恢復到之前的版本。

模板插入

在ShowDoc的編輯頁面，點擊編輯器上方的按鈕可方便地插入API接口模板和數據字典模板。插入模板后，剩下的就是改動數據了，省去了很多編輯的力氣。

權限管理：

公開項目與私密項目

ShowDoc上的項目有公開項目和私密項目兩種。公開項目可供任何登錄與非登錄的用戶訪問，而私密項目則需要輸入密碼驗證訪問。密碼由項目創建者設置。

項目轉讓

項目創建者可以自由地把項目轉讓給網站的其他用戶。

團隊管理

你可以自行添加多個團隊，為團隊分配不同的項目，同時設置團隊里每個人的權限。

項目成員

你可以很方便地為ShowDoc的項目添加、刪除項目成員。項目成員可以對項目進行編輯，但不可轉讓或刪除項目（只有項目創建者才有權限）

常見問題：

錯誤提示”General error: 11 database disk image is malformed”？

請確保服務器安裝好了php環境和php-sqlite擴展；如果你以FTP方式上傳代碼到服務器，那么請使用二進制模式上傳，否則會損害數據庫文件，導致此錯誤提示。

驗證碼不顯示？

請檢查是否安裝了php-gd庫。

提示驗證碼驗證失敗？

先到php.ini文件下找找session的保存目錄，然后檢查安裝session目錄有沒有寫入權限，或者可不可能是磁盤空間滿了的問題。

怎么進入管理后臺？

新安裝完成后，默認管理員賬號是showdoc/123456 。使用管理員帳戶登錄后，在項目列表頁面的右上角便能看到管理后臺入口。如果不能，請重新登錄或者刷新瀏覽器緩存試試。

RunApi客戶端打不開或者一直顯示加載中？

runapi需要外網網絡。如果在確保已經有了外網網絡，可以這樣嘗試：首先卸載runapi，然后刪除以下路徑C:\Users\Administrator\AppData\Roaming\runapi（其中Administrator可替換為你當前登錄win系統的賬戶名），然后再重裝runapi。MAC環境的用戶可以考慮使用AppCleaner來卸載和清理數據后再重裝。

RunApi客戶端看不到showdoc的項目？

runapi的數據可以生成markdown格式，但不可逆，markdown數據很難再轉換回來runapi。所以它無法跟showdoc原有數據互相轉換。只是它們可以共用文檔瀏覽/團隊協作等功能。同時runapi生成的文檔只能在runapi上編輯，不能在showdoc上編輯。后面如果要做數據共用，可能需要對showdoc編寫格式有一定的規范約束，這個后面再探索下。