近代史研究注释规范
关于《近代史研究》若干技术处理的规定
一、数字的用法
（一）总的原则
凡是可以使用阿拉伯数字而且又很得体的地方，均应使用阿拉伯数字。遇特殊情况可以灵活变通，但应保持相对统一。
（二）应当使用阿拉伯数字的情况
1.公历世纪、年代、年、月、日、时刻。
例：公元前8世纪20世纪30年代1946年2月1日9时30分36秒、道光年间（1821—1850）
1．1 年份不应简写：如：1940年不应简作“四○年”或“40年”，1930—1935年不应简作“1930—35年”。
1．2 中华民国纪年和日本年号纪年使用阿拉伯数字，如：民国38年（1949）、昭和16年（1941）；1949年10月1日以后中国纪年统一使用公历。
2．物理量值必须使用阿拉伯数字；非物理量值一般情况下应使用阿拉伯数字（同一篇文章应统一）。
例：876千米600克45万元48岁11个月30名
2．1 百分数不能简写，如30%-60%不能写作30-60%。
2．2 4位和4位以上的数字不分节；5位以上的数字，尾数零多的（需表明精确度的除外），可改写为以万、亿作单位的数。一般情况下不得以十、百、千、十万、百万、千万、十亿、百亿、千亿作单位，如：345000000吨，可改写为3.45亿吨或34500万吨，不能写作3亿4500万吨或3亿4千5百万吨；用阿拉伯数字书写的数值不应断开移行。
(三)应当使用汉字的情况
1.定型的词、词组、成语、惯用语、缩略语或具有修辞色彩的词语中作为语素的数字，必须用汉字。
例：八国联军二○九师第四方面军二万五千里长征五四运动十月十七日同盟相差十万八千里七届二中全会
2．中国干支纪年和夏历年月。
例：丙寅年十月十五日正月初五
3．清代和清代以前的历史纪年、各民族的非公历纪年。
例：天平天国庚申十年九月二十四日（清咸丰十年九月二十日，1860年11月2日）藏历阳木龙年八月二十六日（1964年10月1日）
4．含有日月简称，表示事件、节日和其他意义的词组（如果涉及一月、十一月、十二月，应用间隔号“·”将表示月和日的数字隔开，数字部分用引号标示）。
例：五卅运动九一八事变五一国际劳动节“一·二八”事件“一二·九”运动“一·一七”批示
5．概数和约数。
（1）相邻的两个数字并列使用表示概数，须用汉字，连用的两个数字之间不必用顿号隔开。
例：二三米一两个小时一二十个四十五六岁
（2）带有“几”字的数字表示约数，必须用汉字。
例：几千年十几天几十万分之一一百几十次
（3）用“多”、“余”、“左右”、“上下”、“约”等表示的约数一般用阿拉伯数字。
例：在去沧州的道路上，分布着大小不一的村落。一个名叫马营的村共25户，仔村仅3户，又有400余户的大村名王墟祠。
二、标点符号的用法
（一）括号
1．解释、说明，用（）。
例1：“鲁（涤平）率部走平（江）、浏（阳），后入江西。”
例2：例：《统一语言说》（佚名），《中外日报》，1906年9月23日，第1版。
2．补充缺字，用［］。
例1：“今与湘何键、滇卢汉面订计划，决于本［月］底湘滇兵力集中桂边。”
3．标明衍字,用〈〉。
例1：“它底基础一天巩固〈了〉一天，它底势力一天强盛一天……”
4．改正错误,用〔〕。
例1：“帝国主义对于它底势力一天寒〔害〕怕一天。”
5．注明国别，用〔〕。
例1：〔美〕费正清：《美国与中国》……
（二）注释号与标点符号的顺序
1．注释号与逗号、分号、顿号等句内标点符号的顺序：一律注释号在前。
例1：早在1930年就有人提出，如何使中国“别出机枢，卓然有以自立”①，应当成为中国社会科学者努力的方向。
例2：光绪二十四年七月底，光绪帝已有心要安置康有为、梁启超①；康有为一派也大发其攻势。
2．注释号与句号、问号、叹号、删节号等句末标点符号的顺序：一律注释号在后。
例1：孙中山迫于此种形势，也不得不向袁世凯表示“暂时承乏，而虚位以待”。①
例2：金毓黻读皮锡瑞《经学历史》，感悟道：“皮鹿门……只知实事求是，不知有门户之争，是最可师法者矣！”①
三、注释规格
（一）原则与要求
1. 注释一律采用脚注，全文连续编码，不用尾注。
2. 每一条注都要有独立的注文，不得将散在各处、出处相同的注合并标注，亦不用“同上”、“同注①”等注法。
3. 一个自然段的引文引自同一出处，在该自然段的最后一并标注出处。连续几个自然段
的引文引自同一出处，在每个自然段的最后标注出处；也可以在第一自然段最后的注释中注明：“本段及以下几段均出自……”。
（二）注释方法
1．普通图书。
标注的项目及顺序为：①责任者姓名与责任性质；②书名；③卷册数；④出版信息；⑤页码。
（1）责任者及责任性质。如果是撰著，在姓名后直接加冒号，如果是编、校注等其他形式，需在姓名后加编、校注等字样；责任性质不同的责任者，中间用逗号隔开；责任性质相同的两个或三个责任者，中间用顿号隔开；有三个以上责任者时，只取第一责任者名字，其后加一“等”字。责任者为机构、团体等时，表示方法与个人责任者同。外文著作的中译本须标明原著者的国别，用斜角括号〔〕表示，置于作者姓名前，翻译者作为第二责任者置于作者姓名之后；再次征引同一著作时，省去作者国别和译者。
例1：胡绳：《从鸦片战争到五四运动》上，上海人民出版社1982年版，第45页。
例2：朱维铮主编，李天纲、陆永玲、廖梅编校：《马相伯集》，复旦大学出版社1996年版，第33页。
例3：丁名楠等：《帝国主义侵华史》第1卷，人民出版社1986年版。（说明：原版权页题作者名为：丁名楠、余绳武、张振鵾、沈自敏、李明仁、贾维诚、康右铭著）
例4．1：〔法〕A.施阿兰著，袁传璋、郑永慧译：《使华记（1893—1897）》，商务印书馆1989年版，第3页。
例4．2：A.施阿兰：《使华记（1893—1897）》，第5页。
（2）书名。书名内又含有书名，用单书名号标识；书名中有补充说明时间范围的文字，应放在书名号内；著作含有副题，在首次出现时应与正题一并标注，之后可省略副题；如书名较长，可在首次标注时加括注给出省略名称；不采用“前引书”的标注方式。
例1：戴裔煊：《〈明史·佛郎机传〉笺正》，中国社会科学出版社1984年版，第10页。
例2: 徐鼎新、钱小明：《上海总商会史（1902—1929）》，上海社会科学院出版社1991年版，第135页。
例3.1：桑兵：《国学与汉学——近代中外学界交往录》，浙江人民出版社1997年版，第6页。
例3.2：桑兵：《国学与汉学》，第10页。〔〕
例4：〔美〕谢伟思著，王益等译：《美国对华政策（1944—1945）：“美亚文件”和美中关系史上的若干问题》（以下简称《美国对华政策》），中国社会科学出版社1989年版，第7页。
（3）卷册。部分图书的卷册后还有补充说明的文字，可以用括注的形式表示。
例：曹树基：《中国人口史》第4卷（明时期），复旦大学出版社2000年版，第9页。
（4）出版信息。①同一著作含不同卷册，每一卷册第一次征引时均需注明出版者及出版时间。再次征引同一著作的同一卷册时，省去出版信息。②港澳台地区及国外出版的图书应标明出版地点。③影印版的图书要标明是影印版。④出版者及出版时间不完整时，须将所缺项目说明。
例1.1：丁名楠等：《帝国主义侵华史》第1卷，人民出版社1986年版，第5页。
例1.2：丁名楠等：《帝国主义侵华史》第1卷，第8页。
例2.1：丁名楠等：《帝国主义侵华史》第2卷，人民出版社1986年版，第20页。
例2.2：丁名楠等：《帝国主义侵华史》第2卷，第15页。
例3：刘寿林编：《辛亥以后十七年职官年表》，台北，文海出版社1974年影印版，第3页。例4：冯玉祥：《我的读书生活》，三户图书刊行社，出版时间不详，第12页。
2.析出文献。
（1）文章。标注的基本项目和顺序为：①作者姓名；②篇名；③编者姓名，如与文章作者为同一人，可略去；④书名；⑤卷册数；⑥出版者及出版时间；⑦页码。
（2）文件、档案、书信等。要在所引文档名后用圆括号标注成文时间。日记集要在书名后标出所引内容的成文时间。
（3）图书中序跋、前言、后记、按语、编辑说明等。如果其为作者自己所写，用引号标示于书名之后，如果由别人所写，或虽由作者自己所写，但有单独标题，应作为析出文献标注。
例1：罗志田：《林纾的认同危机与民初的新旧之争》，《权势转移：近代中国的思想、社会与学术》，湖北人民出版社1999年版，第283页。
例2：《中共中央最近政治状况报告》（1927年10月），中央档案馆编：《中共中央政治报告选辑（1927─1933）》，中共中央党校出版社1983年版，第20页。
例3：《复孙毓修函》（1911年6月3日），高平叔、王世儒编注：《蔡元培书信集》上，浙江教育出版社2000年版，第99页。
例4：曹伯言整理：《胡适日记全编》第3册，1922年5月14日，安徽教育出版社2001年版，第666—667页。
例5：李鹏程：《当代文化哲学沉思》，“序言”，人民出版社1994年版，第1页。
例6：李文海：《〈晚清政治革命新论〉序》，郭世佑：《晚清政治革命新论》，湖南人民出版社1997年版，第6页。
例7：黄仁宇：《为什么称为“中国大历史”？──中文版自序》，《中国大历史》，生活·读书·新知三联书店1997年版，第3页。
3.古籍及方志。
古籍的标注与普通图书基本相同，但成书过程比较复杂的先秦典籍，如四书五经；常用的基本典籍，如二十四史、《资治通鉴》，书名中含有作者姓名的文集，如《陶渊明集》；官修的大型典籍，如《明实录》、《大清会典》等可不标注作者。极少数常用经典古籍可只标书名和篇名，用中圆点连接，如：《论语·学而》。有些书籍作者失传，用“佚名”标注。地方志一般不标注作者、版本，只注书名，前面冠以修纂成书时的年号（年代）。古籍及方志的卷次、页码也用阿拉伯数字标示。
例1：光绪《代州志》第3卷，“地理志·物产”，第3页。
例2：民国《番禺县续志》第9卷，“政经三·房捐”，第10页。
4．期刊。
标注的项目和顺序为：①作者姓名；②文章名称；③期刊名称，与其他刊物同名、流行范围较小的期刊以及港澳台地区的期刊应在刊名前注明出版地点；④出版时间、卷册号或期号，出刊周期短于半月者如旬刊、周刊、日刊等，出版时间精确到日；⑤页码，以栏目、文章单独编辑页码的，在页码后加括号注明栏页或文页。
例1：费成康：《葡萄牙人如何进入澳门问题辨证》，上海《社会科学》1999年第9期，第10页。
例2：蒋永敬：《孙中山先生晚年北上与废约运动》，台北《近代中国》第152期,2002年12月，第28页。
例3：上海商业储蓄银行调查部：《十年来上海现金流动之观察》（二），《银行周报》第16卷第41号，1932年10月25日。
例4：《川东官话字母学堂招生》，《广益丛报》第5年第13期，1907年8月7日，第12页（栏页）。
例5：顾颉刚：《中学校本国史教科书编纂法的商榷》，《教育杂志》第14卷第4号，1922年4月，第14页（文页）。
5．报纸。
标注的基本项目和顺序是：①作者姓名；②文章名称；③报纸名称，有同名的报纸应在报纸名称前标明出版地点；④出版年、月、日；⑤版次。栏目名如需标示，放在出版时间后，用引号标出。影印版按图书方式标注。
例1：天仇：《自由与秩序》，《民权报》，1912年3月28日，第2版。
例2：《江苏省党务报告》，上海《民国日报》，1929年3月21日，第6版。
例3：《科举谈》，《申报》，1912年2月12日，“自由谈”，第2张第8版。
例4：《说国债》，《申报》第57册，1897年10月3日，上海书店1983年影印版，第195页。
同名报刊注法列表
6．外文文献（以英文为例）。
原则上应以该文种通行的征引格式为准。
（1）图书。标注的基本项目及顺序为：①责任者姓名，名在前（可简写），姓在后；②书名，如书名较长，再次征引时可只标注书名主要部分，其余略去；③卷册数；④出版地、出版者及出版时间，用圆括号括起，同一著作只在首次出现时标注；⑤页码。
（2）编辑图书。标注的基本项目及顺序为：①作者姓名；②篇名；③编辑者姓名，单个编者姓名后加（ed.）,合编加（eds.）；④书名；⑤卷册数；⑥出版地、出版者及出版时间；
⑦页码。
（3）期刊、报纸。标注的基本项目和顺序是：①作者姓名；②析出文献名称，用双引号括起；③期刊、报纸名称，用斜体；④刊物卷册号与期号；⑤出版年、月、日。
所引文献在原书不跨页，表示方法为“p.×”），引文跨页或散见两页以上，表示方法为“pp. ×—××, ××”）；注释中纯系英文，句末用英文句点，如中英文混用，句末用中文句号。
例1： D. H. Perkins, Agricultural Development in China, 1368-1968 (Chicago: Aldine Publishing Company, 1969), p.66.
例2：Jin Qiming and Li Wei, “China’s Rural Settlement Patterns,”in Ronald G. Knapp(ed.), Chinese Landscapes: The Village as Place( Honolulu: University of Hawaii Press, 1992), pp.17-18, 20.
例3：转引自Timothy Brook, “The Tokyo Judgement and the Rape of Nanking,” The Journal of Asian Studies, Vol.60, No.3( 2001)。
例4.1：Michael Sheng，Battling Western Imperialism：Mao，Stalin，and the United States （Princeton：Princeton University Press，1997），p.186.
例4.2：Michael Sheng，Battling Western Imperialism，pp.186—188.
7.未刊文献。
（1）档案。标注的项目和顺序是：①文件名称，加书名号；②时间；③藏所；④全宗名称；
⑤档案编号，全宗号、案卷号与页码之间加斜杠“/”间隔。
《傅良佐致国务院电》
（1917年9月15日），中国第二历史档案馆藏，北洋档案，1011/5961。例1：
例2：《唐生智致蒋方震电》（1929年12月18日），台北，“国史馆”藏，阎锡山档案·杂派民国18年3月至12月往来电文，18.0372.42/0032—3—12。
例3：《陈云致王明信》（1937年5月16日），俄罗斯当代文献保管与研究中心藏，495/74/290。
例4：《蒋中正电霍揆章即与唐署长飞浔详报一切至龙绳武龙绳曾应暂予监视》（1946年7月23日），蒋中正总统文物档案，002/020400/008/108。
（2）手稿。征引未出版的手稿时，要标明藏所，藏所后加一“藏”字。
例1：陈序经：《文化论丛》（手稿），南开大学图书馆藏，第1页。
例2：《蒋介石日记》（手稿），1948年8月6日，斯坦福大学胡佛研究所档案馆藏，下同。
(3)学位论文。征引未出版的学位论文中的内容，要标明作者、文题、学位论文等级、学位授予机构、时间及页码。
例: 方明东：《罗隆基政治思想研究（1913—1949）》，博士学位论文，北京师范大学历史系，2000年，第67页。
(4)会议论文。征引未出版的会议论文中的内容，要标明作者，文题，会议名称（用双引号括起）、地点及时间。
例:〔日〕中岛乐章：《明前期徽州的民事诉讼个案研究》，“国际徽学研讨会”论文，安徽绩溪，1998年。
四、其他
（一）课题项目
课题项目名称用双引号括起，项目编号放圆括号内。
例：本文系教育部人文社会科学重点研究基地重大项目“近代中国人对日本的认识与态度”（06JJD770012）的中期成果之一。
（二）几种常用而较特殊文献的注释法
1.政协文史资料。各级“人民政治协商会议”简称“全国政协”、“××省（市、县）政协”等，内部出版的政协文史资料须注明编印年。
例1：张治中：《第五军参加淞沪抗日战役的经过》，全国政协文史资料研究委员会编：《文史资料选辑》第37辑，中华书局1979年版，第15页。
例2：曾克林：《回忆党中央对争取东北的战略决策》，《沈阳文史资料》第3辑，沈阳市政协文史资料研究委员会1982年编印，第16页。
2．沈云龙主编《近代中国史料丛刊》及其续编、三编，须在书名后标出总顺序号。
例：王照：《小航文存》，沈云龙主编：《近代中国史料丛刊》（265），台北，文海出版社
1969年版，第141页。
3．梁启超《饮冰室合集》，须标出各集名称及卷数。
例：梁启超：《清代学术概论》，《饮冰室合集》专集之三十四，中华书局1989年版，第57—58页。
4．《中华民国史档案资料汇编》，须标出辑数、编数及分类名称。
例：中国第二历史档案馆编：《中华民国史档案资料汇编》第5辑第1编，“财政经济”（1），江苏古籍出版社1994年版，第6页。
5. 网络资料
摘引互联网上资料，必须核实内容，标明网址及下载日期，引用者自行保留网页。
例：《霍揆彰致国民政府军务局转呈蒋主席电》（1946年7月13日），转引自《台湾“蒋介石档案”中的闻一多被刺事件资料（二）》《闻一多研究动态》第85期，2010年6月，近代中国研究网：https://www.docsj.com/doc/a710440622.html,/Article/20100625102224.asp，2010年6月21日。
C语言注释规范
C语言注释规范 1.注释原则 同一软件项目开发中，尽量保持代码注释规范和统一。 注释方便了代码的阅读和维护。 边写代码边注释，修改代码时要相应修改注释，保证注释和代码的一致性。 注释要简洁明确，不要出现形容词。 对于写的好的注释，我们将是第一个受益者。 大型软件开发中，通过别人的注释可以快速知道他人所写函数的功能，返回值，参数的使用。 2.文件头部的注释 示例： / * Program Assignment : 该文件的作用 * Author: 作者 * Date: 2013/8/6 14:34 * Description: 该文件的描述 *****/ /* * Source code in : 源代码的路径 * Function List: * initLinear 初始化线性表 * destoryLinear 释放线性表申请的空间 * isLinearEmpty 判断线性表是否为空 * isLinearFull 判断线性表是否为满 * getLinearElementValue 取得下标为index的元素的值 */ 注意：这个函数列表可以快速查询到我们想要了解的函数。 3.结构体，全局变量等的注释 示例： typedef POLYNOMIAL USER_TYPE; /* 新的数据类型的描述*/ int a; /* 全局变量的作用*/ /* 说明结构体的功能*/ typedef struct LINEAR { USER_TYPE *data; /* 每个成员的意义(作用) */ int maxRoom; /* 每个成员的意义(作用) */
int elementCount; /* 每个成员的意义(作用) */ }LINEAR; 4.函数的注释 在逻辑性较强的的地方加入注释，以便其他人的理解，在一定的程度上排除bug。 示例： /* * Function Name: getLinearElementIndex * Purpose: 取得元素的index值 * Params : * @LINEAR linear 线性表实例 * @USER_TYPE var 类型为USER_TYPE的实例 * @int (*)() cmp 提供接口，让用户定义具体比较函数 * Return: int 返回元素的index值 * Limitation: 如果返回-1，则代表不存在var的元素 */ int getLinearElementIndex(LINEAR linear, USER_TYPE var, int (*cmp)()) { /* * 如果逻辑太过复杂，这里写明该算法的过程和思路。 */ boolean found = FALSE; int i; for(i = 0; i < && !found; i++) if(cmp[i], var) == 0) found = TRUE; if(i >= i = NOT_FOUND; return i; }
参考文献及注释格式
论文参考文献及注释格式参考 一、参考文献格式： 1 参考文献是对期刊论文引文进行统计和分析的重要信息源之一，在本规范中采用 GB7714推荐的顺序编码制格式著录。 2 参考文献著录项目 a.主要责任者(专著作者、论文集主编、学位申报人、专利申请人、报告撰写人、期刊文章作者、析出文章作者)。多个责任者之间以“，”分隔，注意在本项数据中不得出现缩写点“.”。主要责任者只列姓名，其后不加“著”、“编”、“主编”、“合编”等责任说明。 b.文献题名及版本(初版省略)。 c.文献类型及载体类型标识。 d.出版项(出版地、出版者、出版年)。 e.文献出处或电子文献的可获得地址。 f.文献起止页码。 g.文献标准编号(标准号、专利号……)。 3 参考文献类型及其标识 他未说明的文献类型，建议采用单字母“Z”。 (3) 对于数据库(database)、计算机程序(computer program)及电子公告(electronic 对于非纸张型载体的电子文献，当被引用为参考文献时需在参考文献类型标识中同时标明其载体类型。本规范建议采用双字母表示电子文献载体类型：磁带(magnetic tape)——MT，磁盘(disk)——DK，光盘(CD-ROM)——CD，联机网络(online)——OL，并以下列格式表示包括了文献载体类型的参考文献类型标识： [文献类型标识/载体类型标识] 如：[DB/OL]——联机网上数据库(database online) [DB/MT]——磁带数据库(database on magnetic tape) [M/CD]——光盘图书(monograph on CD-ROM) [CP/DK]——磁盘软件(computer program on disk) [J/OL]——网上期刊(serial online) [EB/OL]——网上电子公告(electronic bulletin board online) 以纸张为载体的传统文献在引作参考文献时不必注明其载体类型。 4 文后参考文献表编排格式 参考文献按在正文中出现的先后次序列表于文后；表上以“参考文献：”(左顶格)或“[参考文献]”(居中)作为标识；参考文献的序号左顶格，并用数字加方括号表示，如[1]、[2]、…，以与正文中的指示序号格式一致。参照ISO690及ISO690-2，每一参考文献条目的最后均以“.”结束。各类参考文献条目的编排格式及示例如下：
本科论文脚注和参考文献说明
教育科学学院 关于本科毕业论文脚注和参考文献的补充说明 根据《参考文献及注释规范(国际标准)》、《参考文献格式国家标准》（中华人民共和国国家标准UDC 025.32/GB 7714-87),参照《聊城大学关于硕士学位论文的基本要求》相关内容，经请示教务处并结合我院本科论文工作实际，制定《教育科学学院专业本科毕业论文脚注和参考文献的补充说明》，供参考。 一、脚注 每页的脚注单独编号，用“①②③……”数字序号表示。格式示例如下：期刊： 序号主要责任人.题名[文献类型标识].刊名,年(期):起止页码. 专著： 序号主要责任人．题名[文献类型标识]．出版地：出版者，出版年,起止页码．如： ①杨邦,李俊.互文性阅读概论[J],中学语文教学参考,2001（8）:19-23． 二、参考文献 按论文中参考文献出现的先后顺序用阿拉伯数字连续编号，将序号置于方括号内，参考文献中每条项目应齐全。文献中的作者不超过三位时全部列出；超过三位时一般只列前三位，后面加“等”字或“et al.”；作者姓名之间用逗号分开；中外人名一律采用姓在前，名在后的著录法。每一参考文献条目的最后均以“．”结束。格式示例如下： 1.期刊 [序号] 主要责任人.题名[文献类型标识].刊名,年 (期):起止页码． 例如： [1] 杨邦,李俊.互文性阅读概论[J].中学语文教学参考,2001（8）:19-23． [2] 金显贺,王昌长,王忠东等.一种用于在线检测局部放电的数字滤波技术 ［J］.清华大学学报(自然科学版),1993(4):62-67. 2.专著、论文集、学位论文、报告 [序号] 主要责任人.题名[文献类型标识].出版地:出版者,出版年. 例如（任选）： [3] 王齐乐.香港中文教育发展史[M].香港:三联书店,1991. [4] 辛希孟.信息技术与信息服务国际研讨会论文集:A集［C］.北京：中 国社会科学出版社,1994.
程序代码注释编写规范
程序代码注释编写规范 为提高控制程序的阅读性与可理解性，现制定相关代码程序代码注释编写的编写规范。 一般情况下，源程序有效注释量必须在20％以上，注释的原则是有助于对程序的阅读理解，在该加的地方都加了，注释不宜太多也不能太少，注释语言必须准确、易懂、简洁。 常规注释有以下两种方式。 单行:以"//"符号开始，任何位于该符号之后的本行文字都视为注释。 多行:以"/*"符号开始，以"*/"结束。任何介于这对符号之间的文字都视为注释。 一、说明性文件 说明性文件（如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg等）头部应进行注释，注释必须列出：版权说明、版本号、生成日期、作者、内容、功能、与其它文件的关系、修改日志等，头文件的注释中还应有函数功能简要说明。 示例：下面这段头文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************* COPYRIGHT (C), MicTiVo International. Co., Ltd. File NAME: // 文件 Author: Version: Date: // 作者、版本及完成日期 DESCRIPTION: // 用于详细说明此程序文件完成的主要功能，与其他模块 // 或函数的接口，输出值、取值范围、含义及参数间的控 // 制、顺序、独立或依赖等关系 Others: // 其它内容的说明 Function List: // 主要函数列表，每条记录应包括函数名及功能简要说明 1.... History: // 修改历史记录列表，每条修改记录应包括修改日期、修改 // 者及修改内容简述 1. Date: Author: Modification: 2. .. *************************************************/ 二、源文件头 源文件头部应进行注释，列出：版权说明、版本号、生成日期、作者、模块目的/功能、主要函数及其功能、修改日志等。 示例：下面这段源文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************************ COPYRIGHT (C), MicTiVo International. Co., Ltd. FileName: Author:
参考文献与注释的编排方法.doc
参考文献与注释的编排方法 一、注释的标注方法 注释是对论著正文中某一特定内容的进一步解释或补充说明,以及未公开发表的私人通信、内部资料、书稿和仅有中介文献信息的"转引自"等类文献的引用著录，排印在该页地脚(数字加圆圈，如①、②...)。 二、参考文献的标注方法 参考文献是作者写作论著时所引用的已公开发表的文献书目,或有明确收藏地点的善本、档案，按照在正文中引用的顺序，用数字加方括号集中列表于文末。正文中的标注方法是：1.引用文献原文需要在正文中标出序号与页码(如："资本主义生产的内在规律在竞争中是以颠倒的形式表现出来的"[1]251)，文后参考文献中不出现页码项;2.引用参考文献中的观点可以只标出序号或者序号与页码同时标注(如：生产力决定生产关系[3]);3.文中多次引用同一参考文献内容，在文后参考文献表中只出现一次，其中不注页码;在正文中标注首次引用的文献序号，并在序号的角标外著录引文页码;4.参考文献的编排格式见附注。 例文 国内外现有的竞争理论文献，或者忽略了马克思的竞争理论，或者只把它作为竞争理论发展的一个阶段或众多竞争理论中的一个 流派，停留在马克思对市场竞争过程的描述上。然而,马克思指出："
资本主义生产的内在规律在竞争中是以颠倒的形式表现出来的"[1]251。"只有了解了资本的内在本性，才能对竞争进行科学的分析，正像只有认识了天体的实际的、但又直接感觉不到的运动的人，才能了解天体的表面运动一样。"[2]352 ...... ......而且可以说明，当时政治经济学没有理解的"关于资本主义竞争的基本规律，即调节一般利润率和由它决定的所谓生产价格的规律，也是建立在商品价值和商品成本价格之间的这种差别之上的，建立在由此引起的商品低于价值出售也能获得利润这样一种可能性之上的"[1]45。 ...... ......随着许多偶然的改进,产品系列趋于增大，零件数量趋于增加，会产生大量的多样化成本。[3] 参考文献： [1] 马克思.资本论(第3卷)[M].北京：人民出版社，1975. [2] 马克思.资本论(第1卷)[M].北京：人民出版社，1975. [3] 安德森·派恩二世.21世纪企业竞争的新前沿——大规模定制模式下的敏捷产品开发[M].北京：机械工业出版社，1999. 附注： 一、参考文献著录项目 1. 主要责任者 (专著作者、论文集主编、学位申报人、专利申请人、报告撰写人、期刊文章作者、析出文章作者)。多个责任者
参考文献格式
参考文献注释格式 学术期刊作者﹒论文题目[J]﹒期刊名称，出版年份，卷(期)：页次 如果作者的人数多于3人，则写前三位作者的名字后面加“等”，作者之间以逗号隔开。例如： [1]李峰,胡征,景苏等. 纳米粒子的控制生长和自组装研究进展[J]. 无机化学学报，2001, 17(3): 315~324 [2]J.Y.Li, X.L.Chen,H.Li. Fabrication of zinc oxide nanorods[J].Journal of Crystal Growth, 2001,233:5～7 学术会议论文集作者﹒论文题目﹒文集编者姓名﹒学术会议文集名称[C]，出版地：出版者，出版年份：页次 例如： [3] 司宗国谢去病王群﹒重子湮没快度关联的研究﹒见赵维勤，高崇寿编﹒第五届高能粒子产生和重离子碰撞理论研讨会文集[C]，北京：中国高等科学技术中心，1996：105 图书著者﹒书名[M]﹒版本﹒出版地：出版者，出版年﹒页次 如果该书是第一版则可以略去版次。 例如： [4]韩其智孙洪洲﹒群论[M]﹒北京：北京大学出版社，1987﹒101 学位论文作者﹒论文题目[D]﹒学士(或硕士、博士)学位论文. 出版地：出版者，出版年份 例如： [5]陈异.纳米粒子形貌控制研究[D]. 硕士学位论文. 北京：中国科学院, 2002 专利专利所有者.专利名称[P]. 专利国别：专利号，日期. 例如： [6] 姜锡洲 . 一种温热外敷药制备方案[P]. 中国专利：881056073，1989-07-26. 报纸类作者.篇名[N].报纸名，出版日期（版次） [7] 李大伦.经济全球化的重要性[N].光明日报，1998－12－27（3）
程序代码注释编写规范
百度文库- 让每个人平等地提升自我 1 程序代码注释编写规范 为提高控制程序的阅读性与可理解性，现制定相关代码程序代码注释编写的编写规范。 一般情况下，源程序有效注释量必须在20％以上，注释的原则是有助于对程序的阅读理解，在该加的地方都加了，注释不宜太多也不能太少，注释语言必须准确、易懂、简洁。 常规注释有以下两种方式。 单行:以"文件、.inc文件、.def文件、编译说明文件.cfg等）头部应进行注释，注释必须列出：版权说明、版本号、生成日期、作者、内容、功能、与其它文件的关系、修改日志等，头文件的注释中还应有函数功能简要说明。 示例：下面这段头文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************* (C), MicTiVo International. Co., Ltd. 1.File : . History: Date: Author: Modification: 2. .. *************************************************/ 一、源文件头 源文件头部应进行注释，列出：版权说明、版本号、生成日期、作者、模块目的/功能、主要函数及其功能、修改日志等。 示例：下面这段源文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************************ (C), MicTiVo International. Co., Ltd. FileName: Author: Version : Date: : / /*receive _process() */ 意:与溢出中断写初值不同}
本科毕业论文注释和参考文献格式要求
本科毕业论文注释和参考文献格式要求 ——WORD文档，下载后可编辑修改—— Format of Notes and References for the Graduation Theses (说明：本格式参阅了MLA、CMS、《外语教学与研究》的格式、其他学术刊物、以及中山大学外语学院毕业论文格式要求。) I. 注释Endnotes and In-text Citations 1.尾注 在正文需详细注释处的右上方按顺序加注数码①②③......，在全文之后写注文,每条加对应数码, 回行时与上一行注文对齐。 2.夹注 某些引文或所依据的文献无须详细注释者，以夹注的形式随文在括号内注明。 1)来自专著的直接引语，作者姓名在文中已经出现： 格式：出版年份：页码 例： Rees said, “As key aspects of ...in the process”(1986;241). 2 ) 来自专著的直接引语，作者姓名在文中没有出现： 格式：作者姓名，出版年份：页码 例： The underlying assumption is that language “bound up with culture in multiple and complex ways”(Kramsch, 1968: 3).
3 ) 来自某篇文章的直接引语，作者姓名在文中已经出现： 格式：发表年份 (无须页码) 例：Ernst Rose submits, “The highly spiritual view of the ...al ike” (1974). 4 ) 来自某篇文章的直接引语，作者姓名在文中没有出现： 格式：作者姓名(英文只注姓)、出版年份(无须页码) 例： “Everything rests on the notion that there is such a thing as ‘just’ words – but there isn’t” (Bateson 1972) 5 ) 来自专著的间接引语，作者姓名在文中已经出现： 格式：出版年份：引文页码 例： According to Alun Rees (1986:234), the writers focus on the unique contribution that each individual learner brings to the learning situation. 6 ) 来自专著的间接引语，作者姓名在文中没有提到： 格式：作者姓名出版年份：引文页码 例：It may be true that in the appreciation of medieval art the attitude of the observer is of primary importance ( see Robertson 1987: 136). 7 ) 来自文章的间接引语，作者姓名在文中没有提到： 格式：作者姓名出版年份 (无须页码)
参考文献与注释的规范
参考文献 一、参考文献的类型 参考文献（即引文出处）的类型以单字母方式标识，具体如下： M——专著 C——论文集 N——报纸文章 J——期刊文章 D——学位论文 R——报告 对于不属于上述的文献类型，采用字母“Z”标识。 对于英文参考文献，还应注意以下两点： ①作者姓名采用“姓在前名在后”原则，具体格式是：姓，名字的首字母. 如： Malcolm Richard Cowley 应为：Cowley, M.R.，如果有两位作者，第一位作者方式不变，&之后第二位作者名字的首字母放在前面，姓放在后面，如：Frank Norris 与Irving Gordon应为：Norris, F. &I.Gordon.； ②书名、报刊名使用斜体字，如：Mastering English Literature，English Weekly。 二、参考文献的格式及举例 1.期刊类 【格式】[序号]作者.篇名[J].刊名，出版年份，卷号（期号）：起止页码. 【举例】 [1] 王海粟.浅议会计信息披露模式[J].财政研究，2004,21(1)：56-58. [2] 夏鲁惠.高等学校毕业论文教学情况调研报告[J].高等理科教育，2004(1):46-52. [3] Heider, E.R.&D.C.Oliver. The structure of color space in naming and memory of two languages [J]. Foreign Language Teaching and Research, 1999, (3): 62 – 67. 2.专著类 【格式】[序号]作者.书名[M].出版地：出版社，出版年份：起止页码. 【举例】[4] 葛家澍，林志军.现代西方财务会计理论[M].厦门：厦门大学出版社，2001：42. [5] Gill, R. Mastering English Literature [M]. London: Macmillan, 1985: 42-45. 3.报纸类 【格式】[序号]作者.篇名[N].报纸名，出版日期（版次）. 【举例】 [6] 李大伦.经济全球化的重要性[N]. 光明日报，1998-12-27(3). [7] French, W. Between Silences: A Voice from China[N]. Atlantic Weekly, 1987-8-15(33). 4.论文集 【格式】[序号]作者.篇名[C].出版地：出版者，出版年份：起始页码. 【举例】 [8] 伍蠡甫.西方文论选[C]. 上海：上海译文出版社，1979：12-17. [9] Spivak,G. “Can the Subaltern Speak?”[A]. In C.Nelson& L. Grossberg(eds.). Victory in Limbo: Imigism [C]. Urbana: University of Illinois Press, 1988, pp.271-313. [10] Almarza, G.G. Student foreign language teacher’s knowledge growth [A]. In D.Freeman and J.C.Richards (eds.). Teacher Learning in Language Teaching [C]. New York: Cambridge University Press. 1996. pp.50-78. 5.学位论文
注释和参考文献格式
注释和参考文献格式 （注释） 注：（一律用脚注——放在每页下端，每页单独编号。格式如下：） ①鲁迅：《文坛的掌故》，《鲁迅全集》第4卷，北京：人民文学出版社，1991年，第 120页。 ②李赋宁总主编：《欧洲文学史》第1卷，北京：商务印书馆，1999年，第273页。 ③狄更斯：《双城记》，张玲、张扬译，上海译文出版社，1989年，第254页。本文以 下凡引用此作品，均引自这一版本，不另加注，仅在引文后注明作品名称和页码。 （这里指的是：如果你在同一篇论文中多次引用同一部作品中的文字，那么只需要在第一次引用时注明出处，以后再引用时仅在引文后面加上括号、注明页码即可。） ④詹姆逊：《后现代主义，或晚期资本主义的文化逻辑》，见《快感：文化与政治》，王 逢振等译，北京：中国社会科学出版社，1998年，第152页。 ⑤陈小慰：《一部反映现实的未来小说》，载《当代外国文学》，2003年第1期。 ⑥转引自韩加明：《司各特论英国小说叙事》，载《外国文学评论》，2003年第2期。 （凡是转引别人的论文、著作中所引用的其他人的文字和言论，一律注明“转引自”。）※※※※ 参考文献： ①柳鸣九等著：《法国文学史》（中），北京：人民文学出版社，1981年。 ②巴尔扎克：《巴尔扎克论文艺》，艾珉、黄晋凯选编，北京：人民文学出版社，2003 年。 ③汪介之：《“世界文学”的命运与比较文学的前景》，载《外国文学研究》，2004年第6期。 另外应注意： 单独成段的引文的形式：用楷体或仿宋体字，上下各空一行，左右各缩进两格，不加引号； 引文下面一段的正文，开头要空两格。 中外文不能混用，如“人民文学出版社，1988年，p.8”。 外文注释的页码：p.8 ，pp.105 -106。
程序代码注释编写规范
程序代码注释编写规范 XXX份公司
为提高控制程序的阅读性与可理解性，现制定相关代码程序代码注释编写的编写规范。 一般情况下，源程序有效注释量必须在20％以上，注释的原则是有助于对程序的阅读理解，在该加的地方都加了，注释不宜太多也不能太少，注释语言必须准确、易懂、简洁。 常规注释有以下两种方式。 单行:以"//"符号开始，任何位于该符号之后的本行文字都视为注释。 多行:以"/*"符号开始，以"*/"结束。任何介于这对符号之间的文字都视为注释。 一、说明性文件 说明性文件（如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg等）头部应进行注释，注释必须列出：版权说明、版本号、生成日期、作者、内容、功能、与其它文件的关系、修改日志等，头文件的注释中还应有函数功能简要说明。 示例：下面这段头文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************* COPYRIGHT (C), MicTiVo International. Co., Ltd. File NAME: // 文件 Author: Version: Date: // 作者、版本及完成日期 DESCRIPTION: // 用于详细说明此程序文件完成的主要功能，与其他模块 // 或函数的接口，输出值、取值范围、含义及参数间的控 // 制、顺序、独立或依赖等关系 Others: // 其它内容的说明 Function List: // 主要函数列表，每条记录应包括函数名及功能简要说明 1.... History: // 修改历史记录列表，每条修改记录应包括修改日期、修改 // 者及修改内容简述 1. Date: Author: Modification: 2. .. *************************************************/ 二、源文件头 源文件头部应进行注释，列出：版权说明、版本号、生成日期、作者、模块目的/功能、主要函数及其功能、修改日志等。 示例：下面这段源文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************************
参考文献著录格式(引用格式-标注规范、方式)
参考文献著录格式（引用格式）-标注规 论文中的参考文献是按时间排还是按的首字母？ 参考文献的标注法有两种，择一，从头至尾用同一方式标注。 1.顺序排列法：按正文引用文献出现的顺序，以阿拉伯数字连续编码，依序列出（最 常见）。 2.著者－出版年制：各文献标注容，由著者姓氏与出版年构成，置于（）。各篇文献 先按文种集中，可分为中文、西文、日文、俄文、其他文种等五部分。然后，按著者字顺和出版年排列。中文文献一般按汉语拼音字顺排列。 按照你文章中引用的顺序排。 2015年论文参考文献的标注规 一、顺序编码制(温哥华体系) 这种体系是按在正文中引用的文献出现先后顺序使用阿拉伯数字连续编码，用方括号括注在文中提及的文献著者或理论系统名的右上角。如： 达尔文指出…… 进化论认为…… 如果只提及引用容而未提及著者，则括注在所引用文字群的右上角。如: 根据遗传学原理,可以推论出这种变异是受基因控制的,是可以遗传的[8]。 如果所提及的文献作为文字叙述中的直接说明语时，则应与正文平排,并且每个序号都应加上方括号。如: 紫色土壤主要分布在我国西南地区(参见文献[11]、[20]、[32])。 文中多次引用同一参考文献，只在第一次出现时编排序号(在参考文献表中也只出现一次)，其他处使用同一序号;如果多次引用的是同一参考文献的不同页的容并标上了页码，则每次引用都应编排序号，参考文献表中也要一一列出。 若某一问题使用了多篇文献说明，这时将各文献的序号在一个方括号全部列出，中间加逗号，若遇连续序号，可在起讫序号中间加“~”表示。如： 这种变异往往发生在细胞的减数分裂时期[3, 5, 7~10]，但是为了…… 二、著者-出版年制 这种参考文献是由著者与出版年代构成。标注方法是在被引用的著者之后用圆括号标注参考文献的出版年代。如： 徐道一(1983)认为，生物变革时期与太阳系在银河系的运行轨迹可能有一定联系。
论文参考文献和脚注的格式
一、参考文献格式： 1 参考文献是对期刊论文引文进行统计和分析的重要信息源之一，在本规范中采用GB7714推荐的顺序编码制格式着录。 2 参考文献着录项目 a.主要责任者(专着作者、论文集主编、学位申报人、专利申请人、报告撰写人、期刊文章作者、析出文章作者)。多个责任者之间以“，”分隔，注意在本项数据中不得出现缩写点“.”。主要责任者只列姓名，其后不加“着”、“编”、“主编”、“合编”等责任说明。 b.文献题名及版本(初版省略)。 c.文献类型及载体类型标识。 d.出版项(出版地、出版者、出版年)。 e.文献出处或电子文献的可获得地址。 f.文献起止页码。 g.文献标准编号(标准号、专利号……)。 3 参考文献类型及其标识 (1) 根据GB3469规定，以单字母方式标识以下各种参考文献类型： 参考文献类型 专着 论文集 报纸文章 期刊文章
学位论文 报告 标准 专利 文献类型标识 M C N J D R S P (2) 对于专着、论文集中的析出文献，其文献类型标识建议采用单字母“A”；对于其他未说明的文献类型，建议采用单字母“Z”。 (3) 对于数据库(database)、计算机程序(computer program)及电子公告(electronic bulletin board)等电子文献类型的参考文献，建议以下列双字母作为标识： 电子参考文献类型 数据库 计算机程序 电子公告
电子文献类型标识 DB CP EB (4) 电子文献的载体类型及其标识 对于非纸张型载体的电子文献，当被引用为参考文献时需在参考文献类型标识中同时标明其载体类型。本规范建议采用双字母表示电子文献载体类型：磁带(magnetic tape)——MT，磁盘(disk)——DK，光盘(CD-ROM)——CD，联机网络(online)——OL，并以下列格式表示包括了文献载体类型的参考文献类型标识： [文献类型标识/载体类型标识] 如：[DB/OL]——联机网上数据库(database online) [DB/MT]——磁带数据库(database on magnetic tape) [M/CD]——光盘图书(monograph on CD-ROM) [CP/DK]——磁盘软件(computer program on disk) [J/OL]——网上期刊(serial online) [EB/OL]——网上电子公告(electronic bulletin board online) 以纸张为载体的传统文献在引作参考文献时不必注明其载体类型。 4 文后参考文献表编排格式 参考文献按在正文中出现的先后次序列表于文后；表上以“参考文献：”(左顶格)或“[参考文献]”(居中)作为标识；参考文献的序号左顶格，并用数字加方括号表示，如[1]、[2]、…，以与正文中的指示序号格式一致。参照ISO690
代码规范
目录 一．规范简介 1.1 目的 所有的程序开发手册都包含了各种规则。一些习惯自由程序人员可能对这些规则很不适应，但是在多个开发人员共同写作的情况下，这些规则是必需的。这不仅仅是为了开发效率来考虑，而且也是为了后期维护考虑。 本规范正是为培养规范设计和编程，养成良好的习惯，增强软件产品的稳定，健壮，可靠性；同时也为了提高软件的可读性，可以让程序员尽快而彻底地理解新的代码，使产品可维护性提高而制定的规范。 1.2 开发规范的重要性 （1）减少维护成本； 一个软件的生命周期中，80%的花费在于维护，另一方面，几乎没有任何一个软件，在其整个生命周期中，均由最初的开发人员来维护，规范的编码减少人员变动带来的维护成本。 （2）改善软件的可读性 可以让程序员尽快而彻底地理解新的代码。在一个团队中，代码也容易在程序员之间共享。 （3）维护部门交付产品的规范形象。 二．具体规范 2.1 注释 注释是软件可读性的具体表现。程序注释量一般占程序编码量的20%，软件工程要求不少于20%。程序注释不能用抽象的语言，要精确表达出程序的处理说明。避免每行程序都使用注释，可以在一段程序的前面加一段注释，具有明确的处理逻辑。 注释必不可少，但也不应过多，不要被动得为写注释而写注释。
2.1.1 需要注释的部分 （1）文件头注释，文件创建及修改记录，版权归属，作者以及修订者，以及对文件的简短描述。 （2）类的目的（即类所完成的功能）、设置接口的目的以及应如何被使用。 （3）成员方法注释（对于设置与获取成员方法，在成员变量已有说明的情况下，可以不加注释；普通成员方法要求说明完成功能，参数含义以及返回值）。 （4）普通成员方法内部注释（控制结构、代码所起到的作用以及如此编写代码的原因，处理顺序等）。 （4）参数的含义以及其他任何约束或前提条件、字段或属性描述。而对于局部变量，如无特别意义的情况下则不加注释。 2.1.2 具体注释 （1）文件头注释 要求：遵循JavaDoc的规范，在每一个源文件的开头注明该文件的作用, 作简要说明, 并写上源文件的作者,版权信息编写日期。如果是修改别人编写的源文件，要在修改信息上注明修改者和修改日期。 例子： /** * @Title: 文件名 * @Copyright (C) 年份龙图软件 * @Description: 文件信息描述 * @Revision History: * @Revision 版本号日期作者. */ （2）类和接口的注释 要求：遵循JavaDoc的规范，在每一个类的开头注明该类的作用，作简要说明，并写上作者，编写日期。 例子： /** * @ClassName: 类（或接口）名 * @Description: Description of this class
参考文献及注释格式备课讲稿
参考文献及注释格式
论文参考文献及注释格式参考 一、参考文献格式： 1 参考文献是对期刊论文引文进行统计和分析的重要信息源之一，在本规范中采用GB7714推荐的顺序编码制格式著录。 2 参考文献著录项目 a.主要责任者(专著作者、论文集主编、学位申报人、专利申请人、报告撰写人、期刊文章作者、析出文章作者)。多个责任者之间以“，”分隔，注意在本项数据中不得出现缩写点“.”。主要责任者只列姓名，其后不加“著”、“编”、“主编”、“合编”等责任说明。 b.文献题名及版本(初版省略)。 c.文献类型及载体类型标识。 d.出版项(出版地、出版者、出版年)。 e.文献出处或电子文献的可获得地址。 f.文献起止页码。 g.文献标准编号(标准号、专利号……)。 3 参考文献类型及其标识 (1) 根据GB3469规定，以单字母方式标识以下各种参考文献类型： (2) 对于专著、论文集中的析出文献，其文献类型标识建议采用单字母“A”；对于其他未说明的文献类型，建议采用单字母“Z”。
(3) 对于数据库(database)、计算机程序(computer program)及电子公告(electronic bulletin board)等电子文献类型的参考文献，建议以下列双字母作为标识 (4) 电子文献的载体类型及其标识 对于非纸张型载体的电子文献，当被引用为参考文献时需在参考文献类型标识中同时标明其载体类型。本规范建议采用双字母表示电子文献载体类型：磁带(magnetic tape)——MT，磁盘(disk)——DK，光盘(CD-ROM)——CD，联机网络(online)——OL，并以下列格式表示包括了文献载体类型的参考文献类型标识： [文献类型标识/载体类型标识] 如：[DB/OL]——联机网上数据库(database online) [DB/MT]——磁带数据库(database on magnetic tape) [M/CD]——光盘图书(monograph on CD-ROM) [CP/DK]——磁盘软件(computer program on disk) [J/OL]——网上期刊(serial online) [EB/OL]——网上电子公告(electronic bulletin board online) 以纸张为载体的传统文献在引作参考文献时不必注明其载体类型。 4 文后参考文献表编排格式 参考文献按在正文中出现的先后次序列表于文后；表上以“参考文献：”(左顶格)或“[参考文献]”(居中)作为标识；参考文献的序号左顶格，并用数字加方括号表示，如[1]、[2]、…，以与正文中的指示序号格式一致。参照ISO690及ISO690-2，每一参考文献条目的最后均以“.”结束。各类参考文献条目的编排格式及示例如下：
程序源代码注释规范
程序注释规范说明 程序注释规范应包括以下三方面： 一、文件头部注释 在代码文件的头部进行注释，这样做的好处在于，我们能对代码文件做变更跟踪。在代码头部分标注出创始人、创始时间、修改人、修改时间、代码的功能，这在团队开发中必不可少，它们可以使后来维护/修改的同伴在遇到问题时，在第一时间知道他应该向谁去寻求帮助，并且知道这个文件经历了多少次迭代、经历了多少个程序员的开发和修改。 样本： /***************************************************** ** 作者：Liuchao ** 创始时间：2007-11-12 ** 修改人：Liuchao ** 修改时间：2007-11-12 ** 修改人：Liaochao ** 修改时间：2007-11-12 ** 描述： ** 主要用于产品信息的资料录入，… *****************************************************/ 二、函数、属性、类等注释 请使用///三斜线注释，这种注释是基于XML的，不仅能导出XML制作帮助文档，而且在各个函数、属性、类等的使用中，编辑环境会自动带出注释，方便你的开发。以protected，protected Internal，public声明的定义注释都建议以这样命名方法。 例如： ///
/// 用于从ERP系统中捞出产品信息的类 /// class ProductTypeCollector { … } 三、逻辑点注释 在我们认为逻辑性较强的地方加入注释，说明这段程序的逻辑是怎样的，以方便我们自己后来的理解以及其他人的理解，并且这样还可以在一定程度上排除BUG。在注释中写明我们的逻辑思想，对照程序，判断程序是否符合我们的初衷，如果不是，则我们应该仔细思考耀修改的是注释还是程序了… 四、变量注释 我们在认为重要的变量后加以注释，说明变量的含义，以方便我们自己后来的理解以及其他人的理解，并且这样还可以在一定程度上排除BUG.我们常用///三斜线注释。 /// 用于从ERP系统中捞出产品信息的类 class ProductTypeCollector { int STData;///
参考文献及注释
一、参考文献及注释 凡有直接引用他人成果（文字、数据、事实以及转述他人的观点）之处的均应列于参考文献中或加以注释，参考文献按文中出现的顺序列出。论文分章节的，每章结束后都应该注明本章参考文献，不分章节的在文后统一注明。注释统一按分页下注的方式进行。参考文献书写格式应符合GB7714-87《文后参考文献著录规则》。各类引用参考文献条目的编排格式如下：（1）学术期刊文献 ［序号］作者．文献题名[J]．刊名,出版年份,卷号(期号)：起-止页码 （2）学术著作 ［序号］作者．书名[M]．版次(首次免注).翻译者.出版地:出版社, 出版年:起-止页码 （3）有ISBN号的论文集 ［序号］作者．题名[A].主编．论文集名[C]．出版地：出版社,出版年：起-止页码（4）学位论文 ［序号］作者．题名[D]．保存地：保存单位,年份 （5）专利文献 ［序号］专利所有者．专利题名[P]．专利国别：专利号,发布日期 （6）技术标准 [序号］标准代号,标准名称[S]．出版地：出版者,出版年 （7）报纸文章 [序号］作者．题名[N]．报纸名,出版日期(版次) （8）报告 ［序号］作者．文献题名[R]．报告地：报告会主办单位,年份 （9）电子文献 ［序号］作者．电子文献题名[文献类型/载体类型]．文献网址或出处,发表或更新日期/引用日期(任选) 参考文献的类型
根据GB3469-83《文献类型与文献载体代码》规定，以单字母标识：M——专著（含古籍中的史、志论著）C——论文集 N——报纸文章 J——期刊文章 D——学位论文 R——研究报告 S——标准 P——专利 A——专著、论文集中的析出文献Z——其他未说明的文献类型 电子文献类型以双字母作为标识：DB——数据库 CP——计算机程序 EB——电子公告 非纸张型载体电子文献，在参考文献标识中同时标明其载体类型： DB/OL——联机网上的数据库 DB/MT——磁带数据库 M/CD——光盘图书 CP/DK——磁盘软件J/OL——网上期刊 EB/OL——网上电子公告 二、参考文献著录格式 1 、期刊作者．题名〔J〕．刊名，出版年，卷(期)∶起止页码 2、专著作者．书名〔M〕．版本(第一版不著录)．出版地∶出版者，出版年∶起止页码 3、论文集作者．题名〔C〕．编者．论文集名，出版地∶出版者，出版年∶起止页码 4 、学位论文作者．题名〔D〕．保存地点．保存单位．年份 5 、专利文献题名〔P〕．国别．专利文献种类．专利号．出版日期 6、标准编号．标准名称〔S〕 7、报纸作者．题名〔N〕．报纸名．出版日期(版次) 8 、报告作者．题名〔R〕．保存地点．年份 9 、电子文献作者．题名〔电子文献及载体类型标识〕．文献出处，日期
参考文献标注规范
. .参考文献代码大全 A.期刊 ［序号］主要责任者．文献题名［J］．刊名，出版年份，卷号(期号)：起止页码． ［1］袁庆龙，候文义．Ni-P合金镀层组织形貌及显微硬度研究［Ｊ］．太原理工大学学报，2001，32(1)：51-53. B.专著 ［序号］主要责任者．文献题名［Ｍ］．出版地：出版者，出版年：页码． ［2］刘国钧，郑如斯．中国书的故事［Ｍ］．北京：中国青年出版社，1979：115． C.会议论文集 ［序号］析出责任者．析出题名[A]．见(英文用In)：主编．论文集名[C]．(供选择项：会议名，会址，开会年)出版地：出版者，出版年：起止页码． ［3］孙品一．高校学报编辑工作现代化特征［A］．见：中国高等学校自然科学学报研究会．科技编辑学论文集(2)[C]．北京：北京师范大学出版社，1998：10-22． D.专著中析出的文献 ［序号］析出责任者．析出题名[A]．见(英文用In)：专著责任者．书名[M]．出版地：出版者，出版年：起止页码．［4］罗云．安全科学理论体系的发展及趋势探讨[A]．见：白春华，何学秋，吴宗之．21世纪安全科学与技术的发展趋势[M]．北京：科学出版社，2000：1-5． E.学位论文 ［序号］主要责任者．文献题名［Ｄ］．保存地：保存单位，年份 ［5］张和生．地质力学系统理论［Ｄ］．太原：太原理工大学，1998 F.报告 ［6］冯西桥．核反应堆压力容器的LBB分析［Ｒ］．北京：清华大学核能技术设计研究院，1997 G.专利文献 ［序号］专利所有者．专利题名［P］．专利国别：专利号，发布日期 ［5］姜锡洲．一种温热外敷药制备方案［Ｐ］．中国专利：881056078，1983-08-12 H.国际、国家标准 ［序号］标准代号．标准名称［S］．出版地：出版者，出版年 ［1］GB/T 16159—1996．汉语拼音正词法基本规则［S］．北京：中国标准出版社，1996 I.报纸文章 ［5］谢希德．创造学习的思路[Ｎ]．人民日报，1998，12(25)：10 J.电子文献 ［序号］主要责任者．电子文献题名［文献类型/载体类型］．：电子文献的出版或可获得地址(电子文献地址用文字表述)，发表或更新日期/引用日期(任选) ： ［21］姚伯元．毕业设计(论文)规范化管理与培养学生综合素质［EB/OL］．：中国高等教育网教学研究，2005-2-2 附：参考文献著录中的文献类别代码 普通图书：M 会议录：C 汇编：G 报纸：N 期刊：J 学位论文：D 报告：R 标准：S 专利：P 数据库：DB 计算机程序：CP 电子公告：EB