單行注釋

單行注釋

注釋(annotation)對書籍或文章的語彙、內容、背景、引文作介紹、評議的文字。為了保障原作者的著作權。中國古代分得較細,分別稱之為注、釋、傳、箋、疏、章句等。現在一般通稱注釋。包含的內容很廣。諸凡字詞音義、時間地點、人物事跡、典故出處、時代背景都是注釋對象。有腳註、篇末注、夾注等形式。古籍注釋列在正文之中,有雙行夾注和夾注。現代書籍注釋列於正文當頁之下,稱腳註,亦稱本面注;列於文章之後或列於書籍之後者稱篇末注。不管採用何種方式,全書注文的編排一般要求統一,以便於讀者查考。

什麼是注釋

格式

1、當文章引用或借用的資料所在的著作第一次出現於注釋中時,須將該書作者姓名、書名、出版地、出版者、出版年代及引用資料所在的頁碼一併注出。

(1)引用專著例:

李道揆:《美國政府和美國政治》,北京.中國社會科學出版社,1990年版,第72-74頁。

說明:(a)作者姓名後面用冒號;著作名用書名號標出,書名號後加逗號;出版地後用間隔號(中圓點);出版社名稱後加逗號;出版年代後加“版”字,再加逗號;頁碼後用句號。

(b)著作者如系二人,作者姓名之間用頓號分隔,如:xxx、xxx;如系二人以上,可寫出第一作者姓名,後面加“等”字省略其他作者,如:xxx等。

(c)著作名如有副標題,則在書名號內以破折號將標題與副標題隔開。

如:

陳寶森:《美國經濟與政府政策——從羅斯福到里根》,北京.世界知識出版社,1988年版,第124頁。(d)著作如系多卷本,須在書名號後面直接寫出引用資料所在的卷數,再加句號。如:徐民:《抗美援朝的歷史回顧》上卷,北京.中國廣播出版社,1990年版,第5頁。

區別

為了程式的可讀性,以及便於日後代碼修改和維護時,更快理解代碼,你可以在 Javascript 程式里為代碼寫注釋(comments)。

在 Javascript 語言裡,用兩個斜槓 // 來表示單行注釋。見例句:

aGoodIdea = "Comment your code thoroughly."; // 這是單行注釋。多行注釋則用 /* 表示開始, */ 表示結束。見例句:

/*這是多行注釋 行一。這是多行注釋 行二。*/

相關詞條

熱門詞條

聯絡我們