通過本文,你將瞭解到中文技術文檔中段落和數值的寫法。
段落
原則
- 一個段落只能有一個主題,或一箇中心句子。
- 段落的中心句子放在段首,對全段內容進行概述。後面陳述的句子爲核心句服務。
- 一個段落的長度不能超過七行,最佳段落長度小於等於四行。
- 段落的句子語氣要使用陳述和肯定語氣,避免使用感嘆語氣。
- 段落之間使用一個空行隔開。
- 段落開頭不要留出空白字符。
引用
引用第三方內容時,應註明出處。
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