textlint-rule-preset-codeprep
Install
Install with npm:
npm install textlint-rule-preset-codeprep
Usage
Via .textlintrc
(Recommended)
{
"rules": {
"preset-codeprep": true
}
}
Via CLI
textlint --preset codeprep README.md
ルール一覧
- 1文の長さは90文字以下とする
- カンマは1文中に3つまで
- 読点は1文中に3つまで
- 連続できる最大の漢字長は5文字まで
- 漢数字と算用数字を使い分けます
- 「ですます調」、「である調」を統一します
- 文末の句点記号として「。」を使います
- 二重否定は使用しない
- ら抜き言葉を使用しない
- 逆接の接続助詞「が」を連続して使用しない
- 同じ接続詞を連続して使用しない
- 同じ助詞を連続して使用しない
- UTF8-MAC 濁点を使用しない
- 感嘆符!!、感嘆符??を使用しない
- 半角カナを使用しない
- 弱い日本語表現を使用しない
- 同一の単語を間違えて連続しているのをチェックする
- よくある日本語の誤用をチェックする
- テクニカルワードをチェックする
- 表記ゆれをチェックする
1文の長さは90文字以下とする
長過ぎる文は読みにくさに繋がるため、適切な単位で文を区切ってください。
"sentence-length": {
max: 90
},
カンマは1文中に3つまで
カンマ(,)の多用は、文が長くなっている可能性があります。
"max-comma": {
max: 3
},
読点は1文中に3つまで
読点(、)の多用は、文が長くなっている可能性があります。
"max-ten": {
max: 3
},
連続できる最大の漢字長は6文字まで
https://github.com/azu/textlint-rule-max-kanji-continuous-len
漢字同士が連続していると読みにくさにつながります。
固有名詞は allow
オプションに記述して回避します。
"max-kanji-continuous-len": {
max: 6
},
漢数字と算用数字を使い分けます
数量を表現し、数を数えられるものは算用数字を使用します。任意の数に置き換えても通用する語句がこれに該当します。
慣用的表現、熟語、概数、固有名詞、副詞など、漢数字を使用することが一般的な語句では漢数字を使います。
"arabic-kanji-numbers": true,
「ですます調」、「である調」を統一します
- 見出しは自動
- 本文はですます調
- 箇条書きはである調
文体は見出し、本文、箇条書きの中では統一した表記にします。
"no-mix-dearu-desumasu": {
"preferInHeader": "",
"preferInBody": "ですます",
"preferInList": "である",
"strict": true
},
文末の句点記号として「。」を使います
https://github.com/textlint-ja/textlint-rule-ja-no-mixed-period
文末には「。」を使い文を区切ります。
「。」のつけ忘れのチェックや「:」で文を区切らないようにします。
"ja-no-mixed-period": {
"periodMark": "。"
},
二重否定は使用しない
"no-double-negative-ja": true,
ら抜き言葉を使用しない
"no-dropping-the-ra": true,
逆接の接続助詞「が」を連続して使用しない
https://github.com/takahashim/textlint-rule-no-doubled-conjunctive-particle-ga
逆接の接続助詞「が」は、特に否定の意味ではなくても安易に使われてしまいがちです。
同一文中に複数回出現していないかをチェックします。
"no-doubled-conjunctive-particle-ga": true,
同じ接続詞を連続して使用しない
https://github.com/takahashim/textlint-rule-no-doubled-conjunction
"no-doubled-conjunction": true,
同じ助詞を連続して使用しない
"no-doubled-joshi": {
"min_interval": 1
},
UTF8-MAC 濁点を使用しない
文章中にUTF8-MAC 濁点は不要です。 ファイルからコピー&ペーストした文字である場合があります。
"no-nfd": true,
感嘆符!!、感嘆符??を使用しない
https://github.com/azu/textlint-rule-no-exclamation-question-mark
特定の感嘆符または感嘆符を使用する場合は、オプションで許可して利用してください。
"rules": {
"no-exclamation-question-mark": {
// allow to use !
"allowHalfWidthExclamation": false,
// allow to use !
"allowFullWidthExclamation": true,
// allow to use ?
"allowHalfWidthQuestion": false,
// allow to use ?
"allowFullWidthQuestion": true
}
}
半角カナを使用しない
全角カタカナを使用してください。
"no-hankaku-kana": true,
弱い日本語表現の利用を使用しない
https://github.com/textlint-ja/textlint-rule-ja-no-weak-phrase
〜かもしれない
等の弱い表現を使用しない。
"ja-no-weak-phrase": true,
同一の単語を間違えて連続しているのをチェックする
https://github.com/textlint-ja/textlint-rule-ja-no-successive-word
同一の単語(形態素解析したtoken)が連続している場合は誤字の可能性があります。
誤字でない場合は、Issue報告してください。
"ja-no-successive-word": true,
よくある日本語の誤用をチェックする
日本語や技術表現における漢字の誤用などをチェックするルールです。
"ja-no-abusage": true
テクニカルワードをチェックする
WEB+DB PRESS用語統一ルールやJavaScript関連の用語などを含んだテクニカルワードをチェックするルールです。
"ja-no-abusage": true
表記ゆれをチェックする
表記ゆれをチェックするルールです。
"prh": {
"rulePaths": [
path.join(__dirname, "prh.yml")
]
}