数の書き方が混ざっている

number-style-consistency既定で動く（情報）日本語 / 英語

3件と三件、1,000 と 1000、10% と 10％のように、一つの文書で数の書き方が混ざっている所

例

指摘される文

今月の問い合わせは 12件、先月は 9件、先々月は 7件でした。うち三件は同じ内容です。

chaff の出力

1:35 数え方の数を「三件」と書いています（この文書はふつう「12件」の書き方。4 箇所のうち 1 箇所が違う）

直した文

今月の問い合わせは 12件、先月は 9件、先々月は 7件でした。うち 3件は同じ内容です。

chaff の出力

指摘なし

この例で使った chaff.yaml

genre: blog/tech

直し方

文書の多いほうの書き方に合わせてください。チームで決めているなら、STYLE.md に書いておくと迷いません。

なぜ指摘するのか

数をどう書くか（3件か三件か、1,000 か 1000 か、10% か 10％か 10パーセントか）は、どれでも読めます。困るのは一つの文書の中で混ざることで、読み手は違う書き方に違う意味があるのかと迷い、検索でも別の語になります。chaff はどれが正しいかを決めず、数え方の語の前の数（漢数字か算用数字か）、位取りのコンマ、百分率の書き方、英語の数（three か 3 か、10 未満と 10〜12 は別に）ごとに、文書の中で少ないほうを指摘します。

指摘しないもの

鉤括弧や引用符の中の数、注や URL を含む文、日本語の中の英文は数えません。「一つ」「一人」のような一だけの漢数字と、「万人」「千人」のような位の字だけの漢数字、「第三回」「統一」のように漢字の後ろの数、日付の日・月・年、英語で名前の一部になった数（Grade 5 students、Room 12）は数えません。位取りは、通貨の記号か数え方の語・単位が付いた大きな数だけを見て、年に見える 4 桁の数（2019 年）、番号（H.R. 5376）、版や電話番号、コミットのハッシュのような 16 進の符号（2704b2d）は見ません。全角と半角の違いは fullwidth-alnum-consistency が見ます。法務・文学・話し言葉のジャンルでは見ません。

止める・ゆるめる

この一か所だけ黙らせる（文書に書く）

チームでゆるめる（理由は chaff.yaml にコメントで残ります）

npx chaffjs relax number-style-consistency --why "理由"

チームで止める（chaff.yaml）

rules: number-style-consistency: off

技術的な情報

層: L2
状態: 安定
重さ: 情報
対象の言語: 日本語と英語
向いている文章: blog, business, technical, docs, academic, legal, literature, speech

強さ（段階）

chaff.yaml の rules にこの名前と段階を書くと変わります。書かなければ、ジャンルが決めた段階で動きます（どのジャンルで動くかは下の「ジャンルごとの動き」にあります）。

strict	少ないほうの書き方が、その種類の数の 49% 以下のとき指摘
normal	少ないほうの書き方が、その種類の数の 34% 以下のとき指摘
relaxed	少ないほうの書き方が、その種類の数の 20% 以下のとき指摘

ジャンルごとの動き

既定で動くジャンル: technical/spec, technical/readme, blog/tech, blog/essay, blog/owned-media, business/proposal, business/report, business/email, business/press-release, business/meeting-notes, docs/manual, docs/faq, docs/glossary, academic/paper
このルールを止めるジャンル: legal/contract, legal/statute, legal/judgment, legal/patent, literature/fiction, literature/essay, literature/poetry, literature/play, speech/address, speech/transcript

ジャンル

指摘の文

「{written}」と書いています（この文書はふつう「{usual}」の書き方。{of} 箇所のうち {count} 箇所が違う）

数え方の数を「{written}」と書いています（この文書はふつう「{usual}」の書き方。{of} 箇所のうち {count} 箇所が違う）

「{written}」と書いています（この文書は大きな数をふつう「{usual}」のように書きます。{of} 箇所のうち {count} 箇所が違う）

百分率を「{written}」と書いています（この文書はふつう「{usual}」の書き方。{of} 箇所のうち {count} 箇所が違う）

数を「{written}」と書いています（この文書は 10 未満の数をふつう「{usual}」のように書きます。{of} 箇所のうち {count} 箇所が違う）

数を「{written}」と書いています（この文書は 10 から 12 の数をふつう「{usual}」のように書きます。{of} 箇所のうち {count} 箇所が違う）

書き直しの深さ（chaff fix-plan --depth）: light — 語と文を直す。構成と文体は残す

このページはルールの定義ファイルから作られています:packages/chaff/rules/number-style-consistency.yaml