注释查看源代码讨论查看历史

注释

来自 呢图网 的图片

中文名称；注释 外文名称；annotation 读音；zhù shì 又称；本面注，脚注 要求；统一 解释1；对文章的语句、背景进行解释 解释2；程序员给代码添加的文字性说明

注释是指解释字句的文字，也指用文字解释字句。可以是文字符号图片等多种形式。注释，是对书籍或文章的语汇、内容、背景、引文作介绍、评议的文字。

为古书注释开始于先秦时期。中国古代分得较细，分别称之为注、释、传、笺、疏、章句等。包含的内容很广。诸凡字词音义、时间地点、人物事迹、典故出处、时代背景都是注释对象。有脚注、篇末注、夹注等形式。古籍注释列在正文之中，有双行夹注和夹注。现代书籍注释列于正文当页之下，称脚注，亦称本面注；列于文章之后或列于书籍之后者称篇末注。不管采用何种方式，全书注文的编排一般要求统一，以便于读者查考。注释在教科书中应用广泛，是学生学习的重要条件。

现代学术作品中的注释一般分内容解释和来源解释两种。前者多指对文章或书籍中某一部分词句作进一步说明，但为了防止冗杂而把它放在段落之外（文末或页边）。后者一般是为了保障原作者的著作权，注明某此语句、词语、观点的来源，以便读者的查证，另一方面也是为了尊重他人的知识产权和劳动。

汉语词语

解释

1. [note;footnote;annotation]解释字句的文字。

（1）南朝 梁刘勰《文心雕龙·论说》：“若夫注释为词，解散论体，杂文虽异，总会是同。”

（2）唐 刘知几 《史通·补注》：“既而史传小书，人物杂记……文言美辞，列於章句，委曲叙事，存於细书。此之注释，异夫儒士者矣。”

（3）《[[<廖仲恺集>前言]]》：“文中的外国地名、人名，与通用的译名不一致，为保持原貌，未加改动，其中重要的作了简略注释。”

（4）宋严羽 《沧浪诗话·考证》：“旧 蜀 本 杜 诗，并无注释。”

（5）田北湖 《章源流》：“於一一音，有一一说，不达注释，可以达用。”

（6）《[[瞿秋白文集辑委员会《[[<瞿秋白文集>序]]》：“在文集的各部分，编者都曾经加了一些注释。”

2. [annotate;explain with notes]用文字解释字句。

（1）《隋书·文学传·潘徽》：“总会旧辙，创立新意，声别相从，即随注释。”

（2）宋 姚宽 《西溪丛语》卷下：“ 陶潜 《海经》十三首用事，今本多差误，各为注释之。”

（3）明 王鏊 《长语·经传》：“﹝ 朱子 ﹞天文历律度数，无不究悉，仍好为文，工於诗，工於笔札，如《楚词》、 韩 文，亦皆注释。”

（4）《明史·顾鼎臣传》：“进讲 范浚 《心箴》，敷陈剀切。帝悦，乃自为注释，而 鼎臣 特受眷。”

（5）清 昭连 《啸亭杂录·纯庙博雅》：“每一诗出，令儒臣注释，不得原委者，许归家涉猎。”

软道语录

注释是程序员给代码添加的文字性说明，以提高代码的可读性。

作品注释

中文注释的格式

1、当文章引用或借用的资料所在的著作第一次出现于注释中时，须将该书作者姓名、书名、出版地、出版者、出版年代及引用资料所在的页码一并注出。

（1）引用专著例：

李道揆：《美国政府和美国政治》，北京．中国社会科学出版社，1990年版，第72－74页。

说明：

（a）作者姓名后面用冒号；著作名用书名号标出，书名号后加逗号；出版地后用间隔号（中圆点）；出版社名称后加逗号；出版年代后加“版”字，再加逗号；页码后用句号。

（b）著作者如系二人，作者姓名之间用顿号分隔，如：xxx、xxx；如系二人以上，可写出第一作者姓名，后面加“等”字省略其他作者，如：xxx等。

(c）著作名如有副标题，则在书名号内以破折号将标题与副标题隔开。

如：陈宝森：《美国经济与政府政策——从罗斯福到里根》，北京．世界知识出版社，1988年版，第124页。（d）著作如系多卷本，须在书名号后面直接写出引用资料所在的卷数，再加逗号。如：徐民：《抗美援朝的历史回顾》上卷，北京．中国广播出版社，1990年版，第5页。

（e）出版地应包括省、自治区及其下属的市名，直辖市只注市名，如：

吉林延吉．延边教育出版社；北京．国际文化出版公司。如出版社名称本身已含其中某一级地名，则可不必在出版地中重复注出，如：南京．江苏人民出版社，不必注为江苏南京．江苏人民出版社；北京出版社，不必注为北京．北京出版社。

（2）引用译著例：

J．布卢姆等：《美国的历程》下册第二分册（杨国标、张儒林译，黄席群校），北京．商务印书馆，1988年版，第97页。

说明：

（a）作者姓名中除姓（family name）外，名与中间名（first name 和 middle name）均可用缩写形式表示，如缩写，须用英文缩写符号（下圆点）；如将姓名全部译出，则须在姓名之间加中文间隔符号（中圆点）。

（b）书名号后或多卷本著作卷次、册次后直接加圆括号，括号内注明中文译、校者姓名。

（3）引用编著例：

杨生茂主编：《美国外交政策史，1775—1989》，北京．人民出版社，1991年版，第23页。

韩铁等：《战后美国史，1945—1986》（刘绪贻、杨生茂主编），北京．人民出版社，1989年版，第56页。

说明：（a）第一例适用于仅有编者的著作。在编者姓名后，根据该书提供的信息加入“编”或“主编”，再加冒号；其余部分与著作类注释格式同。

（b）第二例适用于既有编者，又有著者的著作。这类注释与著作类注释基本相同，但须在书名号后加圆括号，括号内注明编者姓名，再在括号后加句号。

（4）引用文集或期刊、杂志内文章例：

马克思：《哥达纲领批判》，载《马克思恩格斯选集》第三卷，北京．人民出版社，1972年版，第21页。

弗．杰姆逊：《处于跨国资本主义时代中的第三世界文学》，载《新历史主义与文学批评》（张京媛主编），北京大学出版社，1992年版，第251页。

吴展：《试论核裁军的几个问题》，载《美国研究》1994年第3期，第43页。

说明：（a）先注作者名和篇名，篇名用书名号标出，书名号后加逗号；再注出文集或期刊名，文集或期刊名亦用书名号标出，书名号前加“载”字，紧接文集或期刊书名号后注明卷次、册次，然后加逗号；其余与著作类格式同。

（b）第一例适用于编者未署名的文集；第二例适用于编者署名的文集。

（c）期刊、杂志不必注明编者和出版者。

（5）引用报纸文章例：

陆全武：《国营企业改革中的几个问题》，1994年8月20日《经济日报》，第3版。

《墨西哥股票市场动荡》，1995年1月10日《人民日报》，第7版。

说明：（a）第一例适用于署名文章。

（b）第二例适用于不署名文章或报道。

（c）报纸出版时间须注明：年、月、日，并置于报纸名称前。

（d）报纸不注“页”，而注“版”。

2、当再次引用同一著作中的资料时，注释中只需注出作者姓名、著作名（副标题可省略）和资料所在的页码；如引文出自报刊文章，报刊名称及出版日期则可以“上引报刊”四字代替。

例：李道揆：《美国政府和美国政治》，第79页。

J．布卢姆：《美国的历程》下册第一分册，第140页。

陈宝森：《美国经济与政府政策》，第435页。

吴展：《试论核裁军的几个问题》，上引报刊，第44页。

《墨西哥股票市场动荡》，上引报刊，第7版。

参考来源

注释的添加(1)