更好的中文文案排版
统一中文文案、排版的相关用法,降低团队成员之间的沟通成本,增强网站气质。
安装
使用 composer 安装:
composer require "jxlwqq/chinese-typesetting"
复制代码
使用
添加空格
use Jxlwqq\ChineseTypesetting\ChineseTypesetting;
$chineseTypesetting = new ChineseTypesetting();
$text = '今天,我在Apple Store上购买了一台13英寸MacBook Pro笔记本电脑,花费了14188元。';
$chineseTypesetting->insertSpace($text);
// output: 今天,我在 Apple Store 上购买了一台 13 英寸 MacBook Pro 笔记本电脑,花费了 14188 元。
$text = 'α碳原子为与有机物中与官能团相连的第一个碳原子,第二个为β碳原子,以此类推。';
$chineseTypesetting->insertSpace($text);
// output: α 碳原子为与有机物中与官能团相连的第一个碳原子,第二个为 β 碳原子,以此类推。
复制代码
在中文与英文字母/用于数学、科学和工程的希腊字母/数字之间添加空格。 参考依据:中文文案排版指北:空格 。
目前,比较主流的约定是在中文与英文之间添加空格。我在此基础上,增加了对用于数学、科学和工程的希腊字母的支持。
全角转半角
use Jxlwqq\ChineseTypesetting\ChineseTypesetting;
$chineseTypesetting = new ChineseTypesetting();
$text = '这个名为 ABC 的蛋糕只卖 1000 元。';
$chineseTypesetting->full2Half($text);
// output: 这个名为 ABC 的蛋糕只卖 1000 元。
复制代码
有限度的全角转半角(英文、数字、空格以及一些特殊字符等使用半角字符)。参考依据:中文文案排版指北:全角和半角。
修复错误的标点符号
use Jxlwqq\ChineseTypesetting\ChineseTypesetting;
$chineseTypesetting = new ChineseTypesetting();
// 修复省略号的错误用法
$text = '她轻轻地哼起了《摇篮曲》:“月儿明,风儿静,树叶儿遮窗櫺啊…”';
$chineseTypesetting->fixPunctuation($text);
// output: 她轻轻地哼起了《摇篮曲》:“月儿明,风儿静,树叶儿遮窗櫺啊……”
// 中文后面使用全角中文标点
$text = '你好,世界.';
$chineseTypesetting->fixPunctuation($text);
// output: 你好,世界。
// 不重复使用中文标点符号
$text = '你好激动啊!!!';
$chineseTypesetting->fixPunctuation($text);
// output: 你好激动啊!
复制代码
清除 HTML 标签的样式
use Jxlwqq\ChineseTypesetting\ChineseTypesetting;
$chineseTypesetting = new ChineseTypesetting();
// 清除 Class 属性
$text = '<p class="class-name">你好,世界。</p>';
$chineseTypesetting->removeClass($text);
// output: <p>你好,世界。</p>
// 清除 ID 属性
$text = '<p id="id-name">你好,世界。</p>';
$chineseTypesetting->removeId($text);
// output: <p>Hello World!</p>
// 清除 Style 属性
$text = '<p style="color: #FFFFFF;">你好,世界。</p>';
$chineseTypesetting->removeStyle($text);
// output: <p>你好,世界。</p>
复制代码
清除空的段落标签
use Jxlwqq\ChineseTypesetting\ChineseTypesetting;
$chineseTypesetting = new ChineseTypesetting();
// 清除空的段落标签
$text = '<p>你好,世界。</p><p></p>';
$chineseTypesetting->removeEmptyParagraph($text);
// output: <p>你好,世界。</p>
复制代码
清除所有空的标签
use Jxlwqq\ChineseTypesetting\ChineseTypesetting;
$chineseTypesetting = new ChineseTypesetting();
// 清除所有空的标签
$text = '<p>你好,世界。<span></span></p>';
$chineseTypesetting->removeEmptyTag($text);
// output: <p>你好,世界。</p>
复制代码
清除段首缩进
use Jxlwqq\ChineseTypesetting\ChineseTypesetting;
$chineseTypesetting = new ChineseTypesetting();
// 清除段首缩进
$text = '<p> 你好,世界。</p>';
$chineseTypesetting->removeIndent($text);
// output: <p>你好,世界。</p>
复制代码
首行是否缩进,争议较大,个人倾向于段首空两格,会破坏美感的观点。
使用全部或指定的方法来纠正排版
use Jxlwqq\ChineseTypesetting\ChineseTypesetting;
$chineseTypesetting = new ChineseTypesetting();
// 使用全部方法来纠正排版
$text = '<p class="class-name" style="color: #FFFFFF;"> Hello世界。</p>';
$chineseTypesetting->correct($text);
// output: <p>Hello 世界。</p>
// 使用指定方法来纠正排版
$text = '<p class="class-name" style="color: #FFFFFF;"> Hello世界。</p>';
$chineseTypesetting->correct($text, ['insertSpace', 'removeClass', 'removeIndent']);
// output: <p style="color: #FFFFFF;">Hello 世界。</p>
复制代码
GitHub 地址:github.com/jxlwqq/chin…