【中文技术文档的写作规范_P02】如何排版文档的段落和书写数值

通过本文，你将了解到中文技术文档中段落和数值的写法。

段落

原则

• 一个段落只能有一个主题，或一个中心句子。
• 段落的中心句子放在段首，对全段内容进行概述。后面陈述的句子为核心句服务。
• 一个段落的长度不能超过七行，最佳段落长度小于等于四行。
• 段落的句子语气要使用陈述和肯定语气，避免使用感叹语气。
• 段落之间使用一个空行隔开。
• 段落开头不要留出空白字符。

引用

引用第三方内容时，应注明出处。

One man’s constant is another man’s variable. — Alan Perlis

如果是全篇转载，请在全文开头显著位置注明作者和出处，并链接至原文。

本文转载自 WikiQuote

使用外部图片时，必须在图片下方或文末标明来源。

本文部分图片来自 Wikipedia

数值

半角数字

阿拉伯数字一律使用半角形式，不得使用全角形式。

错误： 这件商品的价格是１０００元。

正确： 这件商品的价格是 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