什么是注释(简介 格式)

区别

什么是注释

简介

注释（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."; // 这是单行注释。多行注释则用 /* 表示开始， */ 表示结束。见例句：

/*这是多行注释 行一。这是多行注释 行二。*/