摘要:簡介是眾多開源項目中的一個,它是使用編寫的文檔生成器。系統(tǒng)環(huán)境變量,對所有用戶起作用。使用可通過配置,也可通過直接在命令行寫參數(shù)來使用。配置進入項目目錄,配置文件,類似以下的寫法運行命令,即可在文件夾下找到自動生成的文檔。
簡介
jsduck是senchalabs眾多開源項目中的一個,它是使用ruby編寫的 javascript API文檔生成器。不像JSDoc一樣,不按照符合JSDoc的注釋語法來進行注釋的話,可能生成的文檔一個字也沒有,學習曲線較陡。jsduck適合以OOP方式構(gòu)造代碼(如Ext JS是結(jié)構(gòu)化的)的js文件,不適合以功能性風格構(gòu)建代碼(如jQuery)的js文件。
安裝 下載安裝包項目地址:https://github.com/senchalabs...
windows下安裝的話,可在這個地址下載.exe可執(zhí)行文件,將下載后的文件更名為jsduck.exe,放到一個目錄下面。
windows下需要配置環(huán)境變量。環(huán)境變量分為系統(tǒng)環(huán)境變量和用戶環(huán)境變量兩種。系統(tǒng)環(huán)境變量,對所有用戶起作用。而用戶環(huán)境變量只對當前用戶起作用。 我們可配置在用戶環(huán)境變量的path中,也可配置在系統(tǒng)環(huán)境變量的path中。
點擊計算機,右鍵選擇屬性——》高級-》環(huán)境變量,在Path中進行設置。
配置完成,進入dos命令,運行jsduck --help,能出來信息,則表示配置成功。
使用可通過配置jsduck.json,也可通過直接在命令行寫參數(shù)來使用。
配置jsduck.json進入項目目錄,配置jsduck.json文件,類似以下的寫法
運行jsduck命令,即可在dist文件夾下找到自動生成的api文檔。
文章版權(quán)歸作者所有,未經(jīng)允許請勿轉(zhuǎn)載,若此文章存在違規(guī)行為,您可以聯(lián)系管理員刪除。
轉(zhuǎn)載請注明本文地址:http://m.hztianpu.com/yun/91899.html
摘要:語法父類名表示當前類繼承于哪個類的標簽。成員標簽成員標簽作用于類中的配置屬性函數(shù)事件。表明可被子類繼承,和一起使用。示例獲取圓的面積圓的半徑面積值作用于函數(shù),表明函數(shù)的標簽。作用于函數(shù),表明構(gòu)造函數(shù)參數(shù)的標簽,用法同。 字數(shù):3692字 閱讀時間:15分鐘 前言 ? 首先,咱們有一個前提,JSDuck對我們而言只是一個便于API查看的文檔化工具。因此,只要它能夠滿足我們文...
摘要:我們在對現(xiàn)在較主流的五個文檔工具分別作了調(diào)研和嘗試,得到結(jié)論如下工具優(yōu)點缺點提供了完整的模板開發(fā)事件觸發(fā)等接口,使用非常靈活。至此,的環(huán)境部署已經(jīng)全部完成了。 字數(shù):981 閱讀時間:5分鐘 選型依據(jù) ? 在經(jīng)歷了數(shù)個上線的項目之后,筆者所在的團隊已經(jīng)沉淀了一個相對穩(wěn)定版本的前端框架。因此,我們需要出具一套框架API文檔,以便公司其他成員的使用和框架的后期維護。我們在對...
摘要:本文比較了種較為主流的注釋文檔生成工具。應該說是非常適合開源項目多個作者共同維護的一個文檔工具。最后我選擇了作為文檔生成的工具。為了支持多種語言,它僅對注釋塊內(nèi)部的內(nèi)容進行解析。 最近隨著寫Node以及獨立的CommonJS模塊越來越多,我發(fā)現(xiàn)有一份好的文檔不僅可以幫助自己在應用這些接口的時候不至于迷糊,而且對于共同開發(fā)的情況下,能夠省去大量團隊的交流和Debug的時間。 本文比較了...
摘要:融合思路解決這個問題,有兩種思路。給我們帶來了以下新成員模塊服務指令篩選器和控制器。與其他類是通過類的名稱區(qū)分的,名稱統(tǒng)一以結(jié)尾。這種處理方式是一種折中方案,如果想要更加規(guī)范優(yōu)雅的話,建議使用自定義標簽來解決。 字數(shù):1568 閱讀時間:10分鐘 前言 ??前面,我們以一個實戰(zhàn)案例來詳細說明了如何在實際開發(fā)中使用JSDuck工具。但是,并不是所有的時候,代碼的封裝方式都受我們控制的。...
摘要:我們先聲明了類,在類的注釋上添加標簽表示靜態(tài)類。靜態(tài)類中包含一個方法,實現(xiàn)了一個簡單的擴展功能,后面類的繼承需要用到這個接口。這里需要注意,靜態(tài)類中,所有的成員也都是靜態(tài)的。 字數(shù):2543 閱讀時間:15分鐘 前言 ? 上一篇文章我們講述了JSDuck的詳細用法。那么,本文筆者就以實例為基礎(chǔ),和大家一起,從零開始,搭建一個簡單的API文檔——我們的第一個API文檔V0.0.1。...
閱讀 4043·2021-11-24 09:38
閱讀 1344·2021-10-19 11:42
閱讀 1899·2021-10-14 09:42
閱讀 2214·2019-08-30 15:44
閱讀 606·2019-08-30 14:04
閱讀 2958·2019-08-30 13:13
閱讀 2022·2019-08-30 12:51
閱讀 1031·2019-08-30 11:22