鍍金池/ 問答/網(wǎng)絡安全  HTML/ 一些框架和庫的API文檔是怎么生成的

一些框架和庫的API文檔是怎么生成的

一些框架和庫的API文檔是怎么生成的?

最近要做一個sdkapi文檔,不知道怎么搞,文檔有快速入門,教程,還有具體得API文檔,加起來有500篇以上的內容,不可能一個個手寫吧。請問有沒有人知道類似一些框架和庫是怎么生成管理的,比如VUEreact這些官方文檔是怎么做的,有沒有具體的框架或庫,還請?zhí)峁﹤€大致的思路。自己研究了半天沒研究明白。

回答
編輯回答
舊城人
2017年9月4日 10:55
編輯回答
逗婦惱

api的文檔一般是寫在代碼注釋中的,按照規(guī)定的格式寫,然后通過相應的工具轉換成文檔.
其他教程之類,就要自己寫了.當然,這些可以找現(xiàn)成的進行修改,沒必要完全從頭寫,至少結構上不用自己重寫

2018年7月26日 00:52
編輯回答
尐飯團

gitbook 了解一下。

2018年9月14日 14:56
編輯回答
柚稚

js庫的文檔一般都是自己寫的,很少有使用注釋自動生成。
java后端的文檔一般都是通過注釋或者log自動生成。

2017年9月29日 11:37
編輯回答
淡墨

Sphinx可以自動獲取代碼中的docstring注釋,自動生成文檔

2018年2月5日 20:05
編輯回答
來守候

文檔內容肯定是手寫的

2018年1月21日 22:52
編輯回答
尐懶貓

目前用的是

http://apidocjs.com
2017年4月21日 02:51
編輯回答
空白格
  • 文檔內容肯定是手寫的,不管是注釋、md 還是別的什么,都是手寫
  • 生成的網(wǎng)站這個過程是可以借助框架的,比如 jsdoc,tsdoc 等等
  • 如果是帶類型的語言,比如 typescript,不寫任何內容的話,可以生成一個類型參考網(wǎng)站,不過比較生硬,僅供內部使用還是可以的,像快速入門、教程這種,還是手寫,我一般就是直接建個 docs 文件夾目錄,用 md 寫
2017年1月22日 15:00