jsdoc的使用

JSDoc使用指南

1.JSDoc安裝和配置:

JSDoc安裝:使用npm安裝npm install jsdoc –g

JSDoc配置:進(jìn)入JSDoc的安裝目錄找到并修改 conf.json.EXAMPLE``進(jìn)行自定義配置纯命,也可以不做修改使用默認(rèn)配置

2.JSDoc注釋文檔編輯:

格式: /**

               * @標(biāo)簽 文檔內(nèi)容

               */

常用功能標(biāo)簽:

       desc/description 描述方法漂羊、變量甸各,放在第一排可省略

       method/function   方法名

       param    參數(shù)马靠,可定義類型

       property    屬性蛹锰,可定義類型

       return  方法返回值薄坏,可定義類型

       todo 描述函數(shù)的功能

       global   表示變量是否是全局

       constructs 表明是構(gòu)造函數(shù)

       default  默認(rèn)值

       alias  別名

       event  事件

       example  示例

       type   變量類型

       module   標(biāo)明當(dāng)前文檔模塊

文檔信息標(biāo)簽

       version   版本信息

       author   作者

       license   開(kāi)源協(xié)議

       link   鏈接

3.生成文檔文件

使用cmd進(jìn)入當(dāng)前項(xiàng)目文件迈倍,輸入命令:jsdoc 文件相對(duì)路徑.js

(注意追城,默認(rèn)配置下,輸入文檔必須是js類型不能是html類型)

回車后故觅,在當(dāng)前項(xiàng)目文件根目錄下會(huì)生成一個(gè)out文件夾厂庇,里面有3個(gè)文件夾fonts、scripts输吏、styles分別是生成文檔的字體权旷、腳本和css樣式,根目錄下的html文檔文件就是JSDoc文檔。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末贯溅,一起剝皮案震驚了整個(gè)濱河市拄氯,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌它浅,老刑警劉巖译柏,帶你破解...
    沈念sama閱讀 206,839評(píng)論 6 482
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異姐霍,居然都是意外死亡鄙麦,警方通過(guò)查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,543評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門镊折,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)胯府,“玉大人,你說(shuō)我怎么就攤上這事恨胚÷钜颍” “怎么了?”我有些...
    開(kāi)封第一講書(shū)人閱讀 153,116評(píng)論 0 344
  • 文/不壞的土叔 我叫張陵赃泡,是天一觀的道長(zhǎng)寒波。 經(jīng)常有香客問(wèn)我,道長(zhǎng)升熊,這世上最難降的妖魔是什么影所? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 55,371評(píng)論 1 279
  • 正文 為了忘掉前任,我火速辦了婚禮僚碎,結(jié)果婚禮上猴娩,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好卷中,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,384評(píng)論 5 374
  • 文/花漫 我一把揭開(kāi)白布矛双。 她就那樣靜靜地躺著,像睡著了一般蟆豫。 火紅的嫁衣襯著肌膚如雪议忽。 梳的紋絲不亂的頭發(fā)上,一...
    開(kāi)封第一講書(shū)人閱讀 49,111評(píng)論 1 285
  • 那天十减,我揣著相機(jī)與錄音栈幸,去河邊找鬼。 笑死帮辟,一個(gè)胖子當(dāng)著我的面吹牛速址,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播由驹,決...
    沈念sama閱讀 38,416評(píng)論 3 400
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼芍锚,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來(lái)了蔓榄?” 一聲冷哼從身側(cè)響起并炮,我...
    開(kāi)封第一講書(shū)人閱讀 37,053評(píng)論 0 259
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎甥郑,沒(méi)想到半個(gè)月后逃魄,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 43,558評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡澜搅,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,007評(píng)論 2 325
  • 正文 我和宋清朗相戀三年伍俘,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片店展。...
    茶點(diǎn)故事閱讀 38,117評(píng)論 1 334
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡养篓,死狀恐怖秃流,靈堂內(nèi)的尸體忽然破棺而出赂蕴,到底是詐尸還是另有隱情棋凳,我是刑警寧澤卿堂,帶...
    沈念sama閱讀 33,756評(píng)論 4 324
  • 正文 年R本政府宣布,位于F島的核電站震缭,受9級(jí)特大地震影響嚣伐,放射性物質(zhì)發(fā)生泄漏糖赔。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,324評(píng)論 3 307
  • 文/蒙蒙 一轩端、第九天 我趴在偏房一處隱蔽的房頂上張望放典。 院中可真熱鬧,春花似錦、人聲如沸奋构。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 30,315評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)弥臼。三九已至宴咧,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間径缅,已是汗流浹背掺栅。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 31,539評(píng)論 1 262
  • 我被黑心中介騙來(lái)泰國(guó)打工, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留纳猪,地道東北人氧卧。 一個(gè)月前我還...
    沈念sama閱讀 45,578評(píng)論 2 355
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像兆旬,于是被迫代替她去往敵國(guó)和親假抄。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,877評(píng)論 2 345

推薦閱讀更多精彩內(nèi)容

  • 最近要為公司項(xiàng)目做javaScript API丽猬,在網(wǎng)上找了幾個(gè)生成工具宿饱,JSDoc和YUIDoc好像很不錯(cuò)。我選用...
    ANoman_M閱讀 8,218評(píng)論 0 3
  • 1 Webpack 1.1 概念簡(jiǎn)介 1.1.1 WebPack是什么 1脚祟、一個(gè)打包工具 2谬以、一個(gè)模塊加載工具 3...
    Kevin_Junbaozi閱讀 6,638評(píng)論 0 16
  • 第一部分 HTML&CSS整理答案 1. 什么是HTML5? 答:HTML5是最新的HTML標(biāo)準(zhǔn)由桌。 注意:講述HT...
    kismetajun閱讀 27,423評(píng)論 1 45
  • Node.js第一天 1. 初識(shí)Node.js 1.1 Node.js是什么 Node.js? is a Java...
    再見(jiàn)天才閱讀 4,713評(píng)論 1 24
  • 2017行您,這一年 這一年铭乾,一切順利諸事平安 這一年,司法改革掀起波瀾 人員分類娃循,我還是人民的檢察官 機(jī)關(guān)轉(zhuǎn)隸炕檩,似乎...
    高慧_閱讀 150評(píng)論 0 1