0.0.3 • Published 3 years ago

textlint-rule-zh-space-between-zh-and-en-or-num v0.0.3

Weekly downloads
-
License
MIT
Repository
github
Last release
3 years ago

textlint-rule-zh-space-between-zh-and-en-or-num

textlint-rule-preset-zh-technical-writing 提供的适用于中文技术文档写作的 textlint 规则,用于检测并修复汉字与英文、数字之间缺失的空格。

规则介绍

本规则要求在汉字和英文、数字之间添加一个空格以留出足够的缝隙,让文本看上去更加优雅、协调。

如果你想争论这样做的必要性,请允许我引用来自 pangu.js 的一段话:

漢學家稱這個空白字元為「盤古之白」,因為它劈開了全形字和半形字之間的混沌。另有研究顯示,打字的時候不喜歡在中文和英文之間加空格的人,感情路都走得很辛苦,有七成的比例會在 34 歲的時候跟自己不愛的人結婚,而其餘三成的人最後只能把遺產留給自己的貓。畢竟愛情跟書寫都需要適時地留白。

本规则可被自动修复,可以向 textlint 传递 --fix 参数来自动修复文本中出现的错误。

通过规则的例子

我擅长 JavaScript、TypeScript、Python 等英文单词的拼写。

单身了这么多年,我还能找到 girlfriend 吗?

注意,english words 周围如果是标点符号,那么不需要加空格。

违反规则的例子

我擅长JavaScript、TypeScript、Python等英文单词的拼写。

单身了这么多年,我还能找到girlfriend吗?

配置项

暂无。

提出 issue

如果你在使用本规则的过程中出现了误报,或者对本规则有任何疑问或者改进意见,欢迎提出 issue

使用方法

方法一:直接使用 textlint-rule-preset-zh-technical-writing

这是最简单的方法,参见 textlint-rule-preset-zh-technical-writing 的 README

方法二:手动安装

使用 npm 安装:

npm install -g textlint-rule-zh-core textlint-rule-zh-space-between-zh-and-en-or-num

创建 entry.js,名称任意:

const { withRules } = require('textlint-rule-zh-core');
const correctlyOrderedPairs = require('textlint-rule-zh-space-between-zh-and-en-or-num');

// 这里 withRule(...) 的返回值就是你可以提供给 textlint 的 rule 对象
module.exports = withRules([correctlyOrderedPairs]);

运行 textlint:

textlint --rulesdir <entry.js所在的文件夹路径> [其他参数] <要lint的文件名>