技術文書向けのtextlintルールプリセットです。 全体的に少し厳しめの設定がデフォルト値となっているため、文章に合わせて設定値を変更する必要があります。
また、連続できる最大の漢字長は6文字までのように文章全体として例外が必ず出てくるルールもデフォルトで入っています。
ルールによってはallowオプションで例外を規定できるようになっているため、例外を明示しつつ利用することを想定しています。
合わせて利用することを想定しているfilterルール(例外を明示できる)も参照してください。
Install with npm:
npm install textlint-rule-preset-ja-technical-writing
Via .textlintrc(Recommended)
{
"rules": {
"preset-ja-technical-writing": true
}
}Via CLI
textlint --preset ja-technical-writing README.md
- 1文の長さは100文字以下とする
- カンマは1文中に3つまで
- 読点は1文中に3つまで
- 連続できる最大の漢字長は6文字まで
- 漢数字と算用数字を使い分けます
- 「ですます調」、「である調」を統一します
- 文末の句点記号として「。」を使います
- 二重否定は使用しない
- ら抜き言葉を使用しない
- 逆接の接続助詞「が」を連続して使用しない
- 同じ接続詞を連続して使用しない
- 同じ助詞を連続して使用しない
- UTF8-MAC 濁点を使用しない
- 不必要な制御文字を使用しない
- 感嘆符!！、感嘆符?？を使用しない
- 半角カナを使用しない
- 弱い日本語表現の利用を使用しない
- 同一の単語を間違えて連続しているのをチェックする
- よくある日本語の誤用をチェックする
- 冗長な表現をチェックする
長過ぎる文は読みにくさに繋がるため、適切な単位で文を区切ってください。
厳しめの設定にしたい場合は90文字を推奨しています。
"sentence-length": {
max: 100
},
過去の設定の履歴は以下のようになっています。
- バージョン3.0.0+: 100文字以下
- バージョン2.0.0以下: 90文字以下
カンマ（,）の多用は、文が長くなっている可能性があります。
"max-comma": {
max: 3
},
読点（、）の多用は、文が長くなっている可能性があります。
"max-ten": {
max: 3
},
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 濁点は不要です。 ファイルからコピー＆ペーストした文字である場合があります。
"no-nfd": true,
https://github.com/textlint-rule/textlint-rule-no-invalid-control-character
改行(\n)やタブ(\t)以外の一般的な文章にはでてこない不自然な制御文字が入るのを防止します。
"no-invalid-control-character": true,
https://github.com/azu/textlint-rule-no-exclamation-question-mark
特定の感嘆符または感嘆符を使用する場合は、オプションで許可して利用してください。
"no-exclamation-question-mark": 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
https://github.com/textlint-ja/textlint-rule-ja-no-redundant-expression
冗長な表現とは、その文から省いても意味が通じるような表現を示しています。
"することができる"という冗長な表現を"できる"にするといったルールです。
"ja-no-redundant-expression": true
See Releases page.
次のルールでバージョンが更新されます。
- Patch リリース
- 各ルールのバグ修正 (警告を減らす方向への修正)
- ドキュメントの改善
- 内部的な変更 (リファクタリングやテストの改善など)
- リリース失敗時の再リリース
- Minor リリース
- 各ルールのバグ修正 (警告を増やす方向への修正)
- 新オプションの追加
- 既存ルールの非推奨化
- Major リリース
- プリセットへのルールの追加
- プリセットからルールの削除
- 既存のオプション値の変更
更新内容はReleases pageを参照してください。
このプリセットを利用しているユーザーです。
ユーザーリストへのPRも募集しています。
質問は以下のGitterでお願いします。
Install devDependencies and Run npm test:
npm i -d && npm test
Pull requests and stars are always welcome.
For bugs and feature requests, please create an issue.
- Fork it
- Create your feature branch:
git checkout -b my-new-feature - Commit your changes:
git commit -am 'Add some feature' - Push to the branch:
git push origin my-new-feature - Submit a pull request :D
MIT © azu