最后更新:20180306
说明:此中文文案排版规范适用于各类 Web 环境(即不像 Word 类软件可以自动进行排版优化的情形)。它是一种推荐的排版规范,我们不会强制要求你遵守这个规范,但它对你养成一个良好的中文排版习惯,以及对日常学习和日后工作都是有帮助的。
我们相信:写出一份赏心悦目的文档会给一整天的 Coding 带来好心情。因此,我们推荐你学习和使用它。
中文与英文、数字之间加空格
正确示例:
汤姆仅花了 200 元就购买了 JetBrains 全家桶!
错误示例:
汤姆仅花了200元就购买了JetBrains全家桶!
中文使用直角引号
正确示例:
下面我们将介绍什么是「面向对象开发」。
错误示例:
下面我们将介绍什么是“面向对象开发”。
数字和单位之间加空格
正确示例:
bLue 买了一台新电脑,硬盘容量 1 TB,内存容量 8 GiB。
错误示例:
bLue 买了一台新电脑,硬盘容量 1TB,内存容量 8GiB。
例外情形:数字与百分比、度之间不需要加空格
正确示例:
新一代 iPhone 相比上一代图形处理性能提升了 85%。
错误示例:
新一代 iPhone 相比上一代图形处理性能提升了 85 %。
正确示例:
今天是 40° 的高温。
错误示例:
今天是 40 ° 的高温。
中文语句中使用全角标点
正确示例:
我倒,你也网上冲浪啊!你是 GG 还是 MM?
错误示例:
我倒,你也网上冲浪啊!你是 GG 还是 MM?
正确示例:
这里我们要提出一个新的算法:深度优先搜索(DFS)。
错误示例:
这里我们要提出一个新的算法:深度优先搜索 (DFS).
全角标点与其他字符之间不加空格
正确示例:
我们批量购入了 100 台 iPhone X,用于移动开发测试。
错误示例:
我们批量购入了 100 台 iPhone X ,用于移动开发测试。
完整的英文整句或特殊英文名词时使用半角标点
正确示例:
Linus Torvalds 说过:「Talk is cheap. Show me the code.」
错误示例:
Linus Torvalds 说过:「Talk is cheap。Show me the code。」
不要重复使用标点符号
正确示例:
哇,LDQ 果然出线了!
错误示例:
哇,LDQ 果然出线了!!!
使用正确的专有名词
正确示例:
他发现无法在自己的 iPhone 5s 上访问 Google。不仅如此,其他的设备也不行。
错误示例:
他发现无法在自己的 iphone 5S 上访问 google。不仅如此,其他的设备也不行。
注:对于计算机中的基本数据计量单位,我们推荐遵循 IEEE 1541-2002 标准,因此在这里我们也将诸如 KB,MB,KiB,MiB 等单位视作专有名词。
附:计算机基本数据计量单位简介
KB,MB 等单位是 1000 进制,如:
- 1 KB = 1000 B
- 1 MB = 1000 KB
KiB,MiB 等单位是 1024 进制,如:
- 1 KiB = 1024 B
- 1 MiB = 1024 KiB
通常使用 1000 进制单位的有:
- 外存储器(如硬盘)的厂商标称容量
- macOS、Ubuntu 等操作系统中文件数据大小的单位
通常使用 1024 进制单位的有:
- 内存(RAM)的厂商标称容量
- 大部分操作系统中内存(RAM)的单位
- Windows 中文件数据大小的单位
本规范中,我们希望你根据描述对象的实际进制单位,使用对应的单位来书写。
正确示例:
我买了一块 500 GB 的硬盘,加在了我那可怜的只有 256 MiB 内存的电脑上。
错误示例:
我买了一块 500 GiB 的硬盘,加在了我那可怜的只有 256 MB 内存的电脑上。
正确示例:
哇!我的 C 盘下的一个文件夹竟然占用了 80 GiB 的空间!
错误示例:
哇!我的 C 盘下的一个文件夹竟然占用了 80 GB 的空间!
不要使用不地道的缩写
正确示例:
你有学过 HTML5、CSS 和 JavaScript 吗?当然,如果你还熟练掌握 AngularJS 就再好不过了。
错误示例:
你有学过 h5、CSS 和 Js 吗?当然,如果你还熟练掌握 angular 就再好不过了。
中文与链接之间加空格
正确示例:
不如用 谷歌翻译 来查一下这段日文是什么意思。
错误示例:
不如用谷歌翻译来查一下这段日文是什么意思。
参考资料:
还不快抢沙发