{
"title": "中文文案排版指北",
"tags": [
"post",
"开发规范"
],
"summary": "这是中文文档规范",
"sources": [
"xlog"
],
"external_urls": [
"https://blog.wel.one/zhong-wen-wen-an-pai-ban-zhi-bei-.md"
],
"date_published": "2023-03-14T08:24:55.103Z",
"content": "# 中文文案排版指北\n\n统一中文文案、排版的相关用法，降低团队成员之间的沟通成本，增强网站气质。\n\nOther languages:\n\n- [英语](README.en.md)\n- [繁体中文](README.md)\n- [简体中文](README.zh-Hans.md)\n\n* * *\n\n## 空格\n\n> 「有研究显示，打字的时候不喜欢在中文和英文之间加空格的人，感情路都走得很辛苦，有七成的比例会在 34 岁的时候跟自己不爱的人结婚，而其余三成的人最后只能把遗产留给自己的猫。毕竟爱情跟书写都需要适时地留白。\n>\n> 与大家共勉之。」——[vinta/paranoid-auto-spacing](https://github.com/vinta/pangu.js)\n\n### 中英文之间需要增加空格\n\n正确：\n\n> 在 LeanCloud 上，数据存储是围绕 `AVObject` 进行的。\n\n错误：\n\n> 在LeanCloud上，数据存储是围绕`AVObject`进行的。\n>\n> 在 LeanCloud上，数据存储是围绕`AVObject` 进行的。\n\n完整的正确用法：\n\n> 在 LeanCloud 上，数据存储是围绕 `AVObject` 进行的。每个 `AVObject` 都包含了与 JSON 兼容的 key-value 对应的数据。数据是 schema-free 的，你不需要在每个 `AVObject` 上提前指定存在哪些键，只要直接设定对应的 key-value 即可。\n\n例外：「豆瓣FM」等产品名词，按照官方所定义的格式书写。\n\n### 中文与数字之间需要增加空格\n\n正确：\n\n> 今天出去买菜花了 5000 元。\n\n错误：\n\n> 今天出去买菜花了 5000元。\n>\n> 今天出去买菜花了5000元。\n\n### 数字与单位之间需要增加空格\n\n正确：\n\n> 我家的光纤入屋宽带有 10 Gbps，SSD 一共有 20 TB\n\n错误：\n\n> 我家的光纤入屋宽带有 10Gbps，SSD 一共有 20TB\n\n例外：度数／百分比与数字之间不需要增加空格：\n\n正确：\n\n> 角度为 90° 的角，就是直角。\n>\n> 新 MacBook Pro 有 15% 的 CPU 性能提升。\n\n错误：\n\n> 角度为 90 ° 的角，就是直角。\n>\n> 新 MacBook Pro 有 15 % 的 CPU 性能提升。\n\n### 全角标点与其他字符之间不加空格\n\n正确：\n\n> 刚刚买了一部 iPhone，好开心！\n\n错误：\n\n> 刚刚买了一部 iPhone ，好开心！\n>\n> 刚刚买了一部 iPhone， 好开心！\n\n### 用 `text-spacing` 来挽救？\n\nCSS Text Module Level 4 的 [`text-spacing`](https://www.w3.org/TR/css-text-4/#text-spacing-property) 和 Microsoft 的 [`-ms-text-autospace`](https://msdn.microsoft.com/library/ms531164(v=vs.85).aspx) 可以实现自动为中英文之间增加空白。不过目前并未普及，另外在其他应用场景，例如 macOS、iOS、Windows 等用户界面目前并不存在这个特性，所以请继续保持随手加空格的习惯。\n\n## 标点符号\n\n### 不重复使用标点符号\n\n即使中国大陆的标点符号用法允许重复使用标点符号，但是这么做会破坏句子的美观性。\n\n正确：\n\n> 德国队竟然战胜了巴西队！\n>\n> 她竟然对你说「喵」？！\n\n错误：\n\n> 德国队竟然战胜了巴西队！！\n>\n> 德国队竟然战胜了巴西队！！！！！！！！\n>\n> 她竟然对你说「喵」？？！！\n>\n> 她竟然对你说「喵」？！？！？？！！\n\n## 全角和半角\n\n不明白什么是全角（全形）与半角（半形）符号？请查看维基百科条目『[全角和半角](https://zh.wikipedia.org/wiki/%E5%85%A8%E5%BD%A2%E5%92%8C%E5%8D%8A%E5%BD%A2)』。\n\n### 使用全角中文标点\n\n正确：\n\n> 嗨！你知道嘛？今天前台的小妹跟我说「喵」了哎！\n>\n> 核磁共振成像（NMRI）是什么原理都不知道？JFGI！\n\n错误：\n\n> 嗨! 你知道嘛? 今天前台的小妹跟我说 \"喵\" 了哎！\n>\n> 嗨!你知道嘛?今天前台的小妹跟我说\"喵\"了哎！\n>\n> 核磁共振成像 (NMRI) 是什么原理都不知道? JFGI!\n>\n> 核磁共振成像(NMRI)是什么原理都不知道?JFGI!\n\n### 数字使用半角字符\n\n正确：\n\n> 这个蛋糕只卖 1000 元。\n\n错误：\n\n> 这个蛋糕只卖 １０００ 元。\n\n例外：在设计稿、宣传海报中如出现极少量数字的情形时，为方便文字对齐，是可以使用全角数字的。\n\n### 遇到完整的英文整句、特殊名词，其内容使用半角标点\n\n正确：\n\n> 乔布斯那句话是怎么说的？「Stay hungry, stay foolish.」\n>\n> 推荐你阅读《Hackers & Painters: Big Ideas from the Computer Age》，非常的有趣。\n\n错误：\n\n> 乔布斯那句话是怎么说的？「Stay hungry，stay foolish。」\n>\n> 推荐你阅读《Hackers＆Painters：Big Ideas from the Computer Age》，非常的有趣。\n\n## 名词\n\n### 专有名词使用正确的大小写\n\n大小写相关用法原属于英文书写范畴，不属于本 wiki 讨论内容，在这里只对部分易错用法进行简述。\n\n正确：\n\n> 使用 GitHub 登录\n>\n> 我们的客户有 GitHub、Foursquare、Microsoft Corporation、Google、Facebook, Inc.。\n\n错误：\n\n> 使用 github 登录\n>\n> 使用 GITHUB 登录\n>\n> 使用 Github 登录\n>\n> 使用 gitHub 登录\n>\n> 使用 gｲんĤЦ8 登录\n>\n> 我们的客户有 github、foursquare、microsoft corporation、google、facebook, inc.。\n>\n> 我们的客户有 GITHUB、FOURSQUARE、MICROSOFT CORPORATION、GOOGLE、FACEBOOK, INC.。\n>\n> 我们的客户有 Github、FourSquare、MicroSoft Corporation、Google、FaceBook, Inc.。\n>\n> 我们的客户有 gitHub、fourSquare、microSoft Corporation、google、faceBook, Inc.。\n>\n> 我们的客户有 gｲんĤЦ8、ｷouЯƧquﾑгє、๓เςг๏ร๏Ŧt ς๏гק๏гคtเ๏ภn、900913、ƒ4ᄃëв๏๏к, IПᄃ.。\n\n注意：当网页中需要配合整体视觉风格而出现全部大写／小写的情形，HTML 中请使用标淮的大小写规范进行书写；并通过 `text-transform: uppercase;`／`text-transform: lowercase;` 对表现形式进行定义。\n\n### 不要使用不地道的缩写\n\n正确：\n\n> 我们需要一位熟悉 TypeScript、HTML5，至少理解一种框架（如 React、Next.js）的前端开发者。\n\n错误：\n\n> 我们需要一位熟悉 Ts、h5，至少理解一种框架（如 RJS、nextjs）的 FED。\n\n## 争议\n\n以下用法略带有个人色彩，即：无论是否遵循下述规则，从语法的角度来讲都是**正确**的。\n\n### 链接之间增加空格\n\n用法：\n\n> 请 [提交一个 issue](#) 并分配给相关同事。\n>\n> 访问我们网站的最新动态，请 [点击这里](#) 进行订阅！\n\n对比用法：\n\n> 请[提交一个 issue](#)并分配给相关同事。\n>\n> 访问我们网站的最新动态，请[点击这里](#)进行订阅！\n\n### 简体中文使用直角引号\n\n用法：\n\n> 「老师，『有条不紊』的『紊』是什么意思？」\n\n对比用法：\n\n> “老师，‘有条不紊’的‘紊’是什么意思？”\n\n## 工具\n\n仓库 | 系列 | 语言\n--- | ---- | ---\n[pangu.js](https://github.com/vinta/pangu.js) | pangu | JavaScript\n[pangu-go](https://github.com/vinta/pangu) | pangu | Go\n[pangu.java](https://github.com/vinta/pangu.java) | pangu | Java\n[pangu.py](https://github.com/vinta/pangu.py) | pangu | Python\n[pangu.rb](https://github.com/dlackty/pangu.rb) | pangu | Ruby\n[pangu.php](https://github.com/cchlorine/pangu.php) | pangu | PHP\n[pangu.vim](https://github.com/hotoo/pangu.vim) | pangu | Vim\n[vue-pangu](https://github.com/serkodev/vue-pangu) | pangu | Vue.js (Web Converter)\n[autocorrect](https://github.com/huacnlee/autocorrect) | autocorrect | Rust, WASM, CLI tool\n[autocorrect-node](https://github.com/huacnlee/autocorrect/tree/main/autocorrect-node) | autocorrect | Node.js\n[autocorrect-py](https://github.com/huacnlee/autocorrect/tree/main/autocorrect-py) | autocorrect | Python\n[autocorrect-rb](https://github.com/huacnlee/autocorrect/tree/main/autocorrect-rb) | autocorrect | Ruby\n[autocorrect-java](https://github.com/huacnlee/autocorrect/tree/main/autocorrect-java) | autocorrect | Java\n[autocorrect-go](https://github.com/longbridgeapp/autocorrect) | autocorrect | Go\n[autocorrect-php](https://github.com/NauxLiu/auto-correct) | autocorrect | PHP\n[autocorrect-vscode](https://marketplace.visualstudio.com/items?itemName=huacnlee.autocorrect) | autocorrect | VS Code Extension\n[autocorrect-idea-plugin](https://plugins.jetbrains.com/plugin/20244-autocorrect) | autocorrect | Intellij Platform Plugin\n[jxlwqq/chinese-typesetting](https://github.com/jxlwqq/chinese-typesetting) | other | PHP\n[sparanoid/space-lover](https://github.com/sparanoid/space-lover) | other | PHP (WordPress)\n[sparanoid/grunt-auto-spacing](https://github.com/sparanoid/grunt-auto-spacing) | other | Node.js (Grunt)\n[hjiang/scripts/add-space-between-latin-and-cjk](https://github.com/hjiang/scripts/blob/master/add-space-between-latin-and-cjk) | other | Python\n[hustcc/hint](https://github.com/hustcc/hint) | other | Python\n[n0vad3v/Tekorrect](https://github.com/n0vad3v/Tekorrect) | other | Python\n\n## 谁在这样做？\n\n网站 | 文案 | UGC\n--- | --- | ---\n[Apple 中国](https://www.apple.com/cn/) | 是 | N/A\n[Apple 香港](https://www.apple.com/hk/) | 是 | N/A\n[Apple 台湾](https://www.apple.com/tw/) | 是 | N/A\n[Microsoft 中国](https://www.microsoft.com/zh-cn/) | 是 | N/A\n[Microsoft 香港](https://www.microsoft.com/zh-hk/) | 是 | N/A\n[Microsoft 台湾](https://www.microsoft.com/zh-tw/) | 是 | N/A\n[LeanCloud](https://leancloud.cn/) | 是 | N/A\n[V2EX](https://www.v2ex.com/) | 是 | 是\n[Apple4us](https://apple4us.com/) | 是 | N/A\n[Ruby China](https://ruby-china.org/) | 是 | 是\n[少数派](https://sspai.com/) | 是 | N/A\n\n## 参考文献\n\n- [Guidelines for Using Capital Letters - ThoughtCo.](https://www.thoughtco.com/guidelines-for-using-capital-letters-1691724)\n- [Letter case - Wikipedia](https://en.wikipedia.org/wiki/Letter_case)\n- [Punctuation - Oxford Dictionaries](https://en.oxforddictionaries.com/grammar/punctuation)\n- [Punctuation - The Purdue OWL](https://owl.english.purdue.edu/owl/section/1/6/)\n- [How to Use English Punctuation Correctly - wikiHow](https://www.wikihow.com/Use-English-Punctuation-Correctly)\n- [格式 - openSUSE](https://zh.opensuse.org/index.php?title=Help:%E6%A0%BC%E5%BC%8F)\n- [全形和半形 - 维基百科](https://zh.wikipedia.org/wiki/%E5%85%A8%E5%BD%A2%E5%92%8C%E5%8D%8A%E5%BD%A2)\n- [引号 - 维基百科](https://zh.wikipedia.org/wiki/%E5%BC%95%E8%99%9F)\n- [疑问惊叹号 - 维基百科](https://zh.wikipedia.org/wiki/%E7%96%91%E5%95%8F%E9%A9%9A%E5%98%86%E8%99%9F)\n\n## Forks\n\n衍生项目的用法可能与本项目存在差异。\n\n- [mzlogin/chinese-copywriting-guidelines](https://github.com/mzlogin/chinese-copywriting-guidelines)",
"attributes": [
{
"value": "zhong-wen-wen-an-pai-ban-zhi-bei-.md",
"trait_type": "xlog_slug"
}
]
}
