mirror of
https://github.com/sparanoid/chinese-copywriting-guidelines.git
synced 2026-04-05 20:51:24 +08:00
Compare commits
12 Commits
renovate/r
...
l10n-maste
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
9b081cac6a | ||
|
|
106e52bc04 | ||
|
|
af27dc8f68 | ||
|
|
9beb0f6051 | ||
|
|
c228850b5f | ||
|
|
e257c91cfc | ||
|
|
6a1aaa78a4 | ||
|
|
a279286e85 | ||
|
|
9e6f52bbc0 | ||
|
|
fc73952c49 | ||
|
|
6fe89f70ec | ||
|
|
1cdfdbf9d1 |
8
.github/FUNDING.yml
vendored
Normal file
8
.github/FUNDING.yml
vendored
Normal file
@@ -0,0 +1,8 @@
|
|||||||
|
# These are supported funding model platforms
|
||||||
|
|
||||||
|
github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
|
||||||
|
patreon: # Replace with a single Patreon username
|
||||||
|
open_collective: # Replace with a single Open Collective username
|
||||||
|
ko_fi: # Replace with a single Ko-fi username
|
||||||
|
tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
|
||||||
|
custom: https://sparanoid.com/donate/
|
||||||
11
.github/dependabot.yml
vendored
11
.github/dependabot.yml
vendored
@@ -1,11 +0,0 @@
|
|||||||
# To get started with Dependabot version updates, you'll need to specify which
|
|
||||||
# package ecosystems to update and where the package manifests are located.
|
|
||||||
# Please see the documentation for all configuration options:
|
|
||||||
# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
|
|
||||||
|
|
||||||
version: 2
|
|
||||||
updates:
|
|
||||||
- package-ecosystem: "github-actions"
|
|
||||||
directory: "/"
|
|
||||||
schedule:
|
|
||||||
interval: "daily"
|
|
||||||
47
.github/workflows/test.yml
vendored
47
.github/workflows/test.yml
vendored
@@ -1,47 +0,0 @@
|
|||||||
name: Test
|
|
||||||
|
|
||||||
on:
|
|
||||||
push:
|
|
||||||
branches:
|
|
||||||
- 'master'
|
|
||||||
tags:
|
|
||||||
- 'v*'
|
|
||||||
pull_request:
|
|
||||||
branches:
|
|
||||||
- 'master'
|
|
||||||
|
|
||||||
jobs:
|
|
||||||
test:
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v3
|
|
||||||
- uses: actions/setup-node@v3
|
|
||||||
with:
|
|
||||||
node-version: 20
|
|
||||||
|
|
||||||
- uses: pnpm/action-setup@v2
|
|
||||||
name: Install pnpm
|
|
||||||
id: pnpm-install
|
|
||||||
with:
|
|
||||||
version: latest
|
|
||||||
run_install: false
|
|
||||||
|
|
||||||
- name: Get pnpm store directory
|
|
||||||
id: pnpm-cache
|
|
||||||
shell: bash
|
|
||||||
run: |
|
|
||||||
echo "STORE_PATH=$(pnpm store path)" >> $GITHUB_OUTPUT
|
|
||||||
|
|
||||||
- uses: actions/cache@v3
|
|
||||||
name: Setup pnpm cache
|
|
||||||
with:
|
|
||||||
path: ${{ steps.pnpm-cache.outputs.STORE_PATH }}
|
|
||||||
key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
|
|
||||||
restore-keys: |
|
|
||||||
${{ runner.os }}-pnpm-store-
|
|
||||||
|
|
||||||
- name: Install dependencies
|
|
||||||
run: pnpm install
|
|
||||||
|
|
||||||
- name: Run test
|
|
||||||
run: pnpm test
|
|
||||||
38
Gruntfile.coffee
Normal file
38
Gruntfile.coffee
Normal file
@@ -0,0 +1,38 @@
|
|||||||
|
"use strict"
|
||||||
|
module.exports = (grunt) ->
|
||||||
|
|
||||||
|
# Load all grunt tasks
|
||||||
|
require("matchdep").filterDev("grunt-*").forEach grunt.loadNpmTasks
|
||||||
|
|
||||||
|
# Project configurations
|
||||||
|
grunt.initConfig
|
||||||
|
config:
|
||||||
|
pkg: grunt.file.readJSON("package.json")
|
||||||
|
|
||||||
|
"npm-contributors":
|
||||||
|
options:
|
||||||
|
commitMessage: "feat(package): update contributors"
|
||||||
|
|
||||||
|
conventionalChangelog:
|
||||||
|
options:
|
||||||
|
changelogOpts:
|
||||||
|
preset: "angular"
|
||||||
|
|
||||||
|
dist:
|
||||||
|
src: "CHANGELOG.md"
|
||||||
|
|
||||||
|
bump:
|
||||||
|
options:
|
||||||
|
files: ["package.json"]
|
||||||
|
commitMessage: 'chore: release v%VERSION%'
|
||||||
|
commitFiles: ["-a"]
|
||||||
|
tagMessage: 'chore: create tag %VERSION%'
|
||||||
|
push: false
|
||||||
|
|
||||||
|
grunt.registerTask "default", "Default task aka. build task", (type) ->
|
||||||
|
grunt.task.run [
|
||||||
|
"npm-contributors"
|
||||||
|
"bump-only:#{type or 'patch'}"
|
||||||
|
"conventionalChangelog"
|
||||||
|
"bump-commit"
|
||||||
|
]
|
||||||
2
LICENSE
2
LICENSE
@@ -1,6 +1,6 @@
|
|||||||
MIT License
|
MIT License
|
||||||
|
|
||||||
Copyright (c) 2023 Sparanoid, Inc.
|
Copyright (c) 2018 Sparanoid, Inc.
|
||||||
|
|
||||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
of this software and associated documentation files (the "Software"), to deal
|
of this software and associated documentation files (the "Software"), to deal
|
||||||
|
|||||||
287
README.en-US.md
Normal file
287
README.en-US.md
Normal file
@@ -0,0 +1,287 @@
|
|||||||
|
# Chinese Copywriting Guidelines
|
||||||
|
|
||||||
|
[](https://crowdin.com/project/chinese-copywriting-guidelines) [](https://greenkeeper.io/) [](https://david-dm.org/sparanoid/chinese-copywriting-guidelines#info=devDependencies) [](https://sparanoid.com/note/chinese-copywriting-guidelines/)
|
||||||
|
|
||||||
|
Chinese copywriting guidelines for better written communication.
|
||||||
|
|
||||||
|
Other languages:
|
||||||
|
|
||||||
|
- [English](README.en-US.md)
|
||||||
|
- [Chinese Traditional](README.md)
|
||||||
|
- [Chinese Simplified](README.zh-CN.md)
|
||||||
|
- [Chinese Simplified](https://github.com/mzlogin/chinese-copywriting-guidelines) (External Link)
|
||||||
|
|
||||||
|
* * *
|
||||||
|
|
||||||
|
## Table of Contents
|
||||||
|
|
||||||
|
{:.no_toc}
|
||||||
|
|
||||||
|
- TOC {:toc}
|
||||||
|
|
||||||
|
## Spacing
|
||||||
|
|
||||||
|
> 「有研究顯示,打字的時候不喜歡在中文和英文之間加空格的人,感情路都走得很辛苦,有七成的比例會在 34 歲的時候跟自己不愛的人結婚,而其餘三成的人最後只能把遺產留給自己的貓。畢竟愛情跟書寫都需要適時地留白。
|
||||||
|
>
|
||||||
|
> 與大家共勉之。」——[vinta/paranoid-auto-spacing](https://github.com/vinta/pangu.js)
|
||||||
|
|
||||||
|
### Place one space before/after English words
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 在 LeanCloud 上,數據存儲是圍繞 `AVObject` 進行的。
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 在LeanCloud上,數據存儲是圍繞`AVObject`進行的。
|
||||||
|
>
|
||||||
|
> 在 LeanCloud上,數據存儲是圍繞`AVObject` 進行的。
|
||||||
|
|
||||||
|
完整的正確用法:
|
||||||
|
|
||||||
|
> 在 LeanCloud 上,數據儲存是圍繞 `AVObject` 進行的。每個 `AVObject` 都包含了與 JSON 兼容的 key-value 對應的數據。數據是 schema-free 的,你不需要在每個 `AVObject` 上提前指定存在哪些键,只要直接設定對應的 key-value 即可。
|
||||||
|
|
||||||
|
例外:「豆瓣FM」等產品名詞,按照官方所定義的格式書寫。
|
||||||
|
|
||||||
|
### Place one space before/after numbers
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 今天出去買菜花了 5000 元。
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 今天出去買菜花了 5000元。
|
||||||
|
>
|
||||||
|
> 今天出去買菜花了5000元。
|
||||||
|
|
||||||
|
### Place one space between numbers and units
|
||||||
|
|
||||||
|
Good:
|
||||||
|
|
||||||
|
> 我家的光纖入屋寬頻有 10 Gbps,SSD 一共有 20 TB。
|
||||||
|
|
||||||
|
Bad:
|
||||||
|
|
||||||
|
> 我家的光纖入屋寬頻有 10Gbps,SSD 一共有 20TB。
|
||||||
|
|
||||||
|
例外:度/百分比與數字之間不需要增加空格:
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 今天是 233° 的高溫。
|
||||||
|
>
|
||||||
|
> 新 MacBook Pro 有 15% 的 CPU 性能提升。
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 今天是 233 ° 的高溫。
|
||||||
|
>
|
||||||
|
> 新 MacBook Pro 有 15 % 的 CPU 性能提升。
|
||||||
|
|
||||||
|
### No additional spaces before/after punctuation in fullwidth form
|
||||||
|
|
||||||
|
Good:
|
||||||
|
|
||||||
|
> 剛剛買了一部 iPhone,好開心!
|
||||||
|
|
||||||
|
Bad:
|
||||||
|
|
||||||
|
> 剛剛買了一部 iPhone ,好開心!
|
||||||
|
>
|
||||||
|
> 剛剛買了一部 iPhone, 好開心!
|
||||||
|
|
||||||
|
### `text-spacing` to the rescue?
|
||||||
|
|
||||||
|
CSS 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 等用戶介面目前并不存在這個特性,所以請繼續保持隨手加空格的習慣。
|
||||||
|
|
||||||
|
## Punctuation
|
||||||
|
|
||||||
|
### Avoid duplicate punctuation
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 德國隊竟然戰勝了巴西隊!
|
||||||
|
>
|
||||||
|
> 她竟然對你說「喵」?!
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 德國隊竟然戰勝了巴西隊!!
|
||||||
|
>
|
||||||
|
> 德國隊竟然戰勝了巴西隊!!!!!!!!
|
||||||
|
>
|
||||||
|
> 她竟然對你說「喵」??!!
|
||||||
|
>
|
||||||
|
> 她竟然對你說「喵」?!?!??!!
|
||||||
|
|
||||||
|
## Fullwidth and halfwidth
|
||||||
|
|
||||||
|
不明白什麼是全形(全角)與半形(半角)符號?請查看維基百科詞條『[全形和半形](https://zh.wikipedia.org/wiki/%E5%85%A8%E5%BD%A2%E5%92%8C%E5%8D%8A%E5%BD%A2)』。
|
||||||
|
|
||||||
|
### Use punctuation in fullwidth form
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 嗨!你知道嘛?今天前台的小妹跟我說「喵」了哎!
|
||||||
|
>
|
||||||
|
> 核磁共振成像(NMRI)是什麼原理都不知道?JFGI!
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 嗨! 你知道嘛? 今天前台的小妹跟我說 "喵" 了哎!
|
||||||
|
>
|
||||||
|
> 嗨!你知道嘛?今天前台的小妹跟我說"喵"了哎!
|
||||||
|
>
|
||||||
|
> 核磁共振成像 (NMRI) 是什麼原理都不知道? JFGI!
|
||||||
|
>
|
||||||
|
> 核磁共振成像(NMRI)是什麼原理都不知道?JFGI!
|
||||||
|
|
||||||
|
### Use numbers in halfwidth form
|
||||||
|
|
||||||
|
Good:
|
||||||
|
|
||||||
|
> 這件蛋糕只賣 1000 元。
|
||||||
|
|
||||||
|
Bad:
|
||||||
|
|
||||||
|
> 這件蛋糕只賣 1000 元。
|
||||||
|
|
||||||
|
例外:在設計稿、宣傳海報中如出現極少量數字的情形時,為方便文字對齊,是可以使用全形數字的。
|
||||||
|
|
||||||
|
### Use punctuation in halfwidth form for English sentences
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 賈伯斯那句話是怎麼說的?「Stay hungry, stay foolish.」
|
||||||
|
>
|
||||||
|
> 推薦你閱讀《Hackers & Painters: Big Ideas from the Computer Age》,非常的有趣。
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 賈伯斯那句話是怎麼說的?「Stay hungry,stay foolish。」
|
||||||
|
>
|
||||||
|
> 推薦你閱讀《Hackers&Painters:Big Ideas from the Computer Age》,非常的有趣。
|
||||||
|
|
||||||
|
## Nouns
|
||||||
|
|
||||||
|
### 專有名詞使用正確的大小寫
|
||||||
|
|
||||||
|
大小寫相關用法原屬於英文書寫範疇,不屬於本 wiki 討論內容,在這裡只對部分易錯用法進行簡述。
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 使用 GitHub 登錄
|
||||||
|
>
|
||||||
|
> 我們的客戶有 GitHub、Foursquare、Microsoft Corporation、Google、Facebook, Inc.。
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 使用 github 登錄
|
||||||
|
>
|
||||||
|
> 使用 GITHUB 登錄
|
||||||
|
>
|
||||||
|
> 使用 Github 登錄
|
||||||
|
>
|
||||||
|
> 使用 gitHub 登錄
|
||||||
|
>
|
||||||
|
> 使用 gイんĤЦ8 登錄
|
||||||
|
>
|
||||||
|
> 我們的客戶有 github、foursquare、microsoft corporation、google、facebook, inc.。
|
||||||
|
>
|
||||||
|
> 我們的客戶有 GITHUB、FOURSQUARE、MICROSOFT CORPORATION、GOOGLE、FACEBOOK, INC.。
|
||||||
|
>
|
||||||
|
> 我們的客戶有 Github、FourSquare、MicroSoft Corporation、Google、FaceBook, Inc.。
|
||||||
|
>
|
||||||
|
> 我們的客戶有 gitHub、fourSquare、microSoft Corporation、google、faceBook, Inc.。
|
||||||
|
>
|
||||||
|
> 我們的客戶有 gイんĤЦ8、キouЯƧquムгє、๓เςг๏ร๏Ŧt ς๏гק๏гคtเ๏ภn、900913、ƒ4ᄃëв๏๏к, IПᄃ.。
|
||||||
|
|
||||||
|
注意:當網頁中需要配合整體視覺風格而出現全部大寫/小寫的情形,HTML 中請使用標準的大小寫規範進行書寫;並通過 `text-transform: uppercase;`/`text-transform: lowercase;` 對表現形式進行定義。
|
||||||
|
|
||||||
|
### Avoid jargons
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 我們需要一位熟悉 JavaScript、HTML5,至少理解一種框架(如 Backbone.js、AngularJS、React 等)的前端開發者。
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 我們需要一位熟悉 Js、h5,至少理解一種框架(如 backbone、angular、RJS 等)的 FED。
|
||||||
|
|
||||||
|
## Dispute
|
||||||
|
|
||||||
|
以下用法略帶有個人色彩,即:無論是否遵循下述規則,從語法的角度來講都是**正確**的。
|
||||||
|
|
||||||
|
### 超連結之間增加空格
|
||||||
|
|
||||||
|
用法:
|
||||||
|
|
||||||
|
> 請 [提交一個 issue](#) 並分配给相關同事。
|
||||||
|
>
|
||||||
|
> 訪問我們網站的最新動態,請 [點擊這裡](#) 進行訂閱!
|
||||||
|
|
||||||
|
對比用法:
|
||||||
|
|
||||||
|
> 請[提交一個 issue](#) 並分配给相關同事。
|
||||||
|
>
|
||||||
|
> 訪問我們網站的最新動態,請[點擊這裡](#)進行訂閱!
|
||||||
|
|
||||||
|
### Use corner brackets for Chinese Simplified
|
||||||
|
|
||||||
|
Usage:
|
||||||
|
|
||||||
|
> 「老師,『有條不紊』的『紊』是什麼意思?」
|
||||||
|
|
||||||
|
compared with:
|
||||||
|
|
||||||
|
> “老師,‘有條不紊’的‘紊’是什麼意思?”
|
||||||
|
|
||||||
|
## Tools
|
||||||
|
|
||||||
|
| Repository | Language |
|
||||||
|
| ------------------------------------------------------------------------------------------------------------------------------- | ----------------- |
|
||||||
|
| [vinta/paranoid-auto-spacing](https://github.com/vinta/paranoid-auto-spacing) | JavaScript |
|
||||||
|
| [huei90/pangu.node](https://github.com/huei90/pangu.node) | Node.js |
|
||||||
|
| [huacnlee/auto-correct](https://github.com/huacnlee/auto-correct) | Ruby |
|
||||||
|
| [huacnlee/autocorrect](https://github.com/huacnlee/autocorrect) | Rust, WASM, CLI |
|
||||||
|
| [huacnlee/go-auto-correct](https://github.com/huacnlee/go-auto-correct) | Go |
|
||||||
|
| [sparanoid/space-lover](https://github.com/sparanoid/space-lover) | PHP (WordPress) |
|
||||||
|
| [nauxliu/auto-correct](https://github.com/NauxLiu/auto-correct) | PHP |
|
||||||
|
| [jxlwqq/chinese-typesetting](https://github.com/jxlwqq/chinese-typesetting) | PHP |
|
||||||
|
| [hotoo/pangu.vim](https://github.com/hotoo/pangu.vim) | Vim |
|
||||||
|
| [sparanoid/grunt-auto-spacing](https://github.com/sparanoid/grunt-auto-spacing) | Node.js (Grunt) |
|
||||||
|
| [hjiang/scripts/add-space-between-latin-and-cjk](https://github.com/hjiang/scripts/blob/master/add-space-between-latin-and-cjk) | Python |
|
||||||
|
| [hustcc/hint](https://github.com/hustcc/hint) | Python |
|
||||||
|
| [studygolang/autocorrect](https://github.com/studygolang/autocorrect) | Go |
|
||||||
|
| [n0vad3v/Tekorrect](https://github.com/n0vad3v/Tekorrect) | Python |
|
||||||
|
| [VS Code - huacnlee.auto-correct](https://marketplace.visualstudio.com/items?itemName=huacnlee.auto-correct) | VS Code Extension |
|
||||||
|
|
||||||
|
## Examples of “Who is doing this?”
|
||||||
|
|
||||||
|
| Website | Copywriting | UGC |
|
||||||
|
| ------------------------------------------------------- | ----------- | ----------- |
|
||||||
|
| [Apple China](https://www.apple.com/cn/) | Yes | N/A |
|
||||||
|
| [Apple Hong Kong](https://www.apple.com/hk/) | Yes | N/A |
|
||||||
|
| [Apple Taiwan](https://www.apple.com/tw/) | Yes | N/A |
|
||||||
|
| [Microsoft China](https://www.microsoft.com/zh-cn/) | Yes | N/A |
|
||||||
|
| [Microsoft Hong Kong](https://www.microsoft.com/zh-hk/) | Yes | N/A |
|
||||||
|
| [Microsoft Taiwan](https://www.microsoft.com/zh-tw/) | Yes | N/A |
|
||||||
|
| [LeanCloud](https://leancloud.cn/) | Yes | N/A |
|
||||||
|
| [V2EX](https://www.v2ex.com/) | Yes | Yes |
|
||||||
|
| [Apple4us](https://apple4us.com/) | Yes | N/A |
|
||||||
|
| [Ruby China](https://ruby-china.org/) | Yes | Yes |
|
||||||
|
| [PHPHub](https://phphub.org/) | Yes | Titles only |
|
||||||
|
| [少數派](https://sspai.com/) | Yes | N/A |
|
||||||
|
|
||||||
|
## References
|
||||||
|
|
||||||
|
- [Guidelines for Using Capital Letters - ThoughtCo.](https://www.thoughtco.com/guidelines-for-using-capital-letters-1691724)
|
||||||
|
- [Letter case - Wikipedia](https://en.wikipedia.org/wiki/Letter_case)
|
||||||
|
- [Punctuation - Oxford Dictionaries](https://en.oxforddictionaries.com/grammar/punctuation)
|
||||||
|
- [Punctuation - The Purdue OWL](https://owl.english.purdue.edu/owl/section/1/6/)
|
||||||
|
- [How to Use English Punctuation Correctly - wikiHow](https://www.wikihow.com/Use-English-Punctuation-Correctly)
|
||||||
|
- [格式 - openSUSE](https://zh.opensuse.org/index.php?title=Help:%E6%A0%BC%E5%BC%8F)
|
||||||
|
- [Halfwidth and fullwidth forms - Wikipedia](https://en.wikipedia.org/wiki/Halfwidth_and_fullwidth_forms)
|
||||||
|
- [引號 - 維基百科](https://zh.wikipedia.org/wiki/%E5%BC%95%E8%99%9F)
|
||||||
|
- [Interrobang - Wikipedia](https://en.wikipedia.org/wiki/Interrobang)
|
||||||
296
README.en.md
296
README.en.md
@@ -1,296 +0,0 @@
|
|||||||
# Chinese Copywriting Guidelines
|
|
||||||
|
|
||||||
Chinese copywriting guidelines for better written communication.
|
|
||||||
|
|
||||||
Other languages:
|
|
||||||
|
|
||||||
- [English](README.en.md)
|
|
||||||
- [Chinese Traditional](README.md)
|
|
||||||
- [Chinese Simplified](README.zh-Hans.md)
|
|
||||||
|
|
||||||
* * *
|
|
||||||
|
|
||||||
## Spacing
|
|
||||||
|
|
||||||
> Research shows that, people adding no space between Chinese and English suffer from pathetic relationships. 70% of them are married by the age of 34, with someone they don't love; 30% of them left everything for their cats and died. Blank spaces are essential to both romance and writing.
|
|
||||||
>
|
|
||||||
> 與大家共勉之。」——[vinta/paranoid-auto-spacing](https://github.com/vinta/pangu.js)
|
|
||||||
|
|
||||||
### Place one space before/after English words
|
|
||||||
|
|
||||||
Good:
|
|
||||||
|
|
||||||
> 在 LeanCloud 上,數據儲存是圍繞 `AVObject` 進行的。
|
|
||||||
|
|
||||||
Bad:
|
|
||||||
|
|
||||||
> 在LeanCloud上,數據儲存是圍繞`AVObject`進行的。
|
|
||||||
>
|
|
||||||
> 在 LeanCloud上,數據儲存是圍繞`AVObject` 進行的。
|
|
||||||
|
|
||||||
An example of complete and correct usage:
|
|
||||||
|
|
||||||
> 在 LeanCloud 上,數據儲存是圍繞 `AVObject` 進行的。每個 `AVObject` 都包含了與 JSON 兼容的 key-value 對應的數據。數據是 schema-free 的,你不需要在每個 `AVObject` 上提前指定存在哪些键,只要直接設定對應的 key-value 即可。
|
|
||||||
|
|
||||||
Exceptions: For product and brand names, please refer to the writing format of the official definition. For example, use “豆瓣FM” instead of “豆瓣 FM”.
|
|
||||||
|
|
||||||
### Place one space before/after numbers
|
|
||||||
|
|
||||||
Good:
|
|
||||||
|
|
||||||
> 今天出去買菜花了 5000 元。
|
|
||||||
|
|
||||||
Bad:
|
|
||||||
|
|
||||||
> 今天出去買菜花了 5000元。
|
|
||||||
>
|
|
||||||
> 今天出去買菜花了5000元。
|
|
||||||
|
|
||||||
### Place one space between numbers and units
|
|
||||||
|
|
||||||
Good:
|
|
||||||
|
|
||||||
> 我家的光纖入屋寬頻有 10 Gbps,SSD 一共有 20 TB。
|
|
||||||
|
|
||||||
Bad:
|
|
||||||
|
|
||||||
> 我家的光纖入屋寬頻有 10Gbps,SSD 一共有 20TB。
|
|
||||||
|
|
||||||
Exceptions: There should not be any spacing between numbers and degrees/percentages.
|
|
||||||
|
|
||||||
Good:
|
|
||||||
|
|
||||||
> 角度為 90° 的角,就是直角。
|
|
||||||
>
|
|
||||||
> 新 MacBook Pro 有 15% 的 CPU 性能提升。
|
|
||||||
|
|
||||||
Bad:
|
|
||||||
|
|
||||||
> 角度為 90 ° 的角,就是直角。
|
|
||||||
>
|
|
||||||
> 新 MacBook Pro 有 15 % 的 CPU 性能提升。
|
|
||||||
|
|
||||||
### No additional spaces before/after punctuation in fullwidth form
|
|
||||||
|
|
||||||
Good:
|
|
||||||
|
|
||||||
> 剛剛買了一部 iPhone,好開心!
|
|
||||||
|
|
||||||
Bad:
|
|
||||||
|
|
||||||
> 剛剛買了一部 iPhone ,好開心!
|
|
||||||
>
|
|
||||||
> 剛剛買了一部 iPhone, 好開心!
|
|
||||||
|
|
||||||
### `text-spacing` to the rescue?
|
|
||||||
|
|
||||||
[`text-spacing`](https://www.w3.org/TR/css-text-4/#text-spacing-property) and [`-ms-text-autospace`](https://msdn.microsoft.com/library/ms531164(v=vs.85).aspx) provided by CSS Text Module Level and Microsoft can specify the autospacing and narrow space width adjustment of text. However it's not popular, and on other platforms such as OS X and iOS we can not use this feature. So it's better for you to keep up the habit.
|
|
||||||
|
|
||||||
## Punctuation
|
|
||||||
|
|
||||||
### Avoid duplicate punctuation
|
|
||||||
|
|
||||||
Although the punctuation usage of China mainland admits to duplicate the punctuations, the sentence may become unpleasing to the eye by doing that.
|
|
||||||
|
|
||||||
Good:
|
|
||||||
|
|
||||||
> 德國隊竟然戰勝了巴西隊!
|
|
||||||
>
|
|
||||||
> 她竟然對你說「喵」?!
|
|
||||||
|
|
||||||
Bad:
|
|
||||||
|
|
||||||
> 德國隊竟然戰勝了巴西隊!!
|
|
||||||
>
|
|
||||||
> 德國隊竟然戰勝了巴西隊!!!!!!!!
|
|
||||||
>
|
|
||||||
> 她竟然對你說「喵」??!!
|
|
||||||
>
|
|
||||||
> 她竟然對你說「喵」?!?!??!!
|
|
||||||
|
|
||||||
## Fullwidth and halfwidth
|
|
||||||
|
|
||||||
If you’re not familiar with fullwidth and halfwidth forms please refer to article [Halfwidth and fullwidth](https://en.wikipedia.org/wiki/Halfwidth_and_fullwidth_forms) on Wikipedia.
|
|
||||||
|
|
||||||
### Use punctuation in fullwidth form
|
|
||||||
|
|
||||||
Good:
|
|
||||||
|
|
||||||
> 嗨!你知道嘛?今天前台的小妹跟我說「喵」了哎!
|
|
||||||
>
|
|
||||||
> 核磁共振成像(NMRI)是什麼原理都不知道?JFGI!
|
|
||||||
|
|
||||||
Bad:
|
|
||||||
|
|
||||||
> 嗨! 你知道嘛? 今天前台的小妹跟我說 "喵" 了哎!
|
|
||||||
>
|
|
||||||
> 嗨!你知道嘛?今天前台的小妹跟我說"喵"了哎!
|
|
||||||
>
|
|
||||||
> 核磁共振成像 (NMRI) 是什麼原理都不知道? JFGI!
|
|
||||||
>
|
|
||||||
> 核磁共振成像(NMRI)是什麼原理都不知道?JFGI!
|
|
||||||
|
|
||||||
Exception: inline English titles of books and journals with italics, instead of fullwidth title marks.
|
|
||||||
|
|
||||||
### Use numbers in halfwidth form
|
|
||||||
|
|
||||||
Good:
|
|
||||||
|
|
||||||
> 這件蛋糕只賣 1000 元。
|
|
||||||
|
|
||||||
Bad:
|
|
||||||
|
|
||||||
> 這件蛋糕只賣 1000 元。
|
|
||||||
|
|
||||||
Exceptions: fullwidth numbers are acceptable for better visual alignment in graphic design.
|
|
||||||
|
|
||||||
### Use punctuation in halfwidth form for English sentences
|
|
||||||
|
|
||||||
Good:
|
|
||||||
|
|
||||||
> 賈伯斯那句話是怎麼說的?「Stay hungry, stay foolish.」
|
|
||||||
>
|
|
||||||
> 推薦你閱讀 *Hackers & Painters: Big Ideas from the Computer Age*,非常地有趣。
|
|
||||||
|
|
||||||
Bad:
|
|
||||||
|
|
||||||
> 賈伯斯那句話是怎麼說的?「Stay hungry,stay foolish。」
|
|
||||||
>
|
|
||||||
> 推薦你閱讀《Hackers&Painters:Big Ideas from the Computer Age》,非常的有趣。
|
|
||||||
|
|
||||||
## Nouns
|
|
||||||
|
|
||||||
### Capitalize properly
|
|
||||||
|
|
||||||
Capitalization is a matter of English, which is beyond the scope of this wiki. Here we exemplify some typical scenarios.
|
|
||||||
|
|
||||||
Good:
|
|
||||||
|
|
||||||
> 使用 GitHub 登錄
|
|
||||||
>
|
|
||||||
> 我們的客戶有 GitHub、Foursquare、Microsoft Corporation、Google、Facebook, Inc.。
|
|
||||||
|
|
||||||
Bad:
|
|
||||||
|
|
||||||
> 使用 github 登錄
|
|
||||||
>
|
|
||||||
> 使用 GITHUB 登錄
|
|
||||||
>
|
|
||||||
> 使用 Github 登錄
|
|
||||||
>
|
|
||||||
> 使用 gitHub 登錄
|
|
||||||
>
|
|
||||||
> 使用 gイんĤЦ8 登錄
|
|
||||||
>
|
|
||||||
> 我們的客戶有 github、foursquare、microsoft corporation、google、facebook, inc.。
|
|
||||||
>
|
|
||||||
> 我們的客戶有 GITHUB、FOURSQUARE、MICROSOFT CORPORATION、GOOGLE、FACEBOOK, INC.。
|
|
||||||
>
|
|
||||||
> 我們的客戶有 Github、FourSquare、MicroSoft Corporation、Google、FaceBook, Inc.。
|
|
||||||
>
|
|
||||||
> 我們的客戶有 gitHub、fourSquare、microSoft Corporation、google、faceBook, Inc.。
|
|
||||||
>
|
|
||||||
> 我們的客戶有 gイんĤЦ8、キouЯƧquムгє、๓เςг๏ร๏Ŧt ς๏гק๏гคtเ๏ภn、900913、ƒ4ᄃëв๏๏к, IПᄃ.。
|
|
||||||
|
|
||||||
注意:當網頁中需要配合整體視覺風格而出現全部大寫/小寫的情形,HTML 中請使用標準的大小寫規範進行書寫;並通過 `text-transform: uppercase;`/`text-transform: lowercase;` 對表現形式進行定義。
|
|
||||||
|
|
||||||
### Avoid jargons
|
|
||||||
|
|
||||||
Good:
|
|
||||||
|
|
||||||
> 我們需要一位熟悉 TypeScript、HTML5,至少理解一種框架(如 React、Next.js)的前端開發者。
|
|
||||||
|
|
||||||
Bad:
|
|
||||||
|
|
||||||
> 我們需要一位熟悉 Ts、h5,至少理解一種框架(如 RJS、nextjs)的 FED。
|
|
||||||
|
|
||||||
## Dispute
|
|
||||||
|
|
||||||
The following usages comprise of personal characteristics. As such, from the perspective of copywriting guidelines, they are **still correct** regardless of whether they comply with the following rules.
|
|
||||||
|
|
||||||
### Add extra spaces before/after links
|
|
||||||
|
|
||||||
Usage:
|
|
||||||
|
|
||||||
> 請 [提交一个 issue](#) 並分配给相關同事。
|
|
||||||
>
|
|
||||||
> 訪問我們網站的最新動態,請 [點擊這裡](#) 進行訂閱!
|
|
||||||
|
|
||||||
compared with:
|
|
||||||
|
|
||||||
> 請[提交一个 issue](#) 並分配给相關同事。
|
|
||||||
>
|
|
||||||
> 訪問我們網站的最新動態,請[點擊這裡](#)進行訂閱!
|
|
||||||
|
|
||||||
### Use corner brackets for Chinese Simplified
|
|
||||||
|
|
||||||
Usage:
|
|
||||||
|
|
||||||
> 「老师,『有条不紊』的『紊』是什么意思?」
|
|
||||||
|
|
||||||
compared with:
|
|
||||||
|
|
||||||
> “老师,‘有条不紊’的‘紊’是什么意思?”
|
|
||||||
|
|
||||||
## Tools
|
|
||||||
|
|
||||||
Repository | Category | Language
|
|
||||||
---------- | -------- | --------
|
|
||||||
[pangu.js](https://github.com/vinta/pangu.js) | pangu | JavaScript
|
|
||||||
[pangu-go](https://github.com/vinta/pangu) | pangu | Go
|
|
||||||
[pangu.java](https://github.com/vinta/pangu.java) | pangu | Java
|
|
||||||
[pangu.py](https://github.com/vinta/pangu.py) | pangu | Python
|
|
||||||
[pangu.rb](https://github.com/dlackty/pangu.rb) | pangu | Ruby
|
|
||||||
[pangu.php](https://github.com/cchlorine/pangu.php) | pangu | PHP
|
|
||||||
[pangu.vim](https://github.com/hotoo/pangu.vim) | pangu | Vim
|
|
||||||
[vue-pangu](https://github.com/serkodev/vue-pangu) | pangu | Vue.js (Web Converter)
|
|
||||||
[intellij-pangu](https://plugins.jetbrains.com/plugin/19665-pangu) | pangu | Intellij Platform Plugin
|
|
||||||
[autocorrect](https://github.com/huacnlee/autocorrect) | autocorrect | Rust, WASM, CLI tool
|
|
||||||
[autocorrect-node](https://github.com/huacnlee/autocorrect/tree/main/autocorrect-node) | autocorrect | Node.js
|
|
||||||
[autocorrect-py](https://github.com/huacnlee/autocorrect/tree/main/autocorrect-py) | autocorrect | Python
|
|
||||||
[autocorrect-rb](https://github.com/huacnlee/autocorrect/tree/main/autocorrect-rb) | autocorrect | Ruby
|
|
||||||
[autocorrect-java](https://github.com/huacnlee/autocorrect/tree/main/autocorrect-java) | autocorrect | Java
|
|
||||||
[autocorrect-go](https://github.com/longbridgeapp/autocorrect) | autocorrect | Go
|
|
||||||
[autocorrect-php](https://github.com/NauxLiu/auto-correct) | autocorrect | PHP
|
|
||||||
[autocorrect-vscode](https://marketplace.visualstudio.com/items?itemName=huacnlee.autocorrect) | autocorrect | VS Code Extension
|
|
||||||
[autocorrect-idea-plugin](https://plugins.jetbrains.com/plugin/20244-autocorrect) | autocorrect | Intellij Platform Plugin
|
|
||||||
[jxlwqq/chinese-typesetting](https://github.com/jxlwqq/chinese-typesetting) | other | PHP
|
|
||||||
[sparanoid/space-lover](https://github.com/sparanoid/space-lover) | other | PHP (WordPress)
|
|
||||||
[sparanoid/grunt-auto-spacing](https://github.com/sparanoid/grunt-auto-spacing) | other | Node.js (Grunt)
|
|
||||||
[hjiang/scripts/add-space-between-latin-and-cjk](https://github.com/hjiang/scripts/blob/master/add-space-between-latin-and-cjk) | other | Python
|
|
||||||
[hustcc/hint](https://github.com/hustcc/hint) | other | Python
|
|
||||||
[n0vad3v/Tekorrect](https://github.com/n0vad3v/Tekorrect) | other | Python
|
|
||||||
|
|
||||||
## Examples of “Who is doing this?”
|
|
||||||
|
|
||||||
Website | Copywriting | UGC
|
|
||||||
------- | ----------- | ---
|
|
||||||
[Apple China](https://www.apple.com/cn/) | Yes | N/A
|
|
||||||
[Apple Hong Kong](https://www.apple.com/hk/) | Yes | N/A
|
|
||||||
[Apple Taiwan](https://www.apple.com/tw/) | Yes | N/A
|
|
||||||
[Microsoft China](https://www.microsoft.com/zh-cn/) | Yes | N/A
|
|
||||||
[Microsoft Hong Kong](https://www.microsoft.com/zh-hk/) | Yes | N/A
|
|
||||||
[Microsoft Taiwan](https://www.microsoft.com/zh-tw/) | Yes | N/A
|
|
||||||
[LeanCloud](https://leancloud.cn/) | Yes | N/A
|
|
||||||
[V2EX](https://www.v2ex.com/) | Yes | Yes
|
|
||||||
[Apple4us](https://apple4us.com/) | Yes | N/A
|
|
||||||
[Ruby China](https://ruby-china.org/) | Yes | Yes
|
|
||||||
[少數派](https://sspai.com/) | Yes | N/A
|
|
||||||
|
|
||||||
## References
|
|
||||||
|
|
||||||
- [Guidelines for Using Capital Letters - ThoughtCo.](https://www.thoughtco.com/guidelines-for-using-capital-letters-1691724)
|
|
||||||
- [Letter case - Wikipedia](https://en.wikipedia.org/wiki/Letter_case)
|
|
||||||
- [Punctuation - Oxford Dictionaries](https://en.oxforddictionaries.com/grammar/punctuation)
|
|
||||||
- [Punctuation - The Purdue OWL](https://owl.english.purdue.edu/owl/section/1/6/)
|
|
||||||
- [How to Use English Punctuation Correctly - wikiHow](https://www.wikihow.com/Use-English-Punctuation-Correctly)
|
|
||||||
- [格式 - openSUSE](https://zh.opensuse.org/index.php?title=Help:%E6%A0%BC%E5%BC%8F)
|
|
||||||
- [Halfwidth and fullwidth forms - Wikipedia](https://en.wikipedia.org/wiki/Halfwidth_and_fullwidth_forms)
|
|
||||||
- [引號 - 維基百科](https://zh.wikipedia.org/wiki/%E5%BC%95%E8%99%9F)
|
|
||||||
- [Interrobang - Wikipedia](https://en.wikipedia.org/wiki/Interrobang)
|
|
||||||
|
|
||||||
## Forks
|
|
||||||
|
|
||||||
The usage of forked projects may differ from this project.
|
|
||||||
|
|
||||||
- [mzlogin/chinese-copywriting-guidelines](https://github.com/mzlogin/chinese-copywriting-guidelines)
|
|
||||||
104
README.md
104
README.md
@@ -1,35 +1,44 @@
|
|||||||
# 中文文案排版指北
|
# 中文文案排版指北
|
||||||
|
|
||||||
[](https://crowdin.com/project/chinese-copywriting-guidelines)
|
[](https://crowdin.com/project/chinese-copywriting-guidelines)
|
||||||
|
[](https://greenkeeper.io/)
|
||||||
|
[](https://david-dm.org/sparanoid/chinese-copywriting-guidelines#info=devDependencies)
|
||||||
[](https://sparanoid.com/note/chinese-copywriting-guidelines/)
|
[](https://sparanoid.com/note/chinese-copywriting-guidelines/)
|
||||||
|
|
||||||
統一中文文案、排版的相關用法,降低團隊成員之間的溝通成本,增強網站氣質。
|
統一中文文案、排版的相關用法,降低團隊成員之間的溝通成本,增強網站氣質。
|
||||||
|
|
||||||
Other languages:
|
Other languages:
|
||||||
|
|
||||||
- [English](README.en.md)
|
- [English](README.en-US.md)
|
||||||
- [Chinese Traditional](README.md)
|
- [Chinese Traditional](README.md)
|
||||||
- [Chinese Simplified](README.zh-Hans.md)
|
- [Chinese Simplified](README.zh-CN.md)
|
||||||
|
- [Chinese Simplified](https://github.com/mzlogin/chinese-copywriting-guidelines)(外部連結)
|
||||||
|
|
||||||
-----
|
-----
|
||||||
|
|
||||||
|
## 目次
|
||||||
|
{:.no_toc}
|
||||||
|
|
||||||
|
* TOC
|
||||||
|
{:toc}
|
||||||
|
|
||||||
## 空格
|
## 空格
|
||||||
|
|
||||||
> 「有研究顯示,打字的時候不喜歡在中文和英文之間加空格的人,感情路都走得很辛苦,有七成的比例會在 34 歲的時候跟自己不愛的人結婚,而其餘三成的人最後只能把遺產留給自己的貓。畢竟愛情跟書寫都需要適時地留白。
|
「有研究顯示,打字的時候不喜歡在中文和英文之間加空格的人,感情路都走得很辛苦,有七成的比例會在 34 歲的時候跟自己不愛的人結婚,而其餘三成的人最後只能把遺產留給自己的貓。畢竟愛情跟書寫都需要適時地留白。
|
||||||
>
|
|
||||||
> 與大家共勉之。」——[vinta/paranoid-auto-spacing](https://github.com/vinta/pangu.js)
|
與大家共勉之。」——[vinta/paranoid-auto-spacing](https://github.com/vinta/pangu.js)
|
||||||
|
|
||||||
### 中英文之間需要增加空格
|
### 中英文之間需要增加空格
|
||||||
|
|
||||||
正確:
|
正確:
|
||||||
|
|
||||||
> 在 LeanCloud 上,數據儲存是圍繞 `AVObject` 進行的。
|
> 在 LeanCloud 上,數據存儲是圍繞 `AVObject` 進行的。
|
||||||
|
|
||||||
錯誤:
|
錯誤:
|
||||||
|
|
||||||
> 在LeanCloud上,數據儲存是圍繞`AVObject`進行的。
|
> 在LeanCloud上,數據存儲是圍繞`AVObject`進行的。
|
||||||
|
|
||||||
> 在 LeanCloud上,數據儲存是圍繞`AVObject` 進行的。
|
> 在 LeanCloud上,數據存儲是圍繞`AVObject` 進行的。
|
||||||
|
|
||||||
完整的正確用法:
|
完整的正確用法:
|
||||||
|
|
||||||
@@ -59,17 +68,17 @@ Other languages:
|
|||||||
|
|
||||||
> 我家的光纖入屋寬頻有 10Gbps,SSD 一共有 20TB。
|
> 我家的光纖入屋寬頻有 10Gbps,SSD 一共有 20TB。
|
||||||
|
|
||||||
例外:度數/百分比與數字之間不需要增加空格:
|
例外:度/百分比與數字之間不需要增加空格:
|
||||||
|
|
||||||
正確:
|
正確:
|
||||||
|
|
||||||
> 角度為 90° 的角,就是直角。
|
> 今天是 233° 的高溫。
|
||||||
|
|
||||||
> 新 MacBook Pro 有 15% 的 CPU 性能提升。
|
> 新 MacBook Pro 有 15% 的 CPU 性能提升。
|
||||||
|
|
||||||
錯誤:
|
錯誤:
|
||||||
|
|
||||||
> 角度為 90 ° 的角,就是直角。
|
> 今天是 233 ° 的高溫。
|
||||||
|
|
||||||
> 新 MacBook Pro 有 15 % 的 CPU 性能提升。
|
> 新 MacBook Pro 有 15 % 的 CPU 性能提升。
|
||||||
|
|
||||||
@@ -87,14 +96,12 @@ Other languages:
|
|||||||
|
|
||||||
### `text-spacing` to the rescue?
|
### `text-spacing` to the rescue?
|
||||||
|
|
||||||
CSS 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 等用戶介面目前並不存在這個特性,所以請繼續保持隨手加空格的習慣。
|
CSS 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 等用戶介面目前并不存在這個特性,所以請繼續保持隨手加空格的習慣。
|
||||||
|
|
||||||
## 標點符號
|
## 標點符號
|
||||||
|
|
||||||
### 不重複使用標點符號
|
### 不重複使用標點符號
|
||||||
|
|
||||||
雖然中國大陸的標點符號用法允許重複使用標點符號,但是這麼做會破壞句子的美觀性。
|
|
||||||
|
|
||||||
正確:
|
正確:
|
||||||
|
|
||||||
> 德國隊竟然戰勝了巴西隊!
|
> 德國隊竟然戰勝了巴西隊!
|
||||||
@@ -113,7 +120,7 @@ CSS Text Module Level 4 的 [`text-spacing`](https://www.w3.org/TR/css-text-4/#t
|
|||||||
|
|
||||||
## 全形和半形
|
## 全形和半形
|
||||||
|
|
||||||
不明白什麼是全形(全角)與半形(半角)符號?請查看維基百科條目『[全形和半形](https://zh.wikipedia.org/wiki/%E5%85%A8%E5%BD%A2%E5%92%8C%E5%8D%8A%E5%BD%A2)』。
|
不明白什麼是全形(全角)與半形(半角)符號?請查看維基百科詞條『[全形和半形](https://zh.wikipedia.org/wiki/%E5%85%A8%E5%BD%A2%E5%92%8C%E5%8D%8A%E5%BD%A2)』。
|
||||||
|
|
||||||
### 使用全形中文標點
|
### 使用全形中文標點
|
||||||
|
|
||||||
@@ -133,8 +140,6 @@ CSS Text Module Level 4 的 [`text-spacing`](https://www.w3.org/TR/css-text-4/#t
|
|||||||
|
|
||||||
> 核磁共振成像(NMRI)是什麼原理都不知道?JFGI!
|
> 核磁共振成像(NMRI)是什麼原理都不知道?JFGI!
|
||||||
|
|
||||||
例外:中文句子內夾有英文書籍名、報刊名時,不應借用中文書名號,應以英文斜體表示。
|
|
||||||
|
|
||||||
### 數字使用半形字符
|
### 數字使用半形字符
|
||||||
|
|
||||||
正確:
|
正確:
|
||||||
@@ -153,7 +158,7 @@ CSS Text Module Level 4 的 [`text-spacing`](https://www.w3.org/TR/css-text-4/#t
|
|||||||
|
|
||||||
> 賈伯斯那句話是怎麼說的?「Stay hungry, stay foolish.」
|
> 賈伯斯那句話是怎麼說的?「Stay hungry, stay foolish.」
|
||||||
|
|
||||||
> 推薦你閱讀 *Hackers & Painters: Big Ideas from the Computer Age*,非常地有趣。
|
> 推薦你閱讀《Hackers & Painters: Big Ideas from the Computer Age》,非常的有趣。
|
||||||
|
|
||||||
錯誤:
|
錯誤:
|
||||||
|
|
||||||
@@ -201,27 +206,27 @@ CSS Text Module Level 4 的 [`text-spacing`](https://www.w3.org/TR/css-text-4/#t
|
|||||||
|
|
||||||
正確:
|
正確:
|
||||||
|
|
||||||
> 我們需要一位熟悉 TypeScript、HTML5,至少理解一種框架(如 React、Next.js)的前端開發者。
|
> 我們需要一位熟悉 JavaScript、HTML5,至少理解一種框架(如 Backbone.js、AngularJS、React 等)的前端開發者。
|
||||||
|
|
||||||
錯誤:
|
錯誤:
|
||||||
|
|
||||||
> 我們需要一位熟悉 Ts、h5,至少理解一種框架(如 RJS、nextjs)的 FED。
|
> 我們需要一位熟悉 Js、h5,至少理解一種框架(如 backbone、angular、RJS 等)的 FED。
|
||||||
|
|
||||||
## 爭議
|
## 爭議
|
||||||
|
|
||||||
以下用法略帶有個人色彩,即:無論是否遵循下述規則,從語法的角度來講都是**正確**的。
|
以下用法略帶有個人色彩,即:無論是否遵循下述規則,從語法的角度來講都是**正確**的。
|
||||||
|
|
||||||
### 超連結之間增加空格
|
### 鏈接之間增加空格
|
||||||
|
|
||||||
用法:
|
用法:
|
||||||
|
|
||||||
> 請 [提交一個 issue](#) 並分配给相關同事。
|
> 請 [提交一个 issue](#) 並分配给相關同事。
|
||||||
|
|
||||||
> 訪問我們網站的最新動態,請 [點擊這裡](#) 進行訂閱!
|
> 訪問我們網站的最新動態,請 [點擊這裡](#) 進行訂閱!
|
||||||
|
|
||||||
對比用法:
|
對比用法:
|
||||||
|
|
||||||
> 請[提交一個 issue](#) 並分配给相關同事。
|
> 請[提交一个 issue](#) 並分配给相關同事。
|
||||||
|
|
||||||
> 訪問我們網站的最新動態,請[點擊這裡](#)進行訂閱!
|
> 訪問我們網站的最新動態,請[點擊這裡](#)進行訂閱!
|
||||||
|
|
||||||
@@ -229,40 +234,30 @@ CSS Text Module Level 4 的 [`text-spacing`](https://www.w3.org/TR/css-text-4/#t
|
|||||||
|
|
||||||
用法:
|
用法:
|
||||||
|
|
||||||
> 「老师,『有条不紊』的『紊』是什么意思?」
|
> 「老師,『有條不紊』的『紊』是什麼意思?」
|
||||||
|
|
||||||
對比用法:
|
對比用法:
|
||||||
|
|
||||||
> “老师,‘有条不紊’的‘紊’是什么意思?”
|
> “老師,‘有條不紊’的‘紊’是什麼意思?”
|
||||||
|
|
||||||
## 工具
|
## 工具
|
||||||
|
|
||||||
倉庫 | 系列 | 語言
|
倉庫 | 語言
|
||||||
--- | -- | ---
|
--- | ---
|
||||||
[pangu.js](https://github.com/vinta/pangu.js) | pangu | JavaScript
|
[vinta/paranoid-auto-spacing](https://github.com/vinta/paranoid-auto-spacing) | JavaScript
|
||||||
[pangu-go](https://github.com/vinta/pangu) | pangu | Go
|
[huei90/pangu.node](https://github.com/huei90/pangu.node) | Node.js
|
||||||
[pangu.java](https://github.com/vinta/pangu.java) | pangu | Java
|
[huacnlee/auto-correct](https://github.com/huacnlee/auto-correct) | Ruby
|
||||||
[pangu.py](https://github.com/vinta/pangu.py) | pangu | Python
|
[huacnlee/autocorrect](https://github.com/huacnlee/autocorrect) | Rust, WASM, CLI
|
||||||
[pangu.rb](https://github.com/dlackty/pangu.rb) | pangu | Ruby
|
[huacnlee/go-auto-correct](https://github.com/huacnlee/go-auto-correct) | Go
|
||||||
[pangu.php](https://github.com/cchlorine/pangu.php) | pangu | PHP
|
[sparanoid/space-lover](https://github.com/sparanoid/space-lover) | PHP (WordPress)
|
||||||
[pangu.vim](https://github.com/hotoo/pangu.vim) | pangu | Vim
|
[nauxliu/auto-correct](https://github.com/NauxLiu/auto-correct) | PHP
|
||||||
[vue-pangu](https://github.com/serkodev/vue-pangu) | pangu | Vue.js (Web Converter)
|
[jxlwqq/chinese-typesetting](https://github.com/jxlwqq/chinese-typesetting) | PHP
|
||||||
[intellij-pangu](https://plugins.jetbrains.com/plugin/19665-pangu) | pangu | Intellij Platform Plugin
|
[hotoo/pangu.vim](https://github.com/hotoo/pangu.vim) | Vim
|
||||||
[autocorrect](https://github.com/huacnlee/autocorrect) | autocorrect | Rust, WASM, CLI tool
|
[sparanoid/grunt-auto-spacing](https://github.com/sparanoid/grunt-auto-spacing) | Node.js (Grunt)
|
||||||
[autocorrect-node](https://github.com/huacnlee/autocorrect/tree/main/autocorrect-node) | autocorrect | Node.js
|
[hjiang/scripts/add-space-between-latin-and-cjk](https://github.com/hjiang/scripts/blob/master/add-space-between-latin-and-cjk) | Python
|
||||||
[autocorrect-py](https://github.com/huacnlee/autocorrect/tree/main/autocorrect-py) | autocorrect | Python
|
[hustcc/hint](https://github.com/hustcc/hint) | Python
|
||||||
[autocorrect-rb](https://github.com/huacnlee/autocorrect/tree/main/autocorrect-rb) | autocorrect | Ruby
|
[studygolang/autocorrect](https://github.com/studygolang/autocorrect) | Go
|
||||||
[autocorrect-java](https://github.com/huacnlee/autocorrect/tree/main/autocorrect-java) | autocorrect | Java
|
[VS Code - huacnlee.auto-correct](https://marketplace.visualstudio.com/items?itemName=huacnlee.auto-correct) | VS Code Extension
|
||||||
[autocorrect-go](https://github.com/longbridgeapp/autocorrect) | autocorrect | Go
|
|
||||||
[autocorrect-php](https://github.com/NauxLiu/auto-correct) | autocorrect | PHP
|
|
||||||
[autocorrect-vscode](https://marketplace.visualstudio.com/items?itemName=huacnlee.autocorrect) | autocorrect | VS Code Extension
|
|
||||||
[autocorrect-idea-plugin](https://plugins.jetbrains.com/plugin/20244-autocorrect) | autocorrect | Intellij Platform Plugin
|
|
||||||
[jxlwqq/chinese-typesetting](https://github.com/jxlwqq/chinese-typesetting) | other | PHP
|
|
||||||
[sparanoid/space-lover](https://github.com/sparanoid/space-lover) | other | PHP (WordPress)
|
|
||||||
[sparanoid/grunt-auto-spacing](https://github.com/sparanoid/grunt-auto-spacing) | other | Node.js (Grunt)
|
|
||||||
[hjiang/scripts/add-space-between-latin-and-cjk](https://github.com/hjiang/scripts/blob/master/add-space-between-latin-and-cjk) | other | Python
|
|
||||||
[hustcc/hint](https://github.com/hustcc/hint) | other | Python
|
|
||||||
[n0vad3v/Tekorrect](https://github.com/n0vad3v/Tekorrect) | other | Python
|
|
||||||
|
|
||||||
## 誰在這樣做?
|
## 誰在這樣做?
|
||||||
|
|
||||||
@@ -278,6 +273,7 @@ CSS Text Module Level 4 的 [`text-spacing`](https://www.w3.org/TR/css-text-4/#t
|
|||||||
[V2EX](https://www.v2ex.com/) | Yes | Yes
|
[V2EX](https://www.v2ex.com/) | Yes | Yes
|
||||||
[Apple4us](https://apple4us.com/) | Yes | N/A
|
[Apple4us](https://apple4us.com/) | Yes | N/A
|
||||||
[Ruby China](https://ruby-china.org/) | Yes | Yes
|
[Ruby China](https://ruby-china.org/) | Yes | Yes
|
||||||
|
[PHPHub](https://phphub.org/) | Yes | 標題達成
|
||||||
[少數派](https://sspai.com/) | Yes | N/A
|
[少數派](https://sspai.com/) | Yes | N/A
|
||||||
|
|
||||||
## 參考文獻
|
## 參考文獻
|
||||||
@@ -291,9 +287,3 @@ CSS Text Module Level 4 的 [`text-spacing`](https://www.w3.org/TR/css-text-4/#t
|
|||||||
- [全形和半形 - 維基百科](https://zh.wikipedia.org/wiki/%E5%85%A8%E5%BD%A2%E5%92%8C%E5%8D%8A%E5%BD%A2)
|
- [全形和半形 - 維基百科](https://zh.wikipedia.org/wiki/%E5%85%A8%E5%BD%A2%E5%92%8C%E5%8D%8A%E5%BD%A2)
|
||||||
- [引號 - 維基百科](https://zh.wikipedia.org/wiki/%E5%BC%95%E8%99%9F)
|
- [引號 - 維基百科](https://zh.wikipedia.org/wiki/%E5%BC%95%E8%99%9F)
|
||||||
- [疑問驚嘆號 - 維基百科](https://zh.wikipedia.org/wiki/%E7%96%91%E5%95%8F%E9%A9%9A%E5%98%86%E8%99%9F)
|
- [疑問驚嘆號 - 維基百科](https://zh.wikipedia.org/wiki/%E7%96%91%E5%95%8F%E9%A9%9A%E5%98%86%E8%99%9F)
|
||||||
|
|
||||||
## Forks
|
|
||||||
|
|
||||||
衍生專案的用法可能與本專案存在差異。
|
|
||||||
|
|
||||||
- [mzlogin/chinese-copywriting-guidelines](https://github.com/mzlogin/chinese-copywriting-guidelines)
|
|
||||||
|
|||||||
287
README.zh-CN.md
Normal file
287
README.zh-CN.md
Normal file
@@ -0,0 +1,287 @@
|
|||||||
|
# 中文文案排版指北
|
||||||
|
|
||||||
|
[](https://crowdin.com/project/chinese-copywriting-guidelines) [](https://greenkeeper.io/) [](https://david-dm.org/sparanoid/chinese-copywriting-guidelines#info=devDependencies) [](https://sparanoid.com/note/chinese-copywriting-guidelines/)
|
||||||
|
|
||||||
|
统一中文文案、排版的相关用法,降低团队成员之间的沟通成本,增强网站气质。
|
||||||
|
|
||||||
|
其他语言:
|
||||||
|
|
||||||
|
- [英语](README.en-US.md)
|
||||||
|
- [繁体中文](README.md)
|
||||||
|
- [简体中文](README.zh-CN.md)
|
||||||
|
- [简体中文](https://github.com/mzlogin/chinese-copywriting-guidelines)(外部链接)
|
||||||
|
|
||||||
|
* * *
|
||||||
|
|
||||||
|
## 目录
|
||||||
|
|
||||||
|
{:.no_toc}
|
||||||
|
|
||||||
|
- TOC {:toc}
|
||||||
|
|
||||||
|
## 空格
|
||||||
|
|
||||||
|
> 「有研究顯示,打字的時候不喜歡在中文和英文之間加空格的人,感情路都走得很辛苦,有七成的比例會在 34 歲的時候跟自己不愛的人結婚,而其餘三成的人最後只能把遺產留給自己的貓。畢竟愛情跟書寫都需要適時地留白。
|
||||||
|
>
|
||||||
|
> 與大家共勉之。」——[vinta/paranoid-auto-spacing](https://github.com/vinta/pangu.js)
|
||||||
|
|
||||||
|
### 中英文之间需要增加空格
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 在 LeanCloud 上,數據存儲是圍繞 `AVObject` 進行的。
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 在LeanCloud上,數據存儲是圍繞`AVObject`進行的。
|
||||||
|
>
|
||||||
|
> 在 LeanCloud上,數據存儲是圍繞`AVObject` 進行的。
|
||||||
|
|
||||||
|
完整的正確用法:
|
||||||
|
|
||||||
|
> 在 LeanCloud 上,數據儲存是圍繞 `AVObject` 進行的。每個 `AVObject` 都包含了與 JSON 兼容的 key-value 對應的數據。數據是 schema-free 的,你不需要在每個 `AVObject` 上提前指定存在哪些键,只要直接設定對應的 key-value 即可。
|
||||||
|
|
||||||
|
例外:「豆瓣FM」等產品名詞,按照官方所定義的格式書寫。
|
||||||
|
|
||||||
|
### 中文与数字之间需要增加空格
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 今天出去買菜花了 5000 元。
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 今天出去買菜花了 5000元。
|
||||||
|
>
|
||||||
|
> 今天出去買菜花了5000元。
|
||||||
|
|
||||||
|
### 数字与单位之间需要增加空格
|
||||||
|
|
||||||
|
正确:
|
||||||
|
|
||||||
|
> 我家的光纖入屋寬頻有 10 Gbps,SSD 一共有 20 TB。
|
||||||
|
|
||||||
|
错误:
|
||||||
|
|
||||||
|
> 我家的光纖入屋寬頻有 10Gbps,SSD 一共有 20TB。
|
||||||
|
|
||||||
|
例外:度/百分比與數字之間不需要增加空格:
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 今天是 233° 的高溫。
|
||||||
|
>
|
||||||
|
> 新 MacBook Pro 有 15% 的 CPU 性能提升。
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 今天是 233 ° 的高溫。
|
||||||
|
>
|
||||||
|
> 新 MacBook Pro 有 15 % 的 CPU 性能提升。
|
||||||
|
|
||||||
|
### 全角标点与其他字符之间不加空格
|
||||||
|
|
||||||
|
正确:
|
||||||
|
|
||||||
|
> 剛剛買了一部 iPhone,好開心!
|
||||||
|
|
||||||
|
错误:
|
||||||
|
|
||||||
|
> 剛剛買了一部 iPhone ,好開心!
|
||||||
|
>
|
||||||
|
> 剛剛買了一部 iPhone, 好開心!
|
||||||
|
|
||||||
|
### 用 `text-spacing` 来挽救?
|
||||||
|
|
||||||
|
CSS 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 等用戶介面目前并不存在這個特性,所以請繼續保持隨手加空格的習慣。
|
||||||
|
|
||||||
|
## 标点符号
|
||||||
|
|
||||||
|
### 不重复使用标点符号
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 德國隊竟然戰勝了巴西隊!
|
||||||
|
>
|
||||||
|
> 她竟然對你說「喵」?!
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 德國隊竟然戰勝了巴西隊!!
|
||||||
|
>
|
||||||
|
> 德國隊竟然戰勝了巴西隊!!!!!!!!
|
||||||
|
>
|
||||||
|
> 她竟然對你說「喵」??!!
|
||||||
|
>
|
||||||
|
> 她竟然對你說「喵」?!?!??!!
|
||||||
|
|
||||||
|
## 全角和半角
|
||||||
|
|
||||||
|
不明白什麼是全形(全角)與半形(半角)符號?請查看維基百科詞條『[全形和半形](https://zh.wikipedia.org/wiki/%E5%85%A8%E5%BD%A2%E5%92%8C%E5%8D%8A%E5%BD%A2)』。
|
||||||
|
|
||||||
|
### 使用全角中文标点
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 嗨!你知道嘛?今天前台的小妹跟我說「喵」了哎!
|
||||||
|
>
|
||||||
|
> 核磁共振成像(NMRI)是什麼原理都不知道?JFGI!
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 嗨! 你知道嘛? 今天前台的小妹跟我說 "喵" 了哎!
|
||||||
|
>
|
||||||
|
> 嗨!你知道嘛?今天前台的小妹跟我說"喵"了哎!
|
||||||
|
>
|
||||||
|
> 核磁共振成像 (NMRI) 是什麼原理都不知道? JFGI!
|
||||||
|
>
|
||||||
|
> 核磁共振成像(NMRI)是什麼原理都不知道?JFGI!
|
||||||
|
|
||||||
|
### 数字使用半角字符
|
||||||
|
|
||||||
|
正确:
|
||||||
|
|
||||||
|
> 這件蛋糕只賣 1000 元。
|
||||||
|
|
||||||
|
错误:
|
||||||
|
|
||||||
|
> 這件蛋糕只賣 1000 元。
|
||||||
|
|
||||||
|
例外:在設計稿、宣傳海報中如出現極少量數字的情形時,為方便文字對齊,是可以使用全形數字的。
|
||||||
|
|
||||||
|
### 遇到完整的英文整句、特殊名词,其内容使用半角标点
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 賈伯斯那句話是怎麼說的?「Stay hungry, stay foolish.」
|
||||||
|
>
|
||||||
|
> 推薦你閱讀《Hackers & Painters: Big Ideas from the Computer Age》,非常的有趣。
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 賈伯斯那句話是怎麼說的?「Stay hungry,stay foolish。」
|
||||||
|
>
|
||||||
|
> 推薦你閱讀《Hackers&Painters:Big Ideas from the Computer Age》,非常的有趣。
|
||||||
|
|
||||||
|
## 名词
|
||||||
|
|
||||||
|
### 专有名词使用正确的大小写
|
||||||
|
|
||||||
|
大小寫相關用法原屬於英文書寫範疇,不屬於本 wiki 討論內容,在這裡只對部分易錯用法進行簡述。
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 使用 GitHub 登錄
|
||||||
|
>
|
||||||
|
> 我們的客戶有 GitHub、Foursquare、Microsoft Corporation、Google、Facebook, Inc.。
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 使用 github 登錄
|
||||||
|
>
|
||||||
|
> 使用 GITHUB 登錄
|
||||||
|
>
|
||||||
|
> 使用 Github 登錄
|
||||||
|
>
|
||||||
|
> 使用 gitHub 登錄
|
||||||
|
>
|
||||||
|
> 使用 gイんĤЦ8 登錄
|
||||||
|
>
|
||||||
|
> 我們的客戶有 github、foursquare、microsoft corporation、google、facebook, inc.。
|
||||||
|
>
|
||||||
|
> 我們的客戶有 GITHUB、FOURSQUARE、MICROSOFT CORPORATION、GOOGLE、FACEBOOK, INC.。
|
||||||
|
>
|
||||||
|
> 我們的客戶有 Github、FourSquare、MicroSoft Corporation、Google、FaceBook, Inc.。
|
||||||
|
>
|
||||||
|
> 我們的客戶有 gitHub、fourSquare、microSoft Corporation、google、faceBook, Inc.。
|
||||||
|
>
|
||||||
|
> 我們的客戶有 gイんĤЦ8、キouЯƧquムгє、๓เςг๏ร๏Ŧt ς๏гק๏гคtเ๏ภn、900913、ƒ4ᄃëв๏๏к, IПᄃ.。
|
||||||
|
|
||||||
|
注意:當網頁中需要配合整體視覺風格而出現全部大寫/小寫的情形,HTML 中請使用標準的大小寫規範進行書寫;並通過 `text-transform: uppercase;`/`text-transform: lowercase;` 對表現形式進行定義。
|
||||||
|
|
||||||
|
### 不要使用不地道的缩写
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 我們需要一位熟悉 JavaScript、HTML5,至少理解一種框架(如 Backbone.js、AngularJS、React 等)的前端開發者。
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 我們需要一位熟悉 Js、h5,至少理解一種框架(如 backbone、angular、RJS 等)的 FED。
|
||||||
|
|
||||||
|
## 争议
|
||||||
|
|
||||||
|
以下用法略帶有個人色彩,即:無論是否遵循下述規則,從語法的角度來講都是**正確**的。
|
||||||
|
|
||||||
|
### 超連結之間增加空格
|
||||||
|
|
||||||
|
用法:
|
||||||
|
|
||||||
|
> 請 [提交一個 issue](#) 並分配给相關同事。
|
||||||
|
>
|
||||||
|
> 訪問我們網站的最新動態,請 [點擊這裡](#) 進行訂閱!
|
||||||
|
|
||||||
|
對比用法:
|
||||||
|
|
||||||
|
> 請[提交一個 issue](#) 並分配给相關同事。
|
||||||
|
>
|
||||||
|
> 訪問我們網站的最新動態,請[點擊這裡](#)進行訂閱!
|
||||||
|
|
||||||
|
### 简体中文使用直角引号
|
||||||
|
|
||||||
|
用法:
|
||||||
|
|
||||||
|
> 「老師,『有條不紊』的『紊』是什麼意思?」
|
||||||
|
|
||||||
|
对比用法:
|
||||||
|
|
||||||
|
> “老師,‘有條不紊’的‘紊’是什麼意思?”
|
||||||
|
|
||||||
|
## 工具
|
||||||
|
|
||||||
|
| 仓库 | 语言 |
|
||||||
|
| ------------------------------------------------------------------------------------------------------------------------------- | ----------------- |
|
||||||
|
| [vinta/paranoid-auto-spacing](https://github.com/vinta/paranoid-auto-spacing) | JavaScript |
|
||||||
|
| [huei90/pangu.node](https://github.com/huei90/pangu.node) | Node.js |
|
||||||
|
| [huacnlee/auto-correct](https://github.com/huacnlee/auto-correct) | Ruby |
|
||||||
|
| [huacnlee/autocorrect](https://github.com/huacnlee/autocorrect) | Rust, WASM, CLI |
|
||||||
|
| [huacnlee/go-auto-correct](https://github.com/huacnlee/go-auto-correct) | Go |
|
||||||
|
| [sparanoid/space-lover](https://github.com/sparanoid/space-lover) | PHP (WordPress) |
|
||||||
|
| [nauxliu/auto-correct](https://github.com/NauxLiu/auto-correct) | PHP |
|
||||||
|
| [jxlwqq/chinese-typesetting](https://github.com/jxlwqq/chinese-typesetting) | PHP |
|
||||||
|
| [hotoo/pangu.vim](https://github.com/hotoo/pangu.vim) | Vim |
|
||||||
|
| [sparanoid/grunt-auto-spacing](https://github.com/sparanoid/grunt-auto-spacing) | Node.js (Grunt) |
|
||||||
|
| [hjiang/scripts/add-space-between-latin-and-cjk](https://github.com/hjiang/scripts/blob/master/add-space-between-latin-and-cjk) | Python |
|
||||||
|
| [hustcc/hint](https://github.com/hustcc/hint) | Python |
|
||||||
|
| [studygolang/autocorrect](https://github.com/studygolang/autocorrect) | Go |
|
||||||
|
| [n0vad3v/Tekorrect](https://github.com/n0vad3v/Tekorrect) | Python |
|
||||||
|
| [VS Code - huacnlee.auto-correct](https://marketplace.visualstudio.com/items?itemName=huacnlee.auto-correct) | VS Code Extension |
|
||||||
|
|
||||||
|
## 谁在这样做?
|
||||||
|
|
||||||
|
| 网站 | 文案 | UGC |
|
||||||
|
| ------------------------------------------------ | -- | ---- |
|
||||||
|
| [Apple 中国](https://www.apple.com/cn/) | 是 | N/A |
|
||||||
|
| [Apple 香港](https://www.apple.com/hk/) | 是 | N/A |
|
||||||
|
| [Apple 台湾](https://www.apple.com/tw/) | 是 | N/A |
|
||||||
|
| [Microsoft 中国](https://www.microsoft.com/zh-cn/) | 是 | N/A |
|
||||||
|
| [Microsoft 香港](https://www.microsoft.com/zh-hk/) | 是 | N/A |
|
||||||
|
| [Microsoft 台湾](https://www.microsoft.com/zh-tw/) | 是 | N/A |
|
||||||
|
| [LeanCloud](https://leancloud.cn/) | 是 | N/A |
|
||||||
|
| [V2EX](https://www.v2ex.com/) | 是 | 是 |
|
||||||
|
| [Apple4us](https://apple4us.com/) | 是 | N/A |
|
||||||
|
| [Ruby China](https://ruby-china.org/) | 是 | Yes |
|
||||||
|
| [PHPHub](https://phphub.org/) | 是 | 标题达成 |
|
||||||
|
| [少数派](https://sspai.com/) | 是 | N/A |
|
||||||
|
|
||||||
|
## 参考文献
|
||||||
|
|
||||||
|
- [Guidelines for Using Capital Letters - ThoughtCo.](https://www.thoughtco.com/guidelines-for-using-capital-letters-1691724)
|
||||||
|
- [Letter case - Wikipedia](https://en.wikipedia.org/wiki/Letter_case)
|
||||||
|
- [Punctuation - Oxford Dictionaries](https://en.oxforddictionaries.com/grammar/punctuation)
|
||||||
|
- [Punctuation - The Purdue OWL](https://owl.english.purdue.edu/owl/section/1/6/)
|
||||||
|
- [How to Use English Punctuation Correctly - wikiHow](https://www.wikihow.com/Use-English-Punctuation-Correctly)
|
||||||
|
- [格式 - openSUSE](https://zh.opensuse.org/index.php?title=Help:%E6%A0%BC%E5%BC%8F)
|
||||||
|
- [全形和半形 - 维基百科](https://zh.wikipedia.org/wiki/%E5%85%A8%E5%BD%A2%E5%92%8C%E5%8D%8A%E5%BD%A2)
|
||||||
|
- [引号 - 维基百科](https://zh.wikipedia.org/wiki/%E5%BC%95%E8%99%9F)
|
||||||
|
- [疑问惊叹号 - 维基百科](https://zh.wikipedia.org/wiki/%E7%96%91%E5%95%8F%E9%A9%9A%E5%98%86%E8%99%9F)
|
||||||
287
README.zh-HK.md
Normal file
287
README.zh-HK.md
Normal file
@@ -0,0 +1,287 @@
|
|||||||
|
# 中文文案排版指南
|
||||||
|
|
||||||
|
[](https://crowdin.com/project/chinese-copywriting-guidelines) [](https://greenkeeper.io/) [](https://david-dm.org/sparanoid/chinese-copywriting-guidelines#info=devDependencies) [](https://sparanoid.com/note/chinese-copywriting-guidelines/)
|
||||||
|
|
||||||
|
統一中文文案、排版的相關用法,降低團隊成員之間的溝通成本,增強網站氣質。
|
||||||
|
|
||||||
|
Other languages:
|
||||||
|
|
||||||
|
- [English](README.en-US.md)
|
||||||
|
- [Chinese Traditional](README.md)
|
||||||
|
- [Chinese Simplified](README.zh-CN.md)
|
||||||
|
- [Chinese Simplified](https://github.com/mzlogin/chinese-copywriting-guidelines)(外部連結)
|
||||||
|
|
||||||
|
* * *
|
||||||
|
|
||||||
|
## 目次
|
||||||
|
|
||||||
|
{:.no_toc}
|
||||||
|
|
||||||
|
- TOC {:toc}
|
||||||
|
|
||||||
|
## 空格
|
||||||
|
|
||||||
|
> 「有研究顯示,打字的時候不喜歡在中文和英文之間加空格的人,感情路都走得很辛苦,有七成的比例會在 34 歲的時候跟自己不愛的人結婚,而其餘三成的人最後只能把遺產留給自己的貓。畢竟愛情跟書寫都需要適時地留白。
|
||||||
|
>
|
||||||
|
> 與大家共勉之。」——[vinta/paranoid-auto-spacing](https://github.com/vinta/pangu.js)
|
||||||
|
|
||||||
|
### 中英文之間需要增加空格
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 在 LeanCloud 上,數據存儲是圍繞 `AVObject` 進行的。
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 在LeanCloud上,數據存儲是圍繞`AVObject`進行的。
|
||||||
|
>
|
||||||
|
> 在 LeanCloud上,數據存儲是圍繞`AVObject` 進行的。
|
||||||
|
|
||||||
|
完整的正確用法:
|
||||||
|
|
||||||
|
> 在 LeanCloud 上,數據儲存是圍繞 `AVObject` 進行的。每個 `AVObject` 都包含了與 JSON 兼容的 key-value 對應的數據。數據是 schema-free 的,你不需要在每個 `AVObject` 上提前指定存在哪些键,只要直接設定對應的 key-value 即可。
|
||||||
|
|
||||||
|
例外:「豆瓣FM」等產品名詞,按照官方所定義的格式書寫。
|
||||||
|
|
||||||
|
### 中文與數字之間需要增加空格
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 今天出去買菜花了 5000 元。
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 今天出去買菜花了 5000元。
|
||||||
|
>
|
||||||
|
> 今天出去買菜花了5000元。
|
||||||
|
|
||||||
|
### 數字與單位之間需要增加空格
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 我家的光纖入屋寬頻有 10 Gbps,SSD 一共有 20 TB。
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 我家的光纖入屋寬頻有 10Gbps,SSD 一共有 20TB。
|
||||||
|
|
||||||
|
例外:度/百分比與數字之間不需要增加空格:
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 今天是 233° 的高溫。
|
||||||
|
>
|
||||||
|
> 新 MacBook Pro 有 15% 的 CPU 性能提升。
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 今天是 233 ° 的高溫。
|
||||||
|
>
|
||||||
|
> 新 MacBook Pro 有 15 % 的 CPU 性能提升。
|
||||||
|
|
||||||
|
### 全形標點與其他字符之間不加空格
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 剛剛買了一部 iPhone,好開心!
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 剛剛買了一部 iPhone ,好開心!
|
||||||
|
>
|
||||||
|
> 剛剛買了一部 iPhone, 好開心!
|
||||||
|
|
||||||
|
### `text-spacing` to the rescue?
|
||||||
|
|
||||||
|
CSS 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 等用戶介面目前并不存在這個特性,所以請繼續保持隨手加空格的習慣。
|
||||||
|
|
||||||
|
## 標點符號
|
||||||
|
|
||||||
|
### 不重複使用標點符號
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 德國隊竟然戰勝了巴西隊!
|
||||||
|
>
|
||||||
|
> 她竟然對你說「喵」?!
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 德國隊竟然戰勝了巴西隊!!
|
||||||
|
>
|
||||||
|
> 德國隊竟然戰勝了巴西隊!!!!!!!!
|
||||||
|
>
|
||||||
|
> 她竟然對你說「喵」??!!
|
||||||
|
>
|
||||||
|
> 她竟然對你說「喵」?!?!??!!
|
||||||
|
|
||||||
|
## 全形和半形
|
||||||
|
|
||||||
|
不明白什麼是全形(全角)與半形(半角)符號?請查看維基百科詞條『[全形和半形](https://zh.wikipedia.org/wiki/%E5%85%A8%E5%BD%A2%E5%92%8C%E5%8D%8A%E5%BD%A2)』。
|
||||||
|
|
||||||
|
### 使用全形中文標點
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 嗨!你知道嘛?今天前台的小妹跟我說「喵」了哎!
|
||||||
|
>
|
||||||
|
> 核磁共振成像(NMRI)是什麼原理都不知道?JFGI!
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 嗨! 你知道嘛? 今天前台的小妹跟我說 "喵" 了哎!
|
||||||
|
>
|
||||||
|
> 嗨!你知道嘛?今天前台的小妹跟我說"喵"了哎!
|
||||||
|
>
|
||||||
|
> 核磁共振成像 (NMRI) 是什麼原理都不知道? JFGI!
|
||||||
|
>
|
||||||
|
> 核磁共振成像(NMRI)是什麼原理都不知道?JFGI!
|
||||||
|
|
||||||
|
### 數字使用半形字符
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 這件蛋糕只賣 1000 元。
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 這件蛋糕只賣 1000 元。
|
||||||
|
|
||||||
|
例外:在設計稿、宣傳海報中如出現極少量數字的情形時,為方便文字對齊,是可以使用全形數字的。
|
||||||
|
|
||||||
|
### 遇到完整的英文整句、特殊名詞,其內容使用半形標點
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 賈伯斯那句話是怎麼說的?「Stay hungry, stay foolish.」
|
||||||
|
>
|
||||||
|
> 推薦你閱讀《Hackers & Painters: Big Ideas from the Computer Age》,非常的有趣。
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 賈伯斯那句話是怎麼說的?「Stay hungry,stay foolish。」
|
||||||
|
>
|
||||||
|
> 推薦你閱讀《Hackers&Painters:Big Ideas from the Computer Age》,非常的有趣。
|
||||||
|
|
||||||
|
## 名詞
|
||||||
|
|
||||||
|
### 專有名詞使用正確的大小寫
|
||||||
|
|
||||||
|
大小寫相關用法原屬於英文書寫範疇,不屬於本 wiki 討論內容,在這裡只對部分易錯用法進行簡述。
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 使用 GitHub 登錄
|
||||||
|
>
|
||||||
|
> 我們的客戶有 GitHub、Foursquare、Microsoft Corporation、Google、Facebook, Inc.。
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 使用 github 登錄
|
||||||
|
>
|
||||||
|
> 使用 GITHUB 登錄
|
||||||
|
>
|
||||||
|
> 使用 Github 登錄
|
||||||
|
>
|
||||||
|
> 使用 gitHub 登錄
|
||||||
|
>
|
||||||
|
> 使用 gイんĤЦ8 登錄
|
||||||
|
>
|
||||||
|
> 我們的客戶有 github、foursquare、microsoft corporation、google、facebook, inc.。
|
||||||
|
>
|
||||||
|
> 我們的客戶有 GITHUB、FOURSQUARE、MICROSOFT CORPORATION、GOOGLE、FACEBOOK, INC.。
|
||||||
|
>
|
||||||
|
> 我們的客戶有 Github、FourSquare、MicroSoft Corporation、Google、FaceBook, Inc.。
|
||||||
|
>
|
||||||
|
> 我們的客戶有 gitHub、fourSquare、microSoft Corporation、google、faceBook, Inc.。
|
||||||
|
>
|
||||||
|
> 我們的客戶有 gイんĤЦ8、キouЯƧquムгє、๓เςг๏ร๏Ŧt ς๏гק๏гคtเ๏ภn、900913、ƒ4ᄃëв๏๏к, IПᄃ.。
|
||||||
|
|
||||||
|
注意:當網頁中需要配合整體視覺風格而出現全部大寫/小寫的情形,HTML 中請使用標準的大小寫規範進行書寫;並通過 `text-transform: uppercase;`/`text-transform: lowercase;` 對表現形式進行定義。
|
||||||
|
|
||||||
|
### 不要使用不道地的縮寫
|
||||||
|
|
||||||
|
正確:
|
||||||
|
|
||||||
|
> 我們需要一位熟悉 JavaScript、HTML5,至少理解一種框架(如 Backbone.js、AngularJS、React 等)的前端開發者。
|
||||||
|
|
||||||
|
錯誤:
|
||||||
|
|
||||||
|
> 我們需要一位熟悉 Js、h5,至少理解一種框架(如 backbone、angular、RJS 等)的 FED。
|
||||||
|
|
||||||
|
## 爭議
|
||||||
|
|
||||||
|
以下用法略帶有個人色彩,即:無論是否遵循下述規則,從語法的角度來講都是**正確**的。
|
||||||
|
|
||||||
|
### 超連結之間增加空格
|
||||||
|
|
||||||
|
用法:
|
||||||
|
|
||||||
|
> 請 [提交一個 issue](#) 並分配给相關同事。
|
||||||
|
>
|
||||||
|
> 訪問我們網站的最新動態,請 [點擊這裡](#) 進行訂閱!
|
||||||
|
|
||||||
|
對比用法:
|
||||||
|
|
||||||
|
> 請[提交一個 issue](#) 並分配给相關同事。
|
||||||
|
>
|
||||||
|
> 訪問我們網站的最新動態,請[點擊這裡](#)進行訂閱!
|
||||||
|
|
||||||
|
### 簡體中文使用直角引號
|
||||||
|
|
||||||
|
用法:
|
||||||
|
|
||||||
|
> 「老師,『有條不紊』的『紊』是什麼意思?」
|
||||||
|
|
||||||
|
對比用法:
|
||||||
|
|
||||||
|
> “老師,‘有條不紊’的‘紊’是什麼意思?”
|
||||||
|
|
||||||
|
## 工具
|
||||||
|
|
||||||
|
| 倉庫 | 語言 |
|
||||||
|
| ------------------------------------------------------------------------------------------------------------------------------- | ----------------- |
|
||||||
|
| [vinta/paranoid-auto-spacing](https://github.com/vinta/paranoid-auto-spacing) | JavaScript |
|
||||||
|
| [huei90/pangu.node](https://github.com/huei90/pangu.node) | Node.js |
|
||||||
|
| [huacnlee/auto-correct](https://github.com/huacnlee/auto-correct) | Ruby |
|
||||||
|
| [huacnlee/autocorrect](https://github.com/huacnlee/autocorrect) | Rust, WASM, CLI |
|
||||||
|
| [huacnlee/go-auto-correct](https://github.com/huacnlee/go-auto-correct) | Go |
|
||||||
|
| [sparanoid/space-lover](https://github.com/sparanoid/space-lover) | PHP (WordPress) |
|
||||||
|
| [nauxliu/auto-correct](https://github.com/NauxLiu/auto-correct) | PHP |
|
||||||
|
| [jxlwqq/chinese-typesetting](https://github.com/jxlwqq/chinese-typesetting) | PHP |
|
||||||
|
| [hotoo/pangu.vim](https://github.com/hotoo/pangu.vim) | Vim |
|
||||||
|
| [sparanoid/grunt-auto-spacing](https://github.com/sparanoid/grunt-auto-spacing) | Node.js (Grunt) |
|
||||||
|
| [hjiang/scripts/add-space-between-latin-and-cjk](https://github.com/hjiang/scripts/blob/master/add-space-between-latin-and-cjk) | Python |
|
||||||
|
| [hustcc/hint](https://github.com/hustcc/hint) | Python |
|
||||||
|
| [studygolang/autocorrect](https://github.com/studygolang/autocorrect) | Go |
|
||||||
|
| [n0vad3v/Tekorrect](https://github.com/n0vad3v/Tekorrect) | Python |
|
||||||
|
| [VS Code - huacnlee.auto-correct](https://marketplace.visualstudio.com/items?itemName=huacnlee.auto-correct) | VS Code Extension |
|
||||||
|
|
||||||
|
## 誰在這樣做?
|
||||||
|
|
||||||
|
| 網站 | 文案 | UGC |
|
||||||
|
| ------------------------------------------------ | --- | ---- |
|
||||||
|
| [Apple 中國](https://www.apple.com/cn/) | Yes | N/A |
|
||||||
|
| [Apple 香港](https://www.apple.com/hk/) | Yes | N/A |
|
||||||
|
| [Apple 台灣](https://www.apple.com/tw/) | Yes | N/A |
|
||||||
|
| [Microsoft 中國](https://www.microsoft.com/zh-cn/) | Yes | N/A |
|
||||||
|
| [Microsoft 香港](https://www.microsoft.com/zh-hk/) | Yes | N/A |
|
||||||
|
| [Microsoft 台灣](https://www.microsoft.com/zh-tw/) | Yes | N/A |
|
||||||
|
| [LeanCloud](https://leancloud.cn/) | Yes | N/A |
|
||||||
|
| [V2EX](https://www.v2ex.com/) | Yes | Yes |
|
||||||
|
| [Apple4us](https://apple4us.com/) | Yes | N/A |
|
||||||
|
| [Ruby China](https://ruby-china.org/) | Yes | Yes |
|
||||||
|
| [PHPHub](https://phphub.org/) | Yes | 標題達成 |
|
||||||
|
| [少數派](https://sspai.com/) | Yes | N/A |
|
||||||
|
|
||||||
|
## 參考文獻
|
||||||
|
|
||||||
|
- [Guidelines for Using Capital Letters - ThoughtCo.](https://www.thoughtco.com/guidelines-for-using-capital-letters-1691724)
|
||||||
|
- [Letter case - Wikipedia](https://en.wikipedia.org/wiki/Letter_case)
|
||||||
|
- [Punctuation - Oxford Dictionaries](https://en.oxforddictionaries.com/grammar/punctuation)
|
||||||
|
- [Punctuation - The Purdue OWL](https://owl.english.purdue.edu/owl/section/1/6/)
|
||||||
|
- [How to Use English Punctuation Correctly - wikiHow](https://www.wikihow.com/Use-English-Punctuation-Correctly)
|
||||||
|
- [格式 - openSUSE](https://zh.opensuse.org/index.php?title=Help:%E6%A0%BC%E5%BC%8F)
|
||||||
|
- [全形和半形 - 維基百科](https://zh.wikipedia.org/wiki/%E5%85%A8%E5%BD%A2%E5%92%8C%E5%8D%8A%E5%BD%A2)
|
||||||
|
- [引號 - 維基百科](https://zh.wikipedia.org/wiki/%E5%BC%95%E8%99%9F)
|
||||||
|
- [疑問驚嘆號 - 維基百科](https://zh.wikipedia.org/wiki/%E7%96%91%E5%95%8F%E9%A9%9A%E5%98%86%E8%99%9F)
|
||||||
@@ -1,296 +0,0 @@
|
|||||||
# 中文文案排版指北
|
|
||||||
|
|
||||||
统一中文文案、排版的相关用法,降低团队成员之间的沟通成本,增强网站气质。
|
|
||||||
|
|
||||||
Other languages:
|
|
||||||
|
|
||||||
- [英语](README.en.md)
|
|
||||||
- [繁体中文](README.md)
|
|
||||||
- [简体中文](README.zh-Hans.md)
|
|
||||||
|
|
||||||
* * *
|
|
||||||
|
|
||||||
## 空格
|
|
||||||
|
|
||||||
> 「有研究显示,打字的时候不喜欢在中文和英文之间加空格的人,感情路都走得很辛苦,有七成的比例会在 34 岁的时候跟自己不爱的人结婚,而其余三成的人最后只能把遗产留给自己的猫。毕竟爱情跟书写都需要适时地留白。
|
|
||||||
>
|
|
||||||
> 与大家共勉之。」——[vinta/paranoid-auto-spacing](https://github.com/vinta/pangu.js)
|
|
||||||
|
|
||||||
### 中英文之间需要增加空格
|
|
||||||
|
|
||||||
正确:
|
|
||||||
|
|
||||||
> 在 LeanCloud 上,数据存储是围绕 `AVObject` 进行的。
|
|
||||||
|
|
||||||
错误:
|
|
||||||
|
|
||||||
> 在LeanCloud上,数据存储是围绕`AVObject`进行的。
|
|
||||||
>
|
|
||||||
> 在 LeanCloud上,数据存储是围绕`AVObject` 进行的。
|
|
||||||
|
|
||||||
完整的正确用法:
|
|
||||||
|
|
||||||
> 在 LeanCloud 上,数据存储是围绕 `AVObject` 进行的。每个 `AVObject` 都包含了与 JSON 兼容的 key-value 对应的数据。数据是 schema-free 的,你不需要在每个 `AVObject` 上提前指定存在哪些键,只要直接设定对应的 key-value 即可。
|
|
||||||
|
|
||||||
例外:「豆瓣FM」等产品名词,按照官方所定义的格式书写。
|
|
||||||
|
|
||||||
### 中文与数字之间需要增加空格
|
|
||||||
|
|
||||||
正确:
|
|
||||||
|
|
||||||
> 今天出去买菜花了 5000 元。
|
|
||||||
|
|
||||||
错误:
|
|
||||||
|
|
||||||
> 今天出去买菜花了 5000元。
|
|
||||||
>
|
|
||||||
> 今天出去买菜花了5000元。
|
|
||||||
|
|
||||||
### 数字与单位之间需要增加空格
|
|
||||||
|
|
||||||
正确:
|
|
||||||
|
|
||||||
> 我家的光纤入屋宽带有 10 Gbps,SSD 一共有 20 TB
|
|
||||||
|
|
||||||
错误:
|
|
||||||
|
|
||||||
> 我家的光纤入屋宽带有 10Gbps,SSD 一共有 20TB
|
|
||||||
|
|
||||||
例外:度数/百分比与数字之间不需要增加空格:
|
|
||||||
|
|
||||||
正确:
|
|
||||||
|
|
||||||
> 角度为 90° 的角,就是直角。
|
|
||||||
>
|
|
||||||
> 新 MacBook Pro 有 15% 的 CPU 性能提升。
|
|
||||||
|
|
||||||
错误:
|
|
||||||
|
|
||||||
> 角度为 90 ° 的角,就是直角。
|
|
||||||
>
|
|
||||||
> 新 MacBook Pro 有 15 % 的 CPU 性能提升。
|
|
||||||
|
|
||||||
### 全角标点与其他字符之间不加空格
|
|
||||||
|
|
||||||
正确:
|
|
||||||
|
|
||||||
> 刚刚买了一部 iPhone,好开心!
|
|
||||||
|
|
||||||
错误:
|
|
||||||
|
|
||||||
> 刚刚买了一部 iPhone ,好开心!
|
|
||||||
>
|
|
||||||
> 刚刚买了一部 iPhone, 好开心!
|
|
||||||
|
|
||||||
### 用 `text-spacing` 来挽救?
|
|
||||||
|
|
||||||
CSS 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 等用户界面目前并不存在这个特性,所以请继续保持随手加空格的习惯。
|
|
||||||
|
|
||||||
## 标点符号
|
|
||||||
|
|
||||||
### 不重复使用标点符号
|
|
||||||
|
|
||||||
虽然中国大陆的标点符号用法允许重复使用标点符号,但是这么做会破坏句子的美观性。
|
|
||||||
|
|
||||||
正确:
|
|
||||||
|
|
||||||
> 德国队竟然战胜了巴西队!
|
|
||||||
>
|
|
||||||
> 她竟然对你说「喵」?!
|
|
||||||
|
|
||||||
错误:
|
|
||||||
|
|
||||||
> 德国队竟然战胜了巴西队!!
|
|
||||||
>
|
|
||||||
> 德国队竟然战胜了巴西队!!!!!!!!
|
|
||||||
>
|
|
||||||
> 她竟然对你说「喵」??!!
|
|
||||||
>
|
|
||||||
> 她竟然对你说「喵」?!?!??!!
|
|
||||||
|
|
||||||
## 全角和半角
|
|
||||||
|
|
||||||
不明白什么是全角(全形)与半角(半形)符号?请查看维基百科条目『[全角和半角](https://zh.wikipedia.org/wiki/%E5%85%A8%E5%BD%A2%E5%92%8C%E5%8D%8A%E5%BD%A2)』。
|
|
||||||
|
|
||||||
### 使用全角中文标点
|
|
||||||
|
|
||||||
正确:
|
|
||||||
|
|
||||||
> 嗨!你知道嘛?今天前台的小妹跟我说「喵」了哎!
|
|
||||||
>
|
|
||||||
> 核磁共振成像(NMRI)是什么原理都不知道?JFGI!
|
|
||||||
|
|
||||||
错误:
|
|
||||||
|
|
||||||
> 嗨! 你知道嘛? 今天前台的小妹跟我说 "喵" 了哎!
|
|
||||||
>
|
|
||||||
> 嗨!你知道嘛?今天前台的小妹跟我说"喵"了哎!
|
|
||||||
>
|
|
||||||
> 核磁共振成像 (NMRI) 是什么原理都不知道? JFGI!
|
|
||||||
>
|
|
||||||
> 核磁共振成像(NMRI)是什么原理都不知道?JFGI!
|
|
||||||
|
|
||||||
例外:中文句子内夹有英文书籍名、报刊名时,不应借用中文书名号,应以英文斜体表示。
|
|
||||||
|
|
||||||
### 数字使用半角字符
|
|
||||||
|
|
||||||
正确:
|
|
||||||
|
|
||||||
> 这个蛋糕只卖 1000 元。
|
|
||||||
|
|
||||||
错误:
|
|
||||||
|
|
||||||
> 这个蛋糕只卖 1000 元。
|
|
||||||
|
|
||||||
例外:在设计稿、宣传海报中如出现极少量数字的情形时,为方便文字对齐,是可以使用全角数字的。
|
|
||||||
|
|
||||||
### 遇到完整的英文整句、特殊名词,其内容使用半角标点
|
|
||||||
|
|
||||||
正确:
|
|
||||||
|
|
||||||
> 乔布斯那句话是怎么说的?「Stay hungry, stay foolish.」
|
|
||||||
>
|
|
||||||
> 推荐你阅读 *Hackers & Painters: Big Ideas from the Computer Age*,非常地有趣。
|
|
||||||
|
|
||||||
错误:
|
|
||||||
|
|
||||||
> 乔布斯那句话是怎么说的?「Stay hungry,stay foolish。」
|
|
||||||
>
|
|
||||||
> 推荐你阅读《Hackers&Painters:Big Ideas from the Computer Age》,非常的有趣。
|
|
||||||
|
|
||||||
## 名词
|
|
||||||
|
|
||||||
### 专有名词使用正确的大小写
|
|
||||||
|
|
||||||
大小写相关用法原属于英文书写范畴,不属于本 wiki 讨论内容,在这里只对部分易错用法进行简述。
|
|
||||||
|
|
||||||
正确:
|
|
||||||
|
|
||||||
> 使用 GitHub 登录
|
|
||||||
>
|
|
||||||
> 我们的客户有 GitHub、Foursquare、Microsoft Corporation、Google、Facebook, Inc.。
|
|
||||||
|
|
||||||
错误:
|
|
||||||
|
|
||||||
> 使用 github 登录
|
|
||||||
>
|
|
||||||
> 使用 GITHUB 登录
|
|
||||||
>
|
|
||||||
> 使用 Github 登录
|
|
||||||
>
|
|
||||||
> 使用 gitHub 登录
|
|
||||||
>
|
|
||||||
> 使用 gイんĤЦ8 登录
|
|
||||||
>
|
|
||||||
> 我们的客户有 github、foursquare、microsoft corporation、google、facebook, inc.。
|
|
||||||
>
|
|
||||||
> 我们的客户有 GITHUB、FOURSQUARE、MICROSOFT CORPORATION、GOOGLE、FACEBOOK, INC.。
|
|
||||||
>
|
|
||||||
> 我们的客户有 Github、FourSquare、MicroSoft Corporation、Google、FaceBook, Inc.。
|
|
||||||
>
|
|
||||||
> 我们的客户有 gitHub、fourSquare、microSoft Corporation、google、faceBook, Inc.。
|
|
||||||
>
|
|
||||||
> 我们的客户有 gイんĤЦ8、キouЯƧquムгє、๓เςг๏ร๏Ŧt ς๏гק๏гคtเ๏ภn、900913、ƒ4ᄃëв๏๏к, IПᄃ.。
|
|
||||||
|
|
||||||
注意:当网页中需要配合整体视觉风格而出现全部大写/小写的情形,HTML 中请使用标淮的大小写规范进行书写;并通过 `text-transform: uppercase;`/`text-transform: lowercase;` 对表现形式进行定义。
|
|
||||||
|
|
||||||
### 不要使用不地道的缩写
|
|
||||||
|
|
||||||
正确:
|
|
||||||
|
|
||||||
> 我们需要一位熟悉 TypeScript、HTML5,至少理解一种框架(如 React、Next.js)的前端开发者。
|
|
||||||
|
|
||||||
错误:
|
|
||||||
|
|
||||||
> 我们需要一位熟悉 Ts、h5,至少理解一种框架(如 RJS、nextjs)的 FED。
|
|
||||||
|
|
||||||
## 争议
|
|
||||||
|
|
||||||
以下用法略带有个人色彩,即:无论是否遵循下述规则,从语法的角度来讲都是**正确**的。
|
|
||||||
|
|
||||||
### 链接之间增加空格
|
|
||||||
|
|
||||||
用法:
|
|
||||||
|
|
||||||
> 请 [提交一个 issue](#) 并分配给相关同事。
|
|
||||||
>
|
|
||||||
> 访问我们网站的最新动态,请 [点击这里](#) 进行订阅!
|
|
||||||
|
|
||||||
对比用法:
|
|
||||||
|
|
||||||
> 请[提交一个 issue](#)并分配给相关同事。
|
|
||||||
>
|
|
||||||
> 访问我们网站的最新动态,请[点击这里](#)进行订阅!
|
|
||||||
|
|
||||||
### 简体中文使用直角引号
|
|
||||||
|
|
||||||
用法:
|
|
||||||
|
|
||||||
> 「老师,『有条不紊』的『紊』是什么意思?」
|
|
||||||
|
|
||||||
对比用法:
|
|
||||||
|
|
||||||
> “老师,‘有条不紊’的‘紊’是什么意思?”
|
|
||||||
|
|
||||||
## 工具
|
|
||||||
|
|
||||||
仓库 | 系列 | 语言
|
|
||||||
--- | ---- | ---
|
|
||||||
[pangu.js](https://github.com/vinta/pangu.js) | pangu | JavaScript
|
|
||||||
[pangu-go](https://github.com/vinta/pangu) | pangu | Go
|
|
||||||
[pangu.java](https://github.com/vinta/pangu.java) | pangu | Java
|
|
||||||
[pangu.py](https://github.com/vinta/pangu.py) | pangu | Python
|
|
||||||
[pangu.rb](https://github.com/dlackty/pangu.rb) | pangu | Ruby
|
|
||||||
[pangu.php](https://github.com/cchlorine/pangu.php) | pangu | PHP
|
|
||||||
[pangu.vim](https://github.com/hotoo/pangu.vim) | pangu | Vim
|
|
||||||
[vue-pangu](https://github.com/serkodev/vue-pangu) | pangu | Vue.js (Web Converter)
|
|
||||||
[intellij-pangu](https://plugins.jetbrains.com/plugin/19665-pangu) | pangu | Intellij Platform Plugin
|
|
||||||
[autocorrect](https://github.com/huacnlee/autocorrect) | autocorrect | Rust, WASM, CLI tool
|
|
||||||
[autocorrect-node](https://github.com/huacnlee/autocorrect/tree/main/autocorrect-node) | autocorrect | Node.js
|
|
||||||
[autocorrect-py](https://github.com/huacnlee/autocorrect/tree/main/autocorrect-py) | autocorrect | Python
|
|
||||||
[autocorrect-rb](https://github.com/huacnlee/autocorrect/tree/main/autocorrect-rb) | autocorrect | Ruby
|
|
||||||
[autocorrect-java](https://github.com/huacnlee/autocorrect/tree/main/autocorrect-java) | autocorrect | Java
|
|
||||||
[autocorrect-go](https://github.com/longbridgeapp/autocorrect) | autocorrect | Go
|
|
||||||
[autocorrect-php](https://github.com/NauxLiu/auto-correct) | autocorrect | PHP
|
|
||||||
[autocorrect-vscode](https://marketplace.visualstudio.com/items?itemName=huacnlee.autocorrect) | autocorrect | VS Code Extension
|
|
||||||
[autocorrect-idea-plugin](https://plugins.jetbrains.com/plugin/20244-autocorrect) | autocorrect | Intellij Platform Plugin
|
|
||||||
[jxlwqq/chinese-typesetting](https://github.com/jxlwqq/chinese-typesetting) | other | PHP
|
|
||||||
[sparanoid/space-lover](https://github.com/sparanoid/space-lover) | other | PHP (WordPress)
|
|
||||||
[sparanoid/grunt-auto-spacing](https://github.com/sparanoid/grunt-auto-spacing) | other | Node.js (Grunt)
|
|
||||||
[hjiang/scripts/add-space-between-latin-and-cjk](https://github.com/hjiang/scripts/blob/master/add-space-between-latin-and-cjk) | other | Python
|
|
||||||
[hustcc/hint](https://github.com/hustcc/hint) | other | Python
|
|
||||||
[n0vad3v/Tekorrect](https://github.com/n0vad3v/Tekorrect) | other | Python
|
|
||||||
|
|
||||||
## 谁在这样做?
|
|
||||||
|
|
||||||
网站 | 文案 | UGC
|
|
||||||
--- | --- | ---
|
|
||||||
[Apple 中国](https://www.apple.com/cn/) | 是 | N/A
|
|
||||||
[Apple 香港](https://www.apple.com/hk/) | 是 | N/A
|
|
||||||
[Apple 台湾](https://www.apple.com/tw/) | 是 | N/A
|
|
||||||
[Microsoft 中国](https://www.microsoft.com/zh-cn/) | 是 | N/A
|
|
||||||
[Microsoft 香港](https://www.microsoft.com/zh-hk/) | 是 | N/A
|
|
||||||
[Microsoft 台湾](https://www.microsoft.com/zh-tw/) | 是 | N/A
|
|
||||||
[LeanCloud](https://leancloud.cn/) | 是 | N/A
|
|
||||||
[V2EX](https://www.v2ex.com/) | 是 | 是
|
|
||||||
[Apple4us](https://apple4us.com/) | 是 | N/A
|
|
||||||
[Ruby China](https://ruby-china.org/) | 是 | 是
|
|
||||||
[少数派](https://sspai.com/) | 是 | N/A
|
|
||||||
|
|
||||||
## 参考文献
|
|
||||||
|
|
||||||
- [Guidelines for Using Capital Letters - ThoughtCo.](https://www.thoughtco.com/guidelines-for-using-capital-letters-1691724)
|
|
||||||
- [Letter case - Wikipedia](https://en.wikipedia.org/wiki/Letter_case)
|
|
||||||
- [Punctuation - Oxford Dictionaries](https://en.oxforddictionaries.com/grammar/punctuation)
|
|
||||||
- [Punctuation - The Purdue OWL](https://owl.english.purdue.edu/owl/section/1/6/)
|
|
||||||
- [How to Use English Punctuation Correctly - wikiHow](https://www.wikihow.com/Use-English-Punctuation-Correctly)
|
|
||||||
- [格式 - openSUSE](https://zh.opensuse.org/index.php?title=Help:%E6%A0%BC%E5%BC%8F)
|
|
||||||
- [全形和半形 - 维基百科](https://zh.wikipedia.org/wiki/%E5%85%A8%E5%BD%A2%E5%92%8C%E5%8D%8A%E5%BD%A2)
|
|
||||||
- [引号 - 维基百科](https://zh.wikipedia.org/wiki/%E5%BC%95%E8%99%9F)
|
|
||||||
- [疑问惊叹号 - 维基百科](https://zh.wikipedia.org/wiki/%E7%96%91%E5%95%8F%E9%A9%9A%E5%98%86%E8%99%9F)
|
|
||||||
|
|
||||||
## Forks
|
|
||||||
|
|
||||||
衍生项目的用法可能与本项目存在差异。
|
|
||||||
|
|
||||||
- [mzlogin/chinese-copywriting-guidelines](https://github.com/mzlogin/chinese-copywriting-guidelines)
|
|
||||||
3305
package-lock.json
generated
Normal file
3305
package-lock.json
generated
Normal file
File diff suppressed because it is too large
Load Diff
62
package.json
62
package.json
@@ -1,32 +1,21 @@
|
|||||||
{
|
{
|
||||||
"name": "chinese-copywriting-guidelines",
|
"name": "chinese-copywriting-guidelines",
|
||||||
"version": "1.0.1",
|
"version": "0.1.0",
|
||||||
"description": "Chinese Copywriting Guidelines",
|
"description": "Chinese Copywriting Guidelines",
|
||||||
"author": "Tunghsiao Liu",
|
"author": "Tunghsiao Liu",
|
||||||
"homepage": "http://github.com/sparanoid/chinese-copywriting-guidelines",
|
"homepage": "http://github.com/sparanoid/chinese-copywriting-guidelines",
|
||||||
"main": "README.md",
|
"main": "README.md",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"test": "remark .",
|
"test": "grunt"
|
||||||
"release": "npx release-it"
|
|
||||||
},
|
|
||||||
"remarkConfig": {
|
|
||||||
"plugins": [
|
|
||||||
"remark-preset-lint-consistent",
|
|
||||||
"remark-preset-lint-recommended",
|
|
||||||
[
|
|
||||||
"remark-lint-list-item-indent",
|
|
||||||
"space"
|
|
||||||
]
|
|
||||||
]
|
|
||||||
},
|
},
|
||||||
"repository": {
|
"repository": {
|
||||||
"type": "git",
|
"type": "git",
|
||||||
"url": "https://github.com/sparanoid/chinese-copywriting-guidelines.git"
|
"url": "git://github.com/sparanoid/chinese-copywriting-guidelines.git"
|
||||||
},
|
},
|
||||||
"bugs": {
|
"bugs": {
|
||||||
"url": "https://github.com/sparanoid/chinese-copywriting-guidelines/issues"
|
"url": "http://github.com/sparanoid/chinese-copywriting-guidelines/issues"
|
||||||
},
|
},
|
||||||
"license": "MIT",
|
"license": "WTFPL",
|
||||||
"keywords": [
|
"keywords": [
|
||||||
"chinese",
|
"chinese",
|
||||||
"copywriting",
|
"copywriting",
|
||||||
@@ -34,23 +23,28 @@
|
|||||||
],
|
],
|
||||||
"readmeFilename": "README.md",
|
"readmeFilename": "README.md",
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"remark-cli": "^11.0.0",
|
"grunt": "^1.0.3",
|
||||||
"remark-lint-list-item-indent": "^3.1.1",
|
"grunt-bump": "^0.8.0",
|
||||||
"remark-preset-lint-consistent": "^5.1.1",
|
"grunt-conventional-changelog": "^6.1.0",
|
||||||
"remark-preset-lint-recommended": "^6.1.2"
|
"grunt-npm": "0.0.2",
|
||||||
|
"matchdep": "^2.0.0"
|
||||||
},
|
},
|
||||||
"release-it": {
|
"contributors": [
|
||||||
"git": {
|
"greenkeeperio-bot <support@greenkeeper.io>",
|
||||||
"commitArgs": "-S",
|
"Zhuang Ma <chumpma@gmail.com>",
|
||||||
"commitMessage": "chore: release v${version}",
|
"Jason Lee <huacnlee@gmail.com>",
|
||||||
"tagArgs": "-s",
|
"Greenkeeper <support@greenkeeper.io>",
|
||||||
"tagAnnotation": "chore: release v${version}"
|
"greenkeeper[bot] <greenkeeper[bot]@users.noreply.github.com>",
|
||||||
},
|
"huhuhang <huhuhang@users.noreply.github.com>",
|
||||||
"github": {
|
"jxlwqq <jxlwqq@gmail.com>",
|
||||||
"release": true
|
"pityonline <pityonline@gmail.com>",
|
||||||
},
|
"tzx <district10@users.noreply.github.com>",
|
||||||
"npm": {
|
"NauxLiu@users.noreply.github.com>",
|
||||||
"publish": false
|
"Charlie Jade <summer.alex07@gmail.com>",
|
||||||
}
|
"hotoo@users.noreply.github.com>",
|
||||||
}
|
"Elethom Hunter <elethomhunter@gmail.com>",
|
||||||
|
"Huei Tan <huei90@users.noreply.github.com>",
|
||||||
|
"Yang Li <idealhack@gmail.com>",
|
||||||
|
"ddanist <danx2ist@gmail.com>"
|
||||||
|
]
|
||||||
}
|
}
|
||||||
|
|||||||
1685
pnpm-lock.yaml
generated
1685
pnpm-lock.yaml
generated
File diff suppressed because it is too large
Load Diff
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"$schema": "https://docs.renovatebot.com/renovate-schema.json",
|
|
||||||
"extends": [
|
"extends": [
|
||||||
"config:base"
|
"config:base",
|
||||||
|
":preserveSemverRanges"
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
|
|||||||
Reference in New Issue
Block a user