chaffjs 0.16.0 → 0.18.0

package/rules/duplicate-definition.yaml

@@ -21,6 +21,64 @@ how_to_fix:
   ja: 定義を一か所にまとめ、もう一方は「第2条に定める{term}」のように参照にしてください。意図して意味を変えているなら、別の語にします。
   en: Keep one definition and refer to it from the other place. If the meaning changes on purpose, use a different term.
 
-levels: { strict: 1, normal: 1, relaxed: 1 }
+# chaff explain と規則の一覧には指摘が無いので、{term} をこう読ませる。
+placeholders:
+  term:
+    ja: 〇〇
+    en: the term
+
+levels: { strict: error, normal: warning, relaxed: info }
 
 use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 同じ語を、文書の二か所で定義している所
+  en: The same term defined in two places in one document
+example:
+  ja:
+    before: |
+      # 利用規約
+
+      ## 第1条（定義）
+
+      「本サービス」とは、当社が提供する予約の仕組みをいう。
+
+      ## 第2条（利用）
+
+      「本サービス」とは、当社が運営する予約のサイトをいう。利用者は、本サービスを無料で使える。
+    after: |
+      # 利用規約
+
+      ## 第1条（定義）
+
+      「本サービス」とは、当社が運営する予約のサイトをいう。
+
+      ## 第2条（利用）
+
+      利用者は、本サービスを無料で使える。
+  en:
+    before: |
+      # Terms of use
+
+      ## 1. Definitions
+
+      "Service" means the booking system we provide.
+
+      ## 2. Use
+
+      "Service" means the booking website we run. Users may use the Service free of charge.
+    after: |
+      # Terms of use
+
+      ## 1. Definitions
+
+      "Service" means the booking website we run.
+
+      ## 2. Use
+
+      Users may use the Service free of charge.
+
+not_flagged:
+  ja: 二つの定義が食い違っているかは決めません。二つ目を指すだけです。語を名前にした見出しは定義に数えません。
+  en: Whether the two definitions conflict is not decided; only the second is pointed at. A heading that names the term is not a definition.

package/rules/emoji-density.yaml

@@ -24,3 +24,28 @@ how_to_fix:
 levels: { strict: 3, normal: 8, relaxed: 20 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 絵文字が多すぎて、飾りのほうが目立つ所
+  en: So many emoji that the decoration drowns the text
+example:
+  ja:
+    pad: true
+    before: |
+      新機能が出ました🎉🎉 すぐに試せます🚀🔥 感想をお待ちしています🙏✨💬
+    after: |
+      新機能が出ました🎉 すぐに試せます。感想をお待ちしています。
+  en:
+    pad: true
+    before: |
+      The new feature is live 🎉 Try it today 🚀 We would love your feedback 🙏✨
+    after: |
+      The new feature is live 🎉 Try it today, and tell us what you think.
+
+not_flagged:
+  ja: 短い文書（日本語 500 字、英語 200 語より短いもの）は測りません。
+  en: Documents under 200 words are not measured.
+level_meaning:
+  ja: 1000 字あたり {limit} 個まで
+  en: up to {limit} per 1000 words

package/rules/empty-conclusion.yaml

@@ -3,6 +3,7 @@ layer: L4
 status: stable
 how_to_find: empty-conclusion
 severity: warning
+uses: [pos]
 
 name:
   ja: 結びに中身がない
@@ -36,3 +37,31 @@ levels:
 
 # メール・議事録・プレスリリースの結びは挨拶か連絡先で、判断を書く所ではない。
 use_for: [blog, business/report, business/proposal]
+
+group: wording
+summary:
+  ja: 本文をなぞるだけで、読み手に何も残さない結び（AI に読ませる検査）
+  en: A conclusion that only restates the body and leaves the reader nothing (checked by an AI)
+example:
+  ja:
+    before: |
+      ## まとめ
+
+      この記事では、ビルドを速くする方法を紹介しました。ビルドを速くすることは大切です。
+    after: |
+      ## まとめ
+
+      設定を一行変えるだけで、ビルドが二倍速くなりました。次は、テストを並列で動かします。
+  en:
+    before: |
+      ## Conclusion
+
+      This article described how to make the build faster. A fast build is important.
+    after: |
+      ## Conclusion
+
+      One line of settings made the build twice as fast. Next, we will run the tests in parallel.
+
+not_flagged:
+  ja: 機械では決めません。chaff test で、最後の節だけを AI が読みます。
+  en: No machine decides this. chaff test has an AI read the last section only.

package/rules/empty-intensifier.yaml

@@ -28,3 +28,22 @@ levels:
   relaxed: 3
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: wording
+summary:
+  ja: 「非常に重要」「言うまでもなく」のように、何が大事かを言わずに強めるだけの言い方
+  en: Phrases such as "extremely important" that add weight without saying what matters
+example:
+  ja:
+    before: 期限を守ることは非常に重要です。
+    after: 期限に遅れると、先方の検収が翌月に回り、入金が一か月遅れます。
+  en:
+    before: It is important to note that the deadline is Friday.
+    after: The deadline is Friday; a late delivery pushes payment into next month.
+
+not_flagged:
+  ja: 一覧にある言い回しだけを見ます。「重要です」と書いたあとに理由が続くかどうかは読みません。
+  en: Only the phrases on chaff's list are checked; whether a reason follows is not read.
+level_meaning:
+  ja: 当てはまる言い回しが {limit} 箇所あれば指摘
+  en: reported once there are {limit}

package/rules/excessive-hedging.yaml

@@ -35,3 +35,22 @@ how_to_fix:
 levels: { strict: 3, normal: 6, relaxed: 12 }
 
 use_for: [business, blog, technical, legal, docs, academic, literature, speech]
+
+group: wording
+summary:
+  ja: 「〜の可能性があるかもしれません」のように、逃げの表現を重ねて、何が言いたいのか分からない所
+  en: Hedges piled up ("it may perhaps be possible") until nobody is saying anything
+example:
+  ja:
+    before: 納期は遅れる可能性があるかもしれません。
+    after: 部品の入荷が来週にずれたため、納期は三日遅れます。
+  en:
+    before: It may be that the launch could perhaps slip.
+    after: The launch will slip by three days, because the parts arrive next week.
+
+not_flagged:
+  ja: 逃げの表現が一つだけなら慎重さなので指しません。引用の中の逃げは、書き手ではなく話し手のものなので数えません。
+  en: A single hedge is caution and is not reported. A hedge inside a quotation is the speaker's, not the writer's, and is not counted.
+level_meaning:
+  ja: 1000 語あたり {limit} 個まで（一文に重ねた逃げは、文書の長さによらず指摘）
+  en: up to {limit} per 1000 words (hedges stacked in one sentence are reported whatever the length)

package/rules/expletive-construction.yaml

@@ -25,3 +25,22 @@ how_to_fix:
 levels: { strict: 1, normal: 3, relaxed: 6 }
 
 use_for: [blog, business, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 英語で、There is や It is ... that で主語を後ろへ押しやった文が多い所
+  en: Many sentences that open with "There is" or "It is ... that", pushing the subject to the back
+example:
+  en:
+    config: { rules: { expletive-construction: strict } }
+    before: |
+      There is a meeting on Friday to review the budget. It is the finance team that will lead it.
+    after: |
+      The team meets on Friday to review the budget. The finance team will lead it.
+
+not_flagged:
+  ja: 「it is raining」のように that 節を伴わない It is は数えません。
+  en: '"It is" without a that-clause ("it is raining") is not counted.'
+level_meaning:
+  ja: この形の文 {limit} 回まで
+  en: up to {limit} such sentences

package/rules/heading-echo.yaml

@@ -2,6 +2,7 @@ id: heading-echo
 layer: L1
 status: stable
 how_to_find: heading-echo
+uses: [pos]
 severity: warning
 
 name:
@@ -28,3 +29,34 @@ levels:
   relaxed: 75
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 見出しのすぐ後の文が、見出しをほぼそのまま繰り返している所
+  en: A first sentence that only repeats the heading above it
+example:
+  ja:
+    before: |
+      ## 経費の精算方法
+
+      経費の精算方法について説明します。領収書を添えて、月末までに申請してください。
+    after: |
+      ## 経費の精算方法
+
+      領収書を添えて、月末までに申請してください。
+  en:
+    before: |
+      ## How to claim expenses
+
+      This section explains how to claim expenses. Attach the receipt and submit it by the end of the month.
+    after: |
+      ## How to claim expenses
+
+      Attach the receipt and submit it by the end of the month.
+
+not_flagged:
+  ja: 短い見出し（言葉が少なく、重なりを測れないもの）は見ません。見出しの頭の番号の札（例 3：、Step 3:、1.、第2章）は重なりに数えません。
+  en: Headings too short to measure an overlap are not checked. A number label at the head of a heading (Step 3:, Example 4:, 1., Chapter 2:) is not counted in the overlap.
+level_meaning:
+  ja: 見出しと直後の文の重なりが {limit}% 以上なら指摘
+  en: reported when the first sentence overlaps the heading by {limit}% or more

package/rules/heading-level-skip.yaml

@@ -0,0 +1,78 @@
+id: heading-level-skip
+layer: L1
+status: experimental
+how_to_find: heading-level-skip
+requires: [markdown]
+severity: warning
+
+name:
+  ja: 見出しの深さが飛んでいる
+  en: Heading level skipped
+
+why:
+  ja: 「##」の次に「####」が来ると、間の一段が抜けます。目次や画面読み上げは見出しの深さで文書の形を伝えるので、抜けた段は「どこかの節が消えた」ように読めます。見た目の大きさのために深さを選ぶと起きます。最初の見出しは何段から始めてもよく、一つ前の見出しより二段以上深いときだけ指摘します（markdownlint の MD001 と同じ数え方）。
+  en: A "####" right after a "##" leaves out a level. A table of contents and a screen reader show a document's shape by heading level, so the missing level reads as a section that went missing. It happens when a level is chosen for its size on screen. The first heading may start at any level; only a heading two or more levels deeper than the one before it is reported (as markdownlint's MD001 counts).
+
+message:
+  ja: 見出し「{heading}」の深さが {from} から {to} へ飛んでいます（{expected} のはず）
+  en: 'Heading "{heading}" goes from level {from} to level {to} (expected {expected})'
+
+how_to_fix:
+  ja: 一つ前の見出しより一段だけ深くしてください。文字の大きさを変えたいだけなら、深さではなく表示の設定で変えてください。
+  en: Make the heading one level deeper than the one before it. If only the size on screen was the point, change the style instead of the level.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 「##」の次に「####」が来るように、見出しの深さが一段以上飛んでいる所
+  en: A heading two or more levels deeper than the one before it, as "####" right after "##"
+example:
+  ja:
+    before: |
+      # 手順書
+
+      ## 準備
+
+      道具をそろえます。
+
+      #### 注意
+
+      手袋をはめます。
+    after: |
+      # 手順書
+
+      ## 準備
+
+      道具をそろえます。
+
+      ### 注意
+
+      手袋をはめます。
+  en:
+    before: |
+      # Setup guide
+
+      ## Before you start
+
+      Gather the tools.
+
+      #### Safety
+
+      Wear gloves.
+    after: |
+      # Setup guide
+
+      ## Before you start
+
+      Gather the tools.
+
+      ### Safety
+
+      Wear gloves.
+
+not_flagged:
+  ja: 最初の見出しは何段から始めてもかまいません。浅くなる見出し（「####」の次の「##」）も指しません。
+  en: The first heading may start at any level, and a heading that goes back up ("##" after "####") is not reported.

package/rules/hiragana-fukushi.yaml

@@ -26,3 +26,19 @@ how_to_fix:
 levels: { strict: 1, normal: 1, relaxed: 3 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 「殆ど」「勿論」のように、ひらがなのほうが読みやすい副詞を漢字で書いた所
+  en: A Japanese adverb written in rare kanji where kana is easier to read
+example:
+  ja:
+    before: 参加者の殆どが、勿論その案に賛成しました。
+    after: 参加者のほとんどが、もちろんその案に賛成しました。
+
+not_flagged:
+  ja: 一覧にある副詞だけを見ます。常用漢字で普通に書く副詞（「必ず」「特に」など）は指しません。
+  en: Only the adverbs on chaff's list are checked; adverbs normally written in common kanji are not.
+level_meaning:
+  ja: 当てはまる語が {limit} 箇所あれば指摘
+  en: reported once there are {limit}

package/rules/image-alt-text.yaml

@@ -0,0 +1,54 @@
+id: image-alt-text
+layer: L1
+status: experimental
+how_to_find: image-alt-text
+requires: [markdown]
+severity: warning
+
+name:
+  ja: 画像に代替テキストが無い
+  en: Image without alt text
+
+why:
+  ja: 画像が読み込めないときと、画面読み上げで読むときは、代替テキストだけが画像の代わりに伝わります。「![](図1.png)」のように空だと、そこに何があったのか読み手には分かりません。HTML の <img> は alt 属性が無いものだけを数え、alt="" は飾りの画像と書き手が明示したものとして数えません（markdownlint の MD045 と同じ）。
+  en: When an image does not load, or a screen reader reads the page, the alt text is all that stands in for it. With an empty one ("![](chart.png)") the reader cannot tell what was there. An HTML <img> is reported only when it has no alt attribute; alt="" says the image is decoration and is not counted (as markdownlint's MD045).
+
+message:
+  ja: 画像「{image}」に代替テキストがありません
+  en: 'Image "{image}" has no alt text'
+
+how_to_fix:
+  ja: 画像が伝えることを一言で書いてください（![4月の売上の推移](図1.png)）。飾りの画像なら、HTML で alt="" と書くと読み上げが飛ばします。
+  en: Write what the image shows in a few words ("![Sales by month, April](chart.png)"). If it is decoration, write alt="" in HTML so screen readers skip it.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 「![](図.png)」のように、代替テキストの無い画像
+  en: An image with no alt text, as in "![](chart.png)"
+example:
+  ja:
+    before: |
+      四月から六月の売上です。
+
+      ![](sales.png)
+    after: |
+      四月から六月の売上です。
+
+      ![四月から六月の売上の推移](sales.png)
+  en:
+    before: |
+      Sales from April to June.
+
+      ![](sales.png)
+    after: |
+      Sales from April to June.
+
+      ![Sales from April to June](sales.png)
+
+not_flagged:
+  ja: HTML で alt="" と書いた画像は、飾りと明示したものとして指しません。引用（>）とコードの中の画像も見ません。
+  en: An HTML image with alt="" is marked as decoration and is not reported, nor is an image in a quotation (>) or in code.

package/rules/internal-jargon.yaml

@@ -25,3 +25,24 @@ how_to_fix:
 levels: { strict: 1, normal: 1, relaxed: 3 }
 
 use_for: [business, blog, technical, legal, docs, academic, literature, speech]
+
+group: team
+summary:
+  ja: 「横展開」「握る」のように、社内でしか通じない言葉。chaff.yaml の jargon に書いた語だけを見ます
+  en: Words that only work inside your team, from jargon in chaff.yaml
+example:
+  ja:
+    config: { jargon: [横展開] }
+    before: この取り組みを、ほかの部にも横展開します。
+    after: この取り組みを、ほかの部でも同じように始めます。
+  en:
+    config: { jargon: [ping] }
+    before: I will ping the vendor about the quote.
+    after: I will email the vendor about the quote.
+
+not_flagged:
+  ja: chaff.yaml の jargon に書いた語だけを見ます。何も書かなければ何も言いません。
+  en: Only the words under jargon in chaff.yaml are checked. With nothing listed, it says nothing.
+level_meaning:
+  ja: 当てはまる語が {limit} 箇所あれば指摘
+  en: reported once there are {limit}

package/rules/katakana-long-vowel.yaml

@@ -0,0 +1,98 @@
+id: katakana-long-vowel
+layer: L3
+status: experimental
+how_to_find: katakana-long-vowel
+# 語は形態素解析で取る。複合語の中の「ユーザー」も一語として見る。品詞が無ければ動かない。
+requires: [pos]
+# ending: keep が読む、辞書が「ー」付きで知る語の印。この rule が動くときだけ lang-ja が辞書に聞く。
+token_features: [LongVowelEnding]
+languages: [ja]
+severity: warning
+
+name:
+  ja: カタカナ語の語末の「ー」がそろっていない
+  en: The final ー of katakana words is inconsistent
+
+why:
+  ja: 「コンピューター」と「コンピュータ」のように、カタカナ語の語末の「ー」は付ける書き方と省く書き方があります。どちらも正しく、困るのは一つの文書の中で混ざることです。読み手は別のものかと迷い、検索でも片方を取りこぼします。設定が無ければ、同じ語が両方で書かれた所だけを指摘し、違う語どうし（サーバーとブラウザ）は比べません。options の ending を drop か keep にすると、決めた書き方に合わない語をすべて指摘します。音は「コ・ン・ピュ・ー・タ・ー」で 6 音と数えます（小さい「ャュョァィゥェォ」は前の字と合わせて 1 音、「ッ」「ン」「ー」は 1 音ずつ）。辞書が固有名詞と知っている語（ディズニー）と、chaff.yaml の names に並べた名前は見ません。
+  en: A katakana loanword can be written with or without its final long-vowel mark (コンピューター / コンピュータ). Both are right; what reads badly is mixing them in one document, which makes a reader wonder whether they differ and makes a search miss one. With no setting chaff points only at a word written both ways, and does not compare different words (サーバー and ブラウザ). Setting ending under options to drop or keep points at every word written the other way. Morae are counted as コ・ン・ピュ・ー・タ・ー, six (a small ャュョァィゥェォ joins the kana before it; ッ, ン and ー are one each). Words the dictionary knows as proper nouns (ディズニー) and the names under names in chaff.yaml are left alone.
+
+message:
+  ja: 「{matched}」は語末の「ー」がほかと違います（「{preferred}」）
+  en: 'The final ー of "{matched}" differs from the rest ("{preferred}")'
+
+messages:
+  same-word:
+    ja: 「{matched}」と「{preferred}」が混ざっています（この語は {of} 回のうち {count} 回が「{matched}」）
+    en: '"{matched}" and "{preferred}" are both used ({count} of {of} are "{matched}")'
+  drop:
+    ja: 「{matched}」は語末の「ー」を省いて「{preferred}」と書きます（{min_morae} 音以上の語）
+    en: 'Write "{preferred}", without the final ー ({min_morae} morae or more)'
+  keep:
+    ja: 「{matched}」は語末の「ー」を付けて「{preferred}」と書きます
+    en: 'Write "{preferred}", with the final ー'
+
+how_to_fix:
+  ja: 「{preferred}」に直してください。どちらに寄せるかチームで決めているなら、chaff.yaml の options で ending を決めておくと、この文書の多いほうではなく、決めた書き方で見ます。製品名など、そのままにすべき語は options の except か names に並べます。
+  en: Change it to "{preferred}". If the team has decided which way, set ending under options in chaff.yaml, and chaff checks against that instead of the document's usual way. List a word that must stay as it is (a product's name) under except in options, or under names.
+
+placeholders:
+  matched:
+    ja: 見つけた語
+    en: the word found
+  preferred:
+    ja: 直した書き方
+    en: the other way of writing it
+
+# 何語違えば指摘するか。1 は「1 語でも違えば」。
+levels: { strict: 1, normal: 1, relaxed: 3 }
+
+options:
+  ending:
+    kind: choice
+    default: consistent
+    about:
+      ja: 語末の「ー」をどちらに寄せるか
+      en: Which way the final ー goes
+    choices:
+      consistent:
+        ja: 決めない。文書の中でそろっているかだけを見る
+        en: No side taken; only checks that the document is consistent
+      drop:
+        ja: min_morae 音以上の語の語末の「ー」を省く（電子情報通信学会、JIS Z 8301:2011 まで）
+        en: Drop the final ー on words of min_morae morae or more (IEICE; JIS Z 8301 up to 2011)
+      keep:
+        ja: 語末の「ー」を付ける（文化庁「外来語の表記」、JIS Z 8301:2019）。「ー」の無い語は、辞書が「ー」付きで知っている語（メモリ）か、文書がほかで「ー」付きで書く語だけを見る
+        en: Keep the final ー (the Agency for Cultural Affairs' 外来語の表記; JIS Z 8301:2019). A word without one is checked only when the dictionary knows it with one (メモリ) or the document writes it with one elsewhere
+  min_morae:
+    kind: count
+    default: 3
+    about:
+      ja: 何音以上の語を見るか。語末の「ー」も 1 音と数える（コンピューターは 6 音、カーは 2 音）
+      en: The shortest word checked, in morae, counting the final ー (コンピューター is six, カー two)
+  except:
+    kind: words
+    default: []
+    about:
+      ja: 見ない語。どちらの書き方で並べても、両方の書き方が外れる
+      en: Words left alone; listing either way of writing one exempts both
+
+use_for: [business, blog, technical, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: カタカナ語の語末の「ー」を、同じ語で付けたり省いたりしている所（コンピューターとコンピュータ）。options で省く・付けるを決めることもできます
+  en: A katakana word written both with and without its final ー in one document (コンピューター and コンピュータ); options can set which way
+example:
+  ja:
+    before: |
+      新しいコンピューターを買いました。古いコンピュータは来月捨てます。
+    after: |
+      新しいコンピューターを買いました。古いコンピューターは来月捨てます。
+
+not_flagged:
+  ja: 違う語どうし（サーバーとブラウザ）は比べません。2 音の語（カー）、辞書が固有名詞と知っている語、chaff.yaml の names に並べた名前も見ません。
+  en: Different words (サーバー and ブラウザ) are not compared. Two-mora words (カー), words the dictionary knows as proper nouns and the names under names in chaff.yaml are left alone.
+level_meaning:
+  ja: 違う書き方の語が {limit} 箇所あれば指摘
+  en: reported once {limit} words go the other way

package/rules/kutoten-consistency.yaml

@@ -0,0 +1,53 @@
+id: kutoten-consistency
+layer: L3
+status: experimental
+how_to_find: kutoten-consistency
+languages: [ja]
+severity: warning
+
+name:
+  ja: 句読点の書き方がそろっていない
+  en: Japanese commas and periods are mixed
+
+why:
+  ja: 読点を「、」と「，」、句点を「。」と「．」のどちらで書くかは、どちらでも読めます（横書きの論文や公用文には「，」があります）。困るのは一つの文書の中で混ざることで、貼り付けた文や別の人が書いた段落が、そこだけ違って見えます。chaff はどちらが正しいかを決めず、読点と句点のそれぞれで、文書の中で少ないほうを指摘します。数の中の「，」「．」（１，０００、３．５）、番号の印の点（１．はじめに、２．確認）、一、二文字の英字の印の後ろの点（Ｑ．）、鉤括弧で引いたものの中と、注の番号で始まる行や URL を含む文（文献や出典の書き方に従う）は数えません。
+  en: Whether Japanese text uses 、 or ， for its commas and 。 or ． for its periods is a choice either way (， is common in horizontal academic and official writing). What reads badly is mixing both in one document, which makes a pasted sentence or another writer's paragraph stand out. chaff does not decide which is right; for commas and for periods separately, it points at whichever the document uses less. Marks inside a number (１，０００, ３．５), after a list number (１．はじめに, ２．確認), after a one- or two-letter label (Ｑ．), inside a 「」 quotation, and in a sentence that starts with a note number or holds a URL (a citation follows its own style) are not counted.
+
+message:
+  ja: 「{mark}」と書いています（この文書はふつう「{usual}」。{of} 箇所のうち {count} 箇所が違う）
+  en: '"{mark}" here, where the document usually writes "{usual}" ({count} of {of})'
+
+messages:
+  comma:
+    ja: 読点を「{mark}」と書いています（この文書はふつう「{usual}」。{of} 箇所のうち {count} 箇所が違う）
+    en: 'The Japanese comma is written "{mark}" here, where the document usually writes "{usual}" ({count} of {of})'
+  period:
+    ja: 句点を「{mark}」と書いています（この文書はふつう「{usual}」。{of} 箇所のうち {count} 箇所が違う）
+    en: 'The Japanese period is written "{mark}" here, where the document usually writes "{usual}" ({count} of {of})'
+
+how_to_fix:
+  ja: 文書の多いほうの書き方に合わせてください。チームで決めているなら、STYLE.md に書いておくと迷いません。
+  en: Match the way the rest of the document does it. If the team has decided, write it in the style guide.
+
+# 何箇所違えば指摘するか。1 は「1 箇所でも混ざっていれば」。
+levels: { strict: 1, normal: 1, relaxed: 3 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 読点の「、」と「，」、句点の「。」と「．」が、一つの文書の中で混ざっている所
+  en: Japanese commas written both 、 and ，, or periods written both 。 and ．, in one document
+example:
+  ja:
+    before: |
+      申込書は、窓口で受け付けます。書類は，担当者が確認します。結果は、翌日に知らせます。
+    after: |
+      申込書は、窓口で受け付けます。書類は、担当者が確認します。結果は、翌日に知らせます。
+
+not_flagged:
+  ja: 数の中の「，」「．」（１，０００、３．５）、番号の印の点（１．）、「Ｑ．」のような英字の印、「」の中、注の番号で始まる行と URL を含む文は数えません。どちらの書き方が正しいかは決めません。
+  en: Marks inside numbers (１，０００, ３．５), after a list number (１．), in a letter label (Ｑ．), inside 「」, and in a note or a sentence with a URL are not counted. Neither way is called right.
+level_meaning:
+  ja: 少ないほうの書き方が {limit} 箇所あれば指摘
+  en: reported once {limit} places go against the document's habit

package/rules/latin-spacing.yaml

@@ -7,16 +7,17 @@ severity: warning
 # 番号・識別子として書かれた数を見分けるのに、数の後ろの語の品詞を使う。無ければ全部数える。
 uses: [pos]
 # 番地（千代田区紀尾井町1-3）を、都道府県までの地名の後ろの範囲（東京都2-3 営業日）と分ける。
-# 日付・時刻（9月、2026年、10時5分）を、長さ（3ヶ月、3 時間）と分ける。
-extra_word_lists: [prefecture-unit, date-time-unit, calendar-unit, calendar-year-unit]
+# 日付・時刻（9月、2026年、令和8年、10時5分）を、長さ（3ヶ月、3 時間）と分ける。
+# 番号と組んで名前を付ける語（問3、第1節）を見分ける。
+extra_word_lists: [prefecture-unit, date-time-unit, calendar-unit, calendar-year-unit, calendar-era, numbered-label]
 
 name:
   ja: 英数字の前後の空白がそろっていない
   en: Spacing around Latin text is inconsistent
 
 why:
-  ja: 日本語と英字・数字のあいだを空けるか詰めるかは、どちらでも読めます。困るのは一つの文書の中で混ざることで、読み手には違いに意味があるように見えます。chaff はどちらが正しいかを決めず、文書の中で少ないほうを指摘します。英字と、数字の前、数字の後ろは別々に数えます。「を 3回」のように、数字の前は空けて助数詞とは詰める書き方がふつうにあるからです。「3GBの」のように数字に続く単位は、英字ではなく数字の側として数えます。逆に「H30 等」「EC2 で」「Phase 1 は」のように英字で始まって数字で終わる名前は、英字の側として数えます。「073-489-5909」「2026-06-02」のような番号は数量ではないので数えません。日付・時刻（「9月」「2026年」「10月1日」「3時」「10時5分」）も、数と単位を詰めて書く決まりなので、その中の境目は数えません（日付の前の空白は数えます）。長さ（「3ヶ月」「3 時間」「5日で」「3年」）は数量として数えます。題や注の番号として書かれた数（「3.1 リサーチの原則」の節番号、※1 の注番号、行の頭に続き番号で並べた注の番号）、0 で始まる組を含む番号（102-0094）、〒の後ろの郵便番号（〒100-8916）、市・区・町まで下りた地名のすぐ後ろの番地（千代田区紀尾井町1-3）も、後ろの空白が番号と題・項目の区切りなので数えません。鉤括弧（「」『』）で引いた題名や発言の中も、空け方は引いた元のものなので数えません。
-  en: Whether to put a space between Japanese and Latin letters or digits is a choice either way. What reads badly is mixing both in one document, which suggests the difference means something. chaff does not decide which is right; it points at whichever the document uses less. Letters, the space before a digit and the space after one are counted separately, since spacing before a number but not before its counter is common. A unit after a number (3GB) counts with the number; a name that starts with a letter and ends in a digit (H30, EC2, Phase 1) counts with the letters. A code such as a phone number or a date (073-489-5909, 2026-06-02) is not a quantity and is not counted. Nor is the inside of a date or a time written with units (9月, 2026年, 10月1日, 3時, 10時5分), which is packed by convention; the space before it still counts. A length of time (3ヶ月, 3 時間, 5日で, 3年) is a quantity and counts. Neither is a number written as the label of a title or a note (a section number such as 3.1 before its title, a note number after ※, the numbers of notes listed one per line in sequence), a code with a part starting with 0 (102-0094), a postal code after 〒 (〒100-8916), or a hyphenated address number right after a city, ward or town (千代田区紀尾井町1-3), since the space after it separates the label from its title or the next item. Nor is the spacing inside a title or a quotation in 「」 or 『』, which is the source's, not the writer's.
+  ja: 日本語と英字・数字のあいだを空けるか詰めるかは、どちらでも読めます。困るのは一つの文書の中で混ざることで、読み手には違いに意味があるように見えます。chaff はどちらが正しいかを決めず、文書の中で少ないほうを指摘します。英字と、数字の前、数字の後ろは別々に数えます。「を 3回」のように、数字の前は空けて助数詞とは詰める書き方がふつうにあるからです。「3GBの」のように数字に続く単位は、英字ではなく数字の側として数えます。逆に「H30 等」「EC2 で」「Phase 1 は」のように英字で始まって数字で終わる名前は、英字の側として数えます。「073-489-5909」「2026-06-02」のような番号は数量ではないので数えません。日付・時刻（「9月」「2026年」「令和8年」「10月1日」「3時」「10時5分」）も、数と単位を詰めて書く決まりなので、その中の境目も、前の境目（「は 9月」「午後3時」）も数えません。長さ（「3ヶ月」「3 時間」「5日で」「3年」）は数量として数えます。題や注の番号として書かれた数（「3.1 リサーチの原則」の節番号、※1 の注番号、行の頭に続き番号で並べた注の番号、番号が増えていく箇条書きの頭の番号、「問3」「図2」のように語のすぐ後ろに書いた番号）、0 で始まる組を含む番号（102-0094）、〒の後ろの郵便番号（〒100-8916）、市・区・町まで下りた地名のすぐ後ろの番地（千代田区紀尾井町1-3）も、後ろの空白が番号と題・項目の区切りなので数えません。「第1節 AI の…」の「第1節」の後ろの空白も同じです。鉤括弧（「」『』）で引いた題名や発言の中も、空け方は引いた元のものなので数えません。
+  en: Whether to put a space between Japanese and Latin letters or digits is a choice either way. What reads badly is mixing both in one document, which suggests the difference means something. chaff does not decide which is right; it points at whichever the document uses less. Letters, the space before a digit and the space after one are counted separately, since spacing before a number but not before its counter is common. A unit after a number (3GB) counts with the number; a name that starts with a letter and ends in a digit (H30, EC2, Phase 1) counts with the letters. A code such as a phone number or a date (073-489-5909, 2026-06-02) is not a quantity and is not counted. Nor is a date or a time written with units (9月, 2026年, 令和8年, 10月1日, 3時, 10時5分), which is packed by convention; neither its inside nor the space before it (は 9月, 午後3時) counts. A length of time (3ヶ月, 3 時間, 5日で, 3年) is a quantity and counts. Neither is a number written as the label of a title or a note (a section number such as 3.1 before its title, a note number after ※, the numbers of notes listed one per line in sequence, numbers opening the items of a list that go up, a number written right after a word such as 問 or 図), a code with a part starting with 0 (102-0094), a postal code after 〒 (〒100-8916), or a hyphenated address number right after a city, ward or town (千代田区紀尾井町1-3), since the space after it separates the label from its title or the next item. The same goes for the space after a division such as 第1節. Nor is the spacing inside a title or a quotation in 「」 or 『』, which is the source's, not the writer's.
 
 message:
   ja: "日本語と{kind}のあいだを{style}（この文書はふつう{usual}。{of} 箇所のうち {count} 箇所が違う）"
@@ -30,3 +31,21 @@ how_to_fix:
 levels: { strict: 1, normal: 1, relaxed: 3 }
 
 use_for: [business, blog, technical, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 日本語と英数字のあいだの空白が、文書の中で付いたり付かなかったりしている所
+  en: Spacing between Japanese and Latin letters or digits that is done both ways in one document
+example:
+  ja:
+    before: |
+      表は Excel で作り、Word に貼ります。図は PowerPoint で描きます。最後にPDFにします。
+    after: |
+      表は Excel で作り、Word に貼ります。図は PowerPoint で描きます。最後に PDF にします。
+
+not_flagged:
+  ja: 電話番号や日付のような番号、単位つきの日付や時刻（9月、10時5分）、見出しの番号、「」の中は数えません。どちらの空け方が正しいかは決めません。
+  en: Codes such as phone numbers and dates, dates and times with units (9月, 10時5分), heading numbers and quotations are not counted. Neither way is called right.
+level_meaning:
+  ja: 少ないほうの空け方が {limit} 箇所あれば指摘
+  en: reported once {limit} places go against the document's habit

package/rules/max-kanji-continuous.yaml

@@ -29,3 +29,19 @@ how_to_fix:
 levels: { strict: 6, normal: 8, relaxed: 12 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 「新規顧客獲得施策検討会議」のように、漢字だけが長く続く所
+  en: A long run of kanji with no kana between them, which Japanese readers have to take apart
+example:
+  ja:
+    before: 来週、新規顧客獲得施策検討会議を開きます。
+    after: 来週、新しい顧客を増やす施策を話し合う会議を開きます。
+
+not_flagged:
+  ja: chaff.yaml の names に書いた組織名や製品名、法令の条番号（第二十二条第二項）は数えません。
+  en: Names listed under names in chaff.yaml, and provision numbers in statutes (第二十二条第二項), are not counted.
+level_meaning:
+  ja: 漢字の連続 {limit} 字まで
+  en: up to {limit} kanji in a row