3.2 标点符号
技术文档中标点符号的正确使用方法。
R-040
必须
中文文档使用全角标点
中文技术文档中的标点符号必须使用全角形式,包括逗号(,)、句号(。)、分号(;)、冒号(:)、问号(?)、感叹号(!)等。
正确
请确认以下配置:服务器地址、端口号、协议类型。
错误
请确认以下配置:服务器地址,端口号,协议类型.
中文语境下必须使用全角标点符号,使用半角标点会导致排版不一致,影响阅读体验。
R-041
推荐
中英文之间添加空格
中文与英文、数字之间应添加一个半角空格,以提高可读性。但中文与全角标点之间不加空格。
正确
本系统基于 Python 3.11 开发,使用 Django 框架。
错误
本系统基于Python3.11开发,使用Django框架。
中英文之间的空格可以让文本更加美观和易于阅读。这也是业界广泛采用的排版习惯。
提示
括号的使用:当括号内容为中文时,使用全角括号();当括号内容为纯英文或数字时,可使用半角括号 (ASCII)。