描述

统一中文文案、排版的相关用法，降低团队成员之间的沟通成本，增强网站气质。

比较以下排版：

排版 1

LeanCloud 数据存储是围绕 AVObject 进行的.每个 AVObject 都包含了与 JSON 兼容的 key-value 对应的数据。数据是 schema-free 的，你不需要在每个 AVObject 上提前指定存在哪些键，只要直接设定对应的 key-value 即可。 gitHub 是一个通过 git 进行版本控制的软件源代码托管服务，由 GitHub 公司（曾称 Logical Awesome ）的开发者 Chris Wanstrath 、 PJ Hyett 和 Tom Preston-Werner 使用 Ruby on Rails 编写而成。

排版 2

LeanCloud 数据存储是围绕 AVObject 进行的。每个 AVObject 都包含了与 JSON 兼容的 key-value 对应的数据。数据是 schema-free 的，你不需要在每个 AVObject 上提前指定存在哪些键，只要直接设定对应的 key-value 即可。 GitHub 是一个通过 Git 进行版本控制的软件源代码托管服务，由 GitHub 公司（曾称 Logical Awesome ）的开发者 Chris Wanstrath 、 PJ Hyett 和 Tom Preston-Werner 使用 Ruby on Rails 编写而成。

很明显，第二种排版中英文有空格，标点符号也使用正确，专有名词使用正确，会让人看起来更舒服，也更专业。本系统正是基于中文文案排版指北（简体中文版）进行纠正，帮助解决中英文混排的排版问题，提高文案可阅读性。

安装

//安装开发中版本
composer require ricoa/copywriting-correct:dev-master

使用

<?php
require_once 'vendor/autoload.php';

use Ricoa\CopyWritingCorrect\CopyWritingCorrectService;

$service=new CopyWritingCorrectService();

$text=$service->correct('在 LeanCloud 上，数据存储是围绕 AVObject 进行的。');

注入自己的纠正器

继承 \Ricoa\CopyWritingCorrect\Correctors\Corrector ，并实现 handle 方法。例如 ExampleCorrector.php

<?php

class ExampleCorrector extends \Ricoa\CopyWritingCorrect\Correctors\Corrector {

    protected static $corrector=null;

    /**
     * @param string $text
     *
     * @return mixed
     */
    public function handle($text)
    {
        return $text;
    }
}

使用：

<?php
require_once 'vendor/autoload.php';

use Ricoa\CopyWritingCorrect\CopyWritingCorrectService;

$service=new CopyWritingCorrectService();

$service->addCorrectors([ExampleCorrector::class]);//注入纠正器
$service->resetCorrectors([ExampleCorrector::class]);//重置纠正器，也即废弃默认的纠正器

$text=$service->correct('在 LeanCloud 上，数据存储是围绕 AVObject 进行的。');

已实现

空格

中文字符与半角字符（例如英文字符，数字，英文标点符号）间添加空格。
数字后面跟着英文字符则在数字后添加空格（适用于数字+单位，例如 1 GB ）。
全角标点与其他字符之间不加空格
希腊字母与中文字符以及数字和英文字符之间添加空格（不在指北内）。

标点符号

不重复使用中文标点符号（仅！和？），重复时只保留第一个。

全角和半角

中文后使用全角中文标点符号（包括！？。，（）：；）。
数字使用半角字符。
全角转半角（不在指北内）。

[
	'０' , '１' , '２' , '３' , '４' ,
	'５' , '６' , '７' , '８' , '９' ,
	'Ａ' , 'Ｂ' , 'Ｃ' , 'Ｄ' , 'Ｅ' ,
	'Ｆ' , 'Ｇ' , 'Ｈ' , 'Ｉ' , 'Ｊ' ,
	'Ｋ' , 'Ｌ' , 'Ｍ' , 'Ｎ' , 'Ｏ' ,
	'Ｐ' , 'Ｑ' , 'Ｒ' , 'Ｓ' , 'Ｔ' ,
	'Ｕ' , 'Ｖ' , 'Ｗ' , 'Ｘ' , 'Ｙ' ,
	'Ｚ' , 'ａ' , 'ｂ' , 'ｃ' , 'ｄ' ,
	'ｅ' , 'ｆ' , 'ｇ' , 'ｈ' , 'ｉ' ,
	'ｊ' , 'ｋ' , 'ｌ' , 'ｍ' , 'ｎ' ,
	'ｏ' , 'ｐ' , 'ｑ' , 'ｒ' , 'ｓ' ,
	'ｔ' , 'ｕ' , 'ｖ' , 'ｗ' , 'ｘ' ,
	'ｙ' , 'ｚ' , '－' , '　' , '／' ,
	'％' , '＃' , '＠' , '＆' , '＜' ,
	'＞' , '［' , '］' , '｛' , '｝' ,
	'＼' , '｜' , '＋' , '＝' , '＿' ,
	'＾' , '￣' , '｀'
];
//转
[
	'0', '1', '2', '3', '4',
	'5', '6', '7', '8', '9',
	'A', 'B', 'C', 'D', 'E',
	'F', 'G', 'H', 'I', 'J',
	'K', 'L', 'M', 'N', 'O',
	'P', 'Q', 'R', 'S', 'T',
	'U', 'V', 'W', 'X', 'Y',
	'Z', 'a', 'b', 'c', 'd',
	'e', 'f', 'g', 'h', 'i',
	'j', 'k', 'l', 'm', 'n',
	'o', 'p', 'q', 'r', 's',
	't', 'u', 'v', 'w', 'x',
	'y', 'z', '-', ' ', '/',
	'%', '#', '@', '&', '<',
	'>', '[', ']', '{', '}',
	'\\','|', '+', '=', '_',
	'^', '~', '`'
];

名词

专有名词使用正确的大小写（部分名词达成，见词典）

未实现

全角和半角

遇到完整的英文整句、特殊名词，其內容使用半角标点

改进

有什么新的想法和建议，欢迎提交 issue 或者 Pull Requests。

License

基于 MIT license.

avobject

排版

PHP

字符

9 条回复 • 2019-03-23 10:17:13 +08:00

neroxps

2017-04-26 16:47:31 +08:00

bug 反馈，括号后面的英文标点不会纠正成中文符号。

例如：（你好）. 应该纠正成（你好）。

另建议（ abc ）能够纠正成 (abc) 意思就是如果括号内容是中文，就用中文括号，如果是英文，就应该用英文括号。

小建议 XD

geelaw

2017-04-26 16:49:46 +08:00

这个指北本身问题也很多，此外这个实现也有很多问题。

“在合适的位置添加空格”并不是正确的排版方式，而是一种因为现代浏览器不能正确排版而做的 hack 。那些位置应该具有的是 *空白* 而不是空格。如果你使用 Word 或 Outlook 就不会有这个问题。

另外看起来本文提到的 example 并不是最新的纠正器的结果：比如“。”和“ GitHub ”之间不需要空格，“ Awesome ”和“）”之间也不需要，“ Wanstrath ”、“、”和“ PJ ”之间也不需要。但是目前网页演示得到的结果是正确的。

汉字和拉丁字母之间插入空格的实现是错误的，例如“法语中两人初次见面可以用Énchanté(e)打招呼。”中第一个空格并未被加入。

数字和拉丁字母之间增加空格也不一定是正确的，例如 1Password 。

纠正拼写太激进，譬如 ruby 变 Ruby 和 window(s) 变 Windows 都不一定是正确的，还有 chef 、 grape 、 office 、 underscore 等词语也不应该自动纠正。以下词语是正确拼写： Vim 、 git （它可以是命令的名字）。

把 ie 替换为可能是错误的，它还可能是 i.e.。

拼写纠正器可能会意外地把 git-scm.org 纠正为非 canonical 的写法 Git-scm.org 。

另外双写、三连写“！”或“？”是正确用法。