注释的类型
中文注释的格式
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、当首次引用一本著作的资料时,注释中须将该书的作者姓名、书名、出版地、出版者、出版年代及资料所在页码顺序注明。具体格式如下:
(1)专著类:
Harold U. Faulkner, American Economic History (New York: Harper & Brothers Publishers, 1960), pp.23-25.
说明:(a)作者姓名按通常顺序排列,后面加逗号;书名用斜体,手稿中可在书名下用横线标出;书名后紧接圆括号,括号内注出版地,加冒号,后接出版者名称,再加逗号,然后注出版年代;括号后面加逗号,再注出引用资料所在的页码,页码后加句号表示注释完毕;单页页码用 p.表示;多页页码用pp.表示,意为pages。(b)作者如系二人,作者姓名之间用and或& 连接;如系二人以上,可写出第一作者姓名,后面加et al.表示and others,如:Donna Worrall Brown et al., Form in Modern English,其余与(a)同。(c)著作名如有副标题,则以冒号将其与标题隔开,如:Robert K.Murray, The Harding Era: Warren G. Harding and His Administration (Minneapolis: University of Minnesota Press, 1969), p.91.(d)著作如系多卷本中的一卷,须在注明页码前,用Vol.加罗马数字标明卷数,如:Ralph F. de Bedts, Recent American History: 1945 to the Present,Vol.II (Illinois: Dorsey Press, 1973), p.169.
(2)编著类:
Paul M. Angle, ed., The American Reader: From ColumbustoToday (New York: Rand McNally Co.,1958), pp.52-53.
说明:(a)如编者系多人,则须将ed.写成eds.,如:E. B. White & Katherine S. White, eds.,A Subtreasury of American Humor,后面的注释内容与著作类同。(b)既有编者又有著者的著作,须将著者姓名置于书名前,编者姓名置于书名后,如:George Soule, Prosperity Decade: From War to Depression, 1917-1929 (eds. Henry David et al., New York: M. E. Sharpe, Inc., 1975), p.235.亦可不注编者,按著作类注释处理。
(3)文集内文章:
Erwin Panofsky, “Style and Medium in the Motion Picture,” Problems in Aesthelics, ed. Morris Weitz (New York: Harcourt, Brace and World, Inc., 1969), p.326.
说明:(a)文章名不用斜体或划线,与其后的逗号均置于引号内。(b)书名采用斜体,后面注出编者姓名,格式与编著类(b)相同。
(4)报刊文章类:
Constance M. Drake, “An Approach to Blake,” College English, XXIX (April 1968), pp.541-543.
“Reading Teachers Put on Spot,” The Kansas City Star, May 1, 1969, p.16 A.
说明:(a)第一例为引用期刊中署名文章的注释,期刊名称用斜体,卷号须用罗马数字标明,然后在圆括号内注出版日期;不必注编者、出版者和出版地。(b)第二例为引用报纸中不署名文章的注释,报纸名称用斜体,后面注出版日期。
(5)电子信息类:
如使用因特网上的资料,须注明资料所在站点详细地址:
2、再次引用已引用过的著作时,注释格式如下:
(1)仅注出作者姓名、页码即可,如:
Soule, p.229.
E. White & K. White, eds., p.45.
(2)如在一篇文章中,引用了同一作者的两本(篇)或两本(篇)以上的著作,则须加注书名,
如:Soule, Prosperity Decade, p.134.
(3)本注与紧邻之上注所引资料出于同一著作,可以ibid.代替,意为“引书同上”或“出处同上”(如本注所引著作并非与紧邻之上注、而是与间隔之上注相同,则不可用ibid.代替),如:
③Harold U. Faulkner, American Economic History (New York: Harper & Brothers Publishers, 1960), pp.23-25.
④Ibid., p.51(意为与注释③引书相同,页码不同)
⑤Ibid.(意为与注释④引书及页码都相同) 注释就是对代码的解释和说明。目的是为了让别人和自己很容易看懂。为了让别人一看就知道这段代码是做什么用的。正确的程序注释一般包括序言性注释和功能性注释。序言性注释的主要内容包括模块的接口、数据的描述和模块的功能。模块的功能性注释的主要内容包括程序段的功能、语句的功能和数据的状态。
行注释
在符号后那一行不会被编译(显示)
块注释
被块注释符号中间的部分不会被编译
jsp 注释 块注释
HTML 注释 块注释
<!-- -->
asp 注释 ' 行注释
css 注释 块注释
/* */ 块注释
java 注释 // 行注释
/* */ 块注释
/** */ 块注释,中间通常代码信息、比如作者姓名等
c++ 注释 // 行注释
/* */ 块注释
批处理脚本注释 REM(不区分大小写) 行注释
例如下面是C++的注释简单例子
/*
代码作用
在屏幕上输出百度百科!
*/ #include<iostream> /*#包含<iostream>头文件*/using namespace std;/*使用命名空间 标准库*/int main() /*整数类型 “主” (函数)*/{ cout << 百度百科!; /*c输出<< 百度百科!;*/}php注释
在 PHP 中,我们使用 // 来编写单行注释,或者使用 /* 和 */ 来编写大的注释块。
<html>
<body>
<?php
//This is a comment
/*This isa commentblock*/
?>
</body>
</html>
php 支持 C,C++ 和 Unix Shell 风格(Perl 风格)的注释。例如:
<?php echo This is a test; // This is a one-line c++ style comment /* This is a multi line comment yet another line of comment */ echo This is yet another test; echo One Final Test; # This is shell-style style comment ?>
单行注释仅仅注释到行末或者当前的 php 代码块,视乎哪个首先出现。这意味着在 // ?> 之后的 HTML 代码将被显示出来:?> 跳出了 php 模式并返回了 HTML 模式,// 并不能影响到这一点。如果启用了 asp_tags 配置选项,其行为和 // %> 相同。不过,</script> 标记在单行注释中不会跳出 php 模式。
<h1>This is an <?php # echo simple;?> example.</h1> <p>The header above will say 'This is an example'.
cad中的注释概述
注释是说明或其他类型的说明性符号或对象,通常用于向图形中添加信息。
注释样例包括
说明和标签
、表格 、标注和公差 、图案填充 、标注 、块 用于创建注释的对象类型包括
图案填充 、文字(单行和多行) 、表格 、标注 、公差 、引线和多重引线 、块 、属性等,
用户可以在不同的布局视口和模型空间中自动完成缩放注释的过程。
1.缩放注释
通常用于注释图形的对象有一个特性称为注释性。使用此特性,用户可以自动完成缩放注释的过程,从而使注释能够以正确的大小在图纸上打印或显示。
2.设置注释比例
注释比例是与模型空间、布局视口和模型视图一起保存的设置。将注释性对象添加到图形中时,它们将支持当前的注释比例,根据该比例设置进行缩放,并自动以正确的大小显示在模型空间中。
3.创建注释性对象
通常用于注释图形的对象有一个特性称为注释性。如果这些对象的注释性特性处于启用状态(设置为“是”),则其称为注释性对象
4.显示注释性对象
对于模型空间或布局视口,用户可以显示所有的注释性对象,或仅显示那些支持当前注释比例的对象。
5.添加和修改比例图示
在图形中创建 注释性 对象后,它支持一个 注释比例,即创建该对象时的当前注释比例。用户可以更新注释性对象,以支持其他注释比例。
注释和标签概述
可以使用多种方法创建文字。对简短的输入项使用单行文字。对带有内部格式的较长的输入项使用多行文字(也称为多行文字)。也可创建带有引线的多行文字。
虽然所有输入的文字都使用建立了默认字体和格式设置的当前文字样式,但也可以使用其他的方法自定义文字外观。有一些工具可以方便用户修改文字比例和对正、查找和替换文字以及检查拼写错误。
包含在标注或公差中的文字是使用标注命令创建的。
脚本语言的注释格式
JavaScript 单行注释
可以添加注释来对 JavaScript 进行解释,或者提高其可读性。
单行的注释以
// 开始。
本例用单行注释来解释代码:
<script type=text/javascript>
// 这行代码输出标题:document.write(<h1>This is a header</h1>);// 这行代码输出段落:document.write(<p>This is a paragraph</p>);
document.write(<p>This is another paragraph</p>);
</script>
JavaScript 多行注释
多行注释以 /* 开头,以 */ 结尾。
本例使用多行注释来解释代码:
<script type=text/javascript> /*下面的代码将输出一个标题和两个段落*/ document.write(<h1>This is a header</h1>); document.write(<p>This is a paragraph</p>); document.write(<p>This is another paragraph</p>); </script>
使用注释来防止执行
在本例中,我们用注释来阻止一行代码的执行:
<script type=text/javascript>
document.write(<h1>This is a header</h1>);
document.write(<p>This is a paragraph</p>);
document.write(<p>This is another paragraph</p>);
</script>
在本例中,我们用注释来阻止若干行代码的执行:
<script type=text/javascript>
/*document.write(<h1>This is a header</h1>);document.write(<p>This is a paragraph</p>);document.write(<p>This is another paragraph</p>);*/
</script>
在行末使用注释
在本例中,注释放置在语句的行末:
<script type=text/javascript>
document.write(Hello); // 输出 Hello document.write(World); // 输出 World
</script>