通过本文,你将了解到中文技术文档中段落和数值的写法。
段落
原则
- 一个段落只能有一个主题,或一个中心句子。
- 段落的中心句子放在段首,对全段内容进行概述。后面陈述的句子为核心句服务。
- 一个段落的长度不能超过七行,最佳段落长度小于等于四行。
- 段落的句子语气要使用陈述和肯定语气,避免使用感叹语气。
- 段落之间使用一个空行隔开。
- 段落开头不要留出空白字符。
引用
引用第三方内容时,应注明出处。
One man’s constant is another man’s variable. — Alan Perlis
如果是全篇转载,请在全文开头显著位置注明作者和出处,并链接至原文。
本文转载自 WikiQuote
使用外部图片时,必须在图片下方或文末标明来源。
本文部分图片来自 Wikipedia
数值
半角数字
阿拉伯数字一律使用半角形式,不得使用全角形式。
错误: 这件商品的价格是1000元。
正确: 这件商品的价格是 1000 元。
千分号
数值为千位以上,应添加千分号(半角逗号)。
XXX 公司的实收资本为 ¥1,258,000 人民币。
对于 4 位以下的数值,千分号是选用的,比如1000
和1,000
都可以接受。对于 4 位以上的数值,千分号是必须的。
货币
货币应为阿拉伯数字,并在数字前写出货币符号,或在数字后写出货币中文名称。
$1,000
1,000 美元
英文的货币名称,建议参考国际标准 ISO 4217。
数值范围
表示数值范围时,用~
或——
连接。参见《标点符号》一节的“连接号”部分。
带有单位或百分号时,两个数字建议都要加上单位或百分号。
132kg~234kg
67%~89%
变化程度的表示法
数字的增加要使用“增加了”、“增加到”。“了”表示增量,“到”表示定量。
增加到过去的两倍
(过去为一,现在为二)
增加了两倍
(过去为一,现在为三)
数字的减少要使用“降低了”、“降低到”。“了”表示增量,“到”表示定量。
降低到百分之八十
(定额是一百,现在是八十)
降低了百分之八十
(原来是一百,现在是二十)
不能用“降低 N 倍”或“减少 N 倍”的表示法,要用“降低百分之几”或“减少百分之几”。因为减少(或降低)一倍表示数值原来为一百,现在等于零。
注意,学习搬运于:https://github.com/ruanyf/document-style-guide