标点符号用法 PUNCTUATION
        本文参考《微软技术出版物文体手册第三版》,所述标点符号的用法仅限于对帮助文档、网站文档、营销软文、客服回贴、界面文字等技术文档的写作过程中标点符号的使用方法进行规范。如有疑问,请参照原书。欢迎补充、修正。
       
        一般情况下,标点符号的字体要跟前面的文字字体保持一致。如果前面的文字是一个命令、选项、关键字、占位符、一段代码、或者要求用户输入的特殊格式,标点符号就用罗马字体,以区别标点符号跟前面的文字。
句号和点号(Period . )
1、句号紧接文字,无需空格。句号后接下一句要有一个空格。
2、冒号后面接列表项目时,如果一个条目是一句完整的话,后面用句号;如果是短语,不要加句号,即使这条短语跟前面的介绍性文字能组成一句话,也不加句号。
例:
Correct
If you use printer fonts:
• Choose a printer before creating a presentation.
• Install all the fonts and printers that you will use by selecting them in the Print Setup dialog box.
The database includes:
• Reports
• Forms
• Tables
• Modules
Incorrect
The database includes:
• Reports,
• Forms,
• Tables, and
• Modules.
3、指文件扩展名时,前面要有点号。如:an .exe file。
逗号(Comma , )
1、列举三个或三个以上元素时用逗号分开,用连词连接最后两个元素时,连词前也加逗号。
例:
Correct
You need a hard disk, an EGA or VGA monitor, and a mouse.
2、介绍性的短语后加逗号。
例:
Correct
In Microsoft Windows, you can run many programs.
3、在句中有日期时,日和年后都加逗号。
例:
Correct
The February 4, 2003, issue of the New York Times reported that….
Incorrect
The February 4, 2003 issue of the New York Times reported that….
4、年月格式时,不要用逗号。
例:
Correct
Microsoft introduced Microsoft Windows version 3.0 in May 1990.
Incorrect
Microsoft introduced Microsoft Windows version 3.0 in May, 1990.
5、两个句子用连词连接,前一句后加逗号。网页文档经常有空间限制,有时逗号后面不方便加连词。这种情况下,把两句分开,或者用分号。
例:
Correct
Click Options, and then click Allow Fast Saves.
Click Options; then click Allow Fast Saves. (仅用于网页文档,为了节约空间或受空间限制
Incorrect
Click Options, then click Allow Fast Saves.(then是副词,不要单独用作连词连接句子,描述步骤时,and then通常连在一起用。
6、不要用逗号连接两个复合谓语。
例:
Correct
The Setup program evaluates your computer system and then copies the essential files to your hard disk.
The Setup program evaluates your computer system, and then it copies the essential files to your hard disk.
Incorrect
The Setup program evaluates your computer system, and then copies the essential files to your hard disk.
撇号(Apostrophe ’ )
        用撇号表示名词所有格。单数名词后面,即使是以sxz结尾的词,都加’s;以s结尾的复数名词后只加。首字母缩写词也可以加这种所有格。要避免使用公司名称加这种所有格。不能用产品名或功能名加这种形式。
例:
Correct
Insider’s guide                               
the box’s contents
Burns’s poems                                 
Berlioz’s opera
an OEM’s product                         
the Joneses’ computer
Incorrect
PPT to Flashs interface
冒号(Colon :include of 用法
1、不要滥用冒号。后一句对前一句作阐述或扩展时,用冒号。冒号后面要空一格。
例:
Correct
Treat the unknown risk just like any other risk: Identify the resources available to address it and develop countermeasures to take if it happens.
2、引用列表时,用在句子或短语后面。
例:
Correct
The basic configuration for your computer must include:
• A hard disk with 24 megabytes of free disk space and at least one floppy disk drive.
• A monitor supported by Microsoft Windows.
3、不要用冒号列举代码。
4、冒号后面的词一般不大写,除非是专有名或者后面跟一个完整的句子。冒号后面的列表条目第一个单词首字母大写,不论是否是专有名词或句子。见上例句。
5、用冒号分开书名和一篇文章的标题与副标题。
例:
Correct
The Double Helix: A Personal Account of the Discovery of the Structure of DNA
6、for example后面用逗号,不用冒号;such as后面不用标点符号;若在句中,这两个短语前也加逗号。
7、软件界面上,文本框,选项框前面的标签文字后加冒号。
例:
分号(Semicolon ; )
1、分号用在两个独立的句之间,中断时间比句号短。如果分句没有连词连接,就用分号隔开。否则用逗号加连词。分号常用来连接两个对比性的陈述。
例:
Correct
A new variable is initialized with a specified value; an existing variable can be assigned a new value.
2、不要滥用分号,在低分辨率的显示器上,很难看清,容易跟冒号混淆
引号(Quotation Marks  “ ” ‘ ’)
1、后引号放在逗号和句号外面注意:这是美式用法,这一点跟英式和中文用法不一样。其他情况根据引用内容确定。
例:
Correct
One Internet dictionary calls an electronic magazine a “hyperzine.”
One Internet dictionary calls an electronic magazine a “hyperzine,” but webzine is a common synonym.
What is a “smart device”?
A reader asks, “How scalable is .NET?”
/*Declare the string to have length of “constant+1”.*/
Incorrect