chaffjs 0.18.0 → 0.20.0

package/rules/empty-list-item.yaml

@@ -0,0 +1,85 @@
+id: empty-list-item
+layer: L1
+status: experimental
+how_to_find: empty-list-item
+requires: [markdown]
+severity: warning
+
+name:
+  ja: 中身の無い箇条書きの項目
+  en: Empty list item
+
+why:
+  ja: 「担当：」のように見出しの語だけを書いて値の無い項目や、記号だけの項目です。同じ箇条書きのほかの項目には値が書いてあるので、書き忘れか、まだ決まっていないことが読み手には分かりません。
+  en: An item holding only a label ("Owner:") while the other items of the list give theirs a value, or an item with nothing after its bullet. The reader cannot tell a gap from an undecided point.
+
+message:
+  ja: 「{name}」の後に値がありません（同じ箇条書きのほかの項目には書いてあります）
+  en: 'Nothing after "{name}" (the other items in this list give a value)'
+messages:
+  empty:
+    ja: 中身の無い箇条書きの項目です
+    en: This list item is empty
+
+how_to_fix:
+  ja: 値を書いてください。まだ決まっていないなら「未定（いつ決めるか）」と書きます。要らない項目なら消します。
+  en: Write the value. If it is not decided, write "TBD" and when it will be. If the item is not needed, remove it.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 「担当：」のように見出しの語だけで値の無い項目と、記号だけの項目
+  en: A list item holding only a label ("Owner:") where its siblings give values, or an item with nothing in it
+example:
+  ja:
+    before: |
+      - 日時：10月14日 10時
+      - 場所：第2会議室
+      - 担当：
+    after: |
+      - 日時：10月14日 10時
+      - 場所：第2会議室
+      - 担当：山田
+  en:
+    before: |
+      - Date: October 14, 10:00
+      - Room: Meeting Room 2
+      - Owner:
+    after: |
+      - Date: October 14, 10:00
+      - Room: Meeting Room 2
+      - Owner: Yamada
+
+not_flagged:
+  ja: 見出しの語だけの項目は、同じ箇条書きのほかの項目に「見出し：値」の形が一つも無ければ指しません（記入用の書式）。下に入れ子の箇条書きや段落が続く項目（「手順：」の下に手順を並べたもの）も指しません。Markdown の箇条書きでだけ動きます。
+  en: 'A label-only item is not reported when no other item in its list has a "label: value" form (a blank form to fill in). An item followed by a nested list or paragraph (a lead-in) is not reported. Markdown lists only.'
+rewrite:
+  ja:
+    direction: 空の項目に入るものを本文から探して書いてください。本文に無ければ作らず、「未定」と書いて書き手に聞きます。中身の無い記号だけの項目は消します。
+    pairs:
+      - before: "- 担当："
+        after: "- 担当：山田"
+      - before: "- 期限："
+        after: "- 期限：未定（来週の定例で決める）"
+    keep:
+      - ほかの項目の中身と並び
+      - 見出しの語
+    avoid:
+      - 本文に無い名前や日付を作って埋める
+      - 値の無い項目を黙って消す（決めるべきことが消える）
+  en:
+    direction: Find what belongs after the label in the text and write it. If the text does not say, do not invent it; write "TBD" and ask the writer. Remove an item with nothing in it.
+    pairs:
+      - before: "- Owner:"
+        after: "- Owner: Yamada"
+      - before: "- Due:"
+        after: "- Due: TBD (set at next week's meeting)"
+    keep:
+      - the other items and their order
+      - the label
+    avoid:
+      - inventing a name or date the text does not give
+      - quietly removing a label-only item, which drops a decision still to be made

package/rules/empty-section.yaml

@@ -0,0 +1,74 @@
+id: empty-section
+layer: L1
+status: experimental
+how_to_find: empty-section
+requires: [markdown]
+severity: warning
+
+name:
+  ja: 中身の無い節
+  en: Empty section
+
+why:
+  ja: 見出しのすぐ後ろに、同じ深さか浅い見出しが来ると、その節には何も書かれていません。書くつもりで見出しだけ立てたか、中身を消したときに見出しが残ったものです。目次には載るので、読み手は開いて何も無いことに気づきます。深い見出しが続く（節を小さな節に分けた）ときは中身があるので指摘しません。文書の最後の見出しも、後ろに何も無ければ指摘します。HTML のコメントだけの節は空と数えます。
+  en: A heading followed straight away by a heading of the same or a higher level has nothing under it. A heading was put up to be filled in later, or its content was deleted and the heading left behind. It still shows in the table of contents, and a reader who opens it finds nothing. A heading followed by a deeper one (a section split into subsections) has content and is not reported. The last heading of the document is reported if nothing follows it. A section holding only an HTML comment counts as empty.
+
+message:
+  ja: 見出し「{heading}」の下に中身がありません
+  en: 'Nothing under the heading "{heading}"'
+
+how_to_fix:
+  ja: 節の中身を書くか、見出しを消してください。
+  en: Write the section, or remove the heading.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: 見出しのすぐ後ろに同じ深さか浅い見出しが来て、何も書かれていない節
+  en: A heading with nothing under it before the next heading of the same or a higher level
+example:
+  ja:
+    before: |
+      # 手順書
+
+      ## 準備
+
+      ## 作業
+
+      部品を取り付けます。
+    after: |
+      # 手順書
+
+      ## 準備
+
+      道具をそろえます。
+
+      ## 作業
+
+      部品を取り付けます。
+  en:
+    before: |
+      # Setup guide
+
+      ## Before you start
+
+      ## Steps
+
+      Fit the parts.
+    after: |
+      # Setup guide
+
+      ## Before you start
+
+      Gather the tools.
+
+      ## Steps
+
+      Fit the parts.
+
+not_flagged:
+  ja: すぐ後ろに深い見出しが来る節（小さな節に分けたもの）は指しません。Markdown の文書でだけ動きます。
+  en: A heading followed by a deeper heading (a section split into subsections) is not reported. It runs on Markdown only.

package/rules/empty-table-cell.yaml

@@ -0,0 +1,89 @@
+id: empty-table-cell
+layer: L1
+status: experimental
+how_to_find: empty-table-cell
+requires: [markdown]
+severity: warning
+
+name:
+  ja: 表の空欄
+  en: Blank table cell
+
+why:
+  ja: 表のほかの行がすべて埋めている列で、一つの行だけが空欄です。書き忘れたのか、該当しないのか、まだ決まっていないのかが読み手には分かりません。担当や期限の列なら、その行の仕事は誰もしないまま残ります。
+  en: Every other row fills this column, and one row leaves it blank. The reader cannot tell whether it was forgotten, does not apply, or is not decided yet. In an owner or due-date column, that row's task is left to no one.
+
+message:
+  ja: 表の「{name}」の列で、この行だけが空欄です
+  en: 'The "{name}" column is blank in this row only'
+
+how_to_fix:
+  ja: 中身を書いてください。該当しないなら「なし」「—」、まだ決まっていないなら「未定（いつ決めるか）」と書きます。
+  en: Fill it in. If it does not apply, write "none" or "—"; if it is not decided, write "TBD" and when it will be.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: structure
+summary:
+  ja: ほかの行がすべて埋めている列で、一つの行だけが空いている表のセル
+  en: A table cell left blank in a column every other row fills
+example:
+  ja:
+    before: |
+      | 期限 | 担当 | 内容 |
+      | --- | --- | --- |
+      | 10月16日 | 伊藤 | 修正予定を共有する |
+      | 10月21日 |  | 手順書の案を配る |
+      | 10月28日 | 高橋 | 説明会の日程を決める |
+    after: |
+      | 期限 | 担当 | 内容 |
+      | --- | --- | --- |
+      | 10月16日 | 伊藤 | 修正予定を共有する |
+      | 10月21日 | 鈴木 | 手順書の案を配る |
+      | 10月28日 | 高橋 | 説明会の日程を決める |
+  en:
+    before: |
+      | Due | Owner | Task |
+      | --- | --- | --- |
+      | Oct 16 | Ito | Share the fix plan |
+      | Oct 21 |  | Send the draft manual |
+      | Oct 28 | Takahashi | Set the briefing date |
+    after: |
+      | Due | Owner | Task |
+      | --- | --- | --- |
+      | Oct 16 | Ito | Share the fix plan |
+      | Oct 21 | Suzuki | Send the draft manual |
+      | Oct 28 | Takahashi | Set the briefing date |
+
+not_flagged:
+  ja: 一番左の列は見ません（空欄で「上と同じ」を表す書き方があるため）。同じ列に空欄が二つ以上ある列、本文の行が三つより少ない表、「—」「なし」と書いたセルは指しません。Markdown の表でだけ動きます。
+  en: The first column is not checked, since a blank there often means "same as above". A column with two or more blanks, a table with fewer than three body rows, and a cell holding "—" or "none" are not reported. Markdown tables only.
+rewrite:
+  ja:
+    direction: 空欄に入るものを本文から探して書いてください。本文に無ければ作らず、「未定」と書いて、決める人か時期を書き手に聞きます。
+    pairs:
+      - before: "| 10月21日 |  | 手順書の案を配る |"
+        after: "| 10月21日 | 鈴木 | 手順書の案を配る |"
+      - before: "| 保守 |  | 月額 |"
+        after: "| 保守 | 未定（10月末に決定） | 月額 |"
+    keep:
+      - ほかの行とセルの中身
+      - 表の列の並び
+    avoid:
+      - 本文に無い名前や数を作って埋める
+      - 空欄の行を消す
+  en:
+    direction: Find what belongs in the blank cell in the text and write it. If the text does not say, do not invent it; write "TBD" and ask the writer who decides and when.
+    pairs:
+      - before: "| Oct 21 |  | Send the draft manual |"
+        after: "| Oct 21 | Suzuki | Send the draft manual |"
+      - before: "| Support |  | Monthly |"
+        after: "| Support | TBD (decided by Oct 31) | Monthly |"
+    keep:
+      - the other rows and cells
+      - the order of the columns
+    avoid:
+      - inventing a name or figure the text does not give
+      - deleting the row with the blank

package/rules/excessive-hedging.yaml

@@ -18,7 +18,7 @@ why:
   en: The more the text avoids claiming, the less the reader can tell what was decided. One hedge is caution; many mean nobody is accountable. chaff looks two ways. A sentence that stacks hedges ("may possibly", "it could perhaps be argued") is reported on its own, even in a short document. Too many hedges across the whole document is measured only on longer documents. When counting hedges stacked in a sentence, a hedge inside a quotation is the speaker's, not the writer's, and is left out.
 
 message:
-  ja: 「{matched}」など、逃げの表現が 1000 語あたり {density} 個あります（{limit} 個まで）
+  ja: 「{matched}」など、逃げの表現が 1000 字あたり {density} 個あります（{limit} 個まで）
   en: '"{matched}" and other hedges: {density} per 1000 words (limit {limit})'
 
 # 1 つの文に重ねたもの。上の message は文書全体の密度。
@@ -31,10 +31,11 @@ how_to_fix:
   ja: 言い切れるものは言い切ってください。言い切れないなら、何が分かれば言い切れるのかを書いてください。重ねた逃げは、1 つ残すか、全部外して言い切ってください。
   en: Commit where you can. Where you cannot, say what you would need to know. Where hedges are stacked, keep one or drop them all and commit.
 
-# 文書全体の、1000 語あたりの数の上限。1 つの文に 2 つ以上重ねたものは、どの段でも指摘する。
+# 文書全体の、1000 語（日本語は 1000 字）あたりの数の上限。1 つの文に 2 つ以上重ねたものは、どの段でも指摘する。
 levels: { strict: 3, normal: 6, relaxed: 12 }
 
 use_for: [business, blog, technical, legal, docs, academic, literature, speech]
+sources: [femmer-2017]
 
 group: wording
 summary:
@@ -52,5 +53,32 @@ 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)
+  ja: 1000 字あたり逃げの表現 {limit} 個まで（一文に重ねた逃げは、文書の長さによらず指摘）
+  en: up to {limit} hedges per 1000 words (hedges stacked in one sentence are reported whatever the length)
+rewrite:
+  ja:
+    direction: 重ねた逃げは一つだけ残すか、確かめたことなら全部外して言い切ってください。言い切れないなら、何が分かれば言い切れるかを書きます。
+    pairs:
+      - before: 遅延の原因はキャッシュにある可能性があるかもしれません。
+        after: 遅延の原因はキャッシュかもしれません。
+      - before: この方法で改善できる場合もあると考えられるのではないでしょうか。
+        after: この方法で改善できる場合があります。
+    keep:
+      - 書き手が確かめていないことの推量
+      - 根拠の強さ
+    avoid:
+      - 確かめていないことを言い切りにする
+      - 推量を作った数字（「8 割の確率で」）に替える
+  en:
+    direction: Where hedges are stacked, keep one, or drop them all and commit if the point was checked. Where you cannot commit, say what would settle it.
+    pairs:
+      - before: The delay may possibly be caused by the cache.
+        after: The delay may be caused by the cache.
+      - before: It could perhaps be argued that this approach might help in some cases.
+        after: This approach helps in some cases.
+    keep:
+      - doubt about what the writer has not checked
+      - how strong the evidence is
+    avoid:
+      - committing to something nobody checked
+      - turning a hedge into an invented figure ("80% likely")

package/rules/fact-conflict.yaml

@@ -0,0 +1,110 @@
+id: fact-conflict
+layer: L3
+status: experimental
+how_to_find: fact-conflict
+requires: [quantities]
+uses: [pos]
+severity: warning
+
+name:
+  ja: 同じ項目に違う値が書いてある
+  en: One item given two different values
+
+why:
+  ja: 同じ節の中で「締切：10月5日」と「締切：10月7日」のように、同じ項目に違う値を書くと、読み手はどちらを信じればよいか分かりません。日程や料金を直したときに、一か所だけ直し忘れると起きます。「項目：値」「項目は値です」と書いた所と表の升を読み、同じ節で同じ項目名（全角半角、大文字小文字は揃えて比べます）に、同じ単位で違う値があれば指します。
+  en: 'When one section says "Deadline: May 3" and later "Deadline: May 5", the reader cannot tell which to trust. It happens when a date or a price is changed in one place and not in the other. Values written as "Item: value" or "The item is value", and table cells, are read; the same item name (case and width aside) with two different values in the same unit within one section is pointed out.'
+
+message:
+  ja: 「{label}」が {value} と書かれていますが、同じ節の前の所では {other} です
+  en: '"{label}" is {value} here, but {other} earlier in the same section'
+
+how_to_fix:
+  ja: どちらの値が正しいかを確かめて、もう一方を直してください。別のもの（別の回、別の対象）の値なら、項目名にそれを書き分けてください（「第2回の締切」）。
+  en: Check which value is right and correct the other. If they are values of different things (another session, another group), say so in the item name ("Second session deadline").
+
+levels: { normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: facts
+summary:
+  ja: 同じ節の中で、同じ項目（締切、料金など）に違う値を書いた所
+  en: The same item (a deadline, a fee) given two different values in one section
+example:
+  ja:
+    before: |
+      締切：10月5日
+
+      - 参加費：3,000円
+      - 締切：10月7日
+    after: |
+      締切：10月5日
+
+      - 参加費：3,000円
+      - 締切：10月5日
+  en:
+    before: |
+      Deadline: May 3, 2026
+
+      - Fee: $300
+      - Deadline: May 5, 2026
+    after: |
+      Deadline: May 3, 2026
+
+      - Fee: $300
+      - Deadline: May 3, 2026
+
+not_flagged:
+  ja: 違う見出しの下、違う親の項目の下、太字だけの行や「第2回：」のような行の後ろの値は、別のものの値として比べません。値の後ろに条件が続くもの（「3,000円から」「10月5日に開催」）、読点のあとから始まる項目名（「大人は、参加費は」）、単位の違う値（単位の食い違いは別に見ます）も比べません。同じ項目に三通り以上の値があれば、一覧として何も言いません。
+  en: Values under different headings, under different parent list items, or after a bold-only line or a line like "Session 2:" are taken as values of different things. A value followed by a condition ("$300 per person", "May 3 at noon"), a name that starts after a comma ("For adults, the fee"), and values in different units are not compared. An item with three or more different values is read as a list and left alone.
+rewrite:
+  ja:
+    direction: 二つの値のどちらが正しいかを書き手に確かめ、もう一方を同じ値に直してください。どちらが正しいか文書から決まらないときは、推測で選ばずに書き手に聞いてください。
+    pairs:
+      - before: |
+          締切：10月5日
+          （中略）
+          締切：10月7日
+        after: |
+          締切：10月5日
+          （中略）
+          締切：10月5日
+      - before: |
+          参加費は3,000円です。
+          （中略）
+          参加費は3,500円です。
+        after: |
+          参加費は3,000円です。
+          （中略）
+          第2回の参加費は3,500円です。
+    keep:
+      - 正しいと確かめた値
+      - 項目名と単位
+    avoid:
+      - どちらが正しいかを推測で決める
+      - 片方の値を消して、項目ごと無くす
+  en:
+    direction: Ask the writer which of the two values is right and make the other match it. If the document does not settle it, ask rather than guess.
+    pairs:
+      - before: |
+          Deadline: May 3
+          (…)
+          Deadline: May 5
+        after: |
+          Deadline: May 3
+          (…)
+          Deadline: May 3
+      - before: |
+          The fee is $300.
+          (…)
+          The fee is $350.
+        after: |
+          The fee is $300.
+          (…)
+          The late fee is $350.
+    keep:
+      - the value confirmed as right
+      - the item name and the unit
+    avoid:
+      - guessing which value is right
+      - deleting one of them along with the item

package/rules/figure-reference-order.yaml

@@ -0,0 +1,109 @@
+id: figure-reference-order
+layer: L3
+status: experimental
+how_to_find: figure-order
+severity: info
+
+name:
+  ja: 図や表を参照する順番と位置
+  en: Figures and tables referred to out of order or out of place
+
+why:
+  ja: 論文の図と表は、本文で初めて参照した順に番号を振り、参照の近くに置くのが決まりです。図2を図1より先に参照していたり、図が載った節を過ぎてから初めて参照していたりすると、読み手は図と本文の間を行ったり来たりします。図を入れ替えたり節を動かしたりしたあとに起きます。三つを見ます。初めての参照が番号の順になっていない図、キャプションのある節を過ぎて見出しを越えてから初めて参照する図、同じ種類のほかの図は参照しているのに一度も参照しない図です。
+  en: In a paper, figures and tables are numbered in the order the text first refers to them, and placed near that reference. When Figure 2 is referred to before Figure 1, or a figure is first referred to only after the section it appears in, the reader goes back and forth between the figure and the text. It happens after figures are swapped or sections moved. Three things are checked. A figure whose first reference comes out of numeric order; a figure first referred to only past a heading after its caption; and a figure never referred to while others of its kind are.
+
+message:
+  ja: "{label}の参照が番号の順になっていません"
+  en: "{label} is not referred to in numeric order"
+
+messages:
+  order:
+    ja: "{label}を初めて参照するのが、{after}より後です"
+    en: "{label} is first referred to after {after}"
+  late:
+    ja: "{label}を初めて参照するのが、図や表を載せた節より後です"
+    en: "{label} is first referred to only after the section it appears in"
+  unreferenced:
+    ja: "{label}は本文で一度も参照していません"
+    en: "{label} is never referred to in the text"
+
+how_to_fix:
+  ja: 初めて参照する順に図と表の番号を振り直すか、参照の順を入れ替えてください。図は初めて参照する所の近くに置き、参照しない図は参照を足すか消してください。
+  en: Renumber the figures and tables in the order they are first referred to, or reorder the references. Place each figure near its first reference, and refer to every figure or remove it.
+
+levels: { strict: warning, normal: info, relaxed: info }
+
+use_for: [academic, legal, docs, literature, speech]
+
+group: structure
+summary:
+  ja: 図2を図1より先に参照する、図を載せた節より後で初めて参照する、一度も参照しない図や表
+  en: A figure or table referred to before a lower-numbered one, first referred to only after its section, or never referred to
+example:
+  ja:
+    config: { genre: academic/paper }
+    before: |
+      # 昼寝と記憶
+
+      図2に時間ごとの再生率を示す。図1に研究の流れを示す。
+
+      図1　研究の流れ
+
+      図2　時間ごとの再生率
+    after: |
+      # 昼寝と記憶
+
+      図1に研究の流れを示す。図2に時間ごとの再生率を示す。
+
+      図1　研究の流れ
+
+      図2　時間ごとの再生率
+  en:
+    config: { genre: academic/paper }
+    before: |
+      # Naps and memory
+
+      Figure 2 shows recall by hour. Figure 1 shows the study design.
+
+      Figure 1: Study design
+
+      Figure 2: Recall by hour
+    after: |
+      # Naps and memory
+
+      Figure 1 shows the study design. Figure 2 shows recall by hour.
+
+      Figure 1: Study design
+
+      Figure 2: Recall by hour
+
+not_flagged:
+  ja: キャプション（行の頭の「図1　…」）を一つも書いていない種類の図、他の文書の図（「報告書の図5」）、リンクの字、番号が字や漢数字のもの（付録A、別表第一）は見ません。付録・別表・様式は文書の終わりに置くものなので、参照の順だけを見て、置き場所と参照の有無は見ません。見出しの無い文書では、節を越えたかどうかは見ません。論文のジャンルでだけ見ます。
+  en: 'A kind of figure the document never captions (a "Figure 1: …" line), figures of another document ("Figure 5 of the report"), link text, and numbers that are letters or numerals in words (Appendix A) are left alone. Appendices and annexes sit at the end, so only the order of their references is checked, not where they are or whether they are referred to. A document without headings is not checked for references past the section. Only the academic paper genre runs this rule.'
+rewrite:
+  ja:
+    direction: 初めて参照する順に番号が増えるよう、参照の順を入れ替えるか、図と表の番号を振り直してください。振り直すなら、キャプションとほかの参照も同じく直します。参照しない図には、本文に参照の文を足します。
+    pairs:
+      - before: 図2に時間ごとの再生率を示す。図1に研究の流れを示す。
+        after: 図1に研究の流れを示す。図2に時間ごとの再生率を示す。
+      - before: 結果を表2と表1にまとめた。
+        after: 結果を表1と表2にまとめた。
+    keep:
+      - 図と表の中身とキャプション
+      - 本文の主張
+    avoid:
+      - キャプションの番号だけを変えて本文の参照を残す
+      - 図の中身に無いことを参照の文に書く
+  en:
+    direction: Reorder the references, or renumber the figures and tables, so the numbers rise in the order of first reference. When renumbering, change the captions and every other reference to match. For a figure never referred to, add a sentence that refers to it.
+    pairs:
+      - before: Figure 2 shows recall by hour. Figure 1 shows the study design.
+        after: Figure 1 shows the study design. Figure 2 shows recall by hour.
+      - before: Table 2 and Table 1 summarise the results.
+        after: Table 1 and Table 2 summarise the results.
+    keep:
+      - what each figure and table shows, and its caption
+      - the claims of the text
+    avoid:
+      - changing a caption's number and leaving the references as they were
+      - describing in the reference what the figure does not show

package/rules/fullwidth-alnum-consistency.yaml

@@ -0,0 +1,53 @@
+id: fullwidth-alnum-consistency
+layer: L3
+status: experimental
+how_to_find: fullwidth-alnum
+languages: [ja]
+severity: warning
+
+name:
+  ja: 英数字の全角と半角が混ざっている
+  en: Full-width and half-width letters and digits are mixed
+
+why:
+  ja: 英字と数字を全角（ＡＢＣ１２３）で書くか半角（ABC123）で書くかは、どちらでも読めます。困るのは一つの文書の中で混ざることで、検索で別の語になり、貼り付けた文がそこだけ違って見えます。chaff はどちらが正しいかを決めず、英字一字・英字の語・数字一字・数字の並びの組ごとに、文書の中で少ないほうを指摘します（「１桁は全角、２桁以上は半角」と決めている文書は組の中でそろっています）。少ないほうが組の三分の一を超える文書は、使い分けている（数え方の語だけ全角にする、など）と見て言いません。鉤括弧で引いたもの、項目と注の番号（「１．」「（１）」「※１」）、箇条書きの頭の番号、注の番号で始まる行と URL を含む文、日本語の中の英文は数えません。
+  en: Whether Japanese text writes letters and digits full-width (ＡＢＣ１２３) or half-width (ABC123) is a choice either way. What reads badly is mixing both in one document, which makes search treat them as different words and makes a pasted sentence stand out. chaff does not decide which is right; for single letters, words, single digits and longer numbers separately, it points at whichever the document uses less (a document that writes one-digit numbers full-width and longer ones half-width is consistent within each group). It says nothing when the minority is more than a third of its group, since the document then uses the two on purpose (full-width only for counters, for example). Quotations in brackets, item and note numbers (１．, （１）, ※１), a number at the head of a list item, a sentence that starts with a note number or holds a URL, and English sentences inside Japanese text are not counted.
+
+message:
+  ja: 「{written}」と書いています（ほかは「{other}」の書き方。{of} 箇所のうち {count} 箇所が違う）
+  en: '"{written}" here, where the document usually writes "{other}" ({count} of {of})'
+
+messages:
+  fullwidth:
+    ja: 全角の「{written}」と書いています（この文書はふつう半角の「{other}」。{of} 箇所のうち {count} 箇所が違う）
+    en: 'Full-width "{written}" here, where the document usually writes half-width "{other}" ({count} of {of})'
+  halfwidth:
+    ja: 半角の「{written}」と書いています（この文書はふつう全角の「{other}」。{of} 箇所のうち {count} 箇所が違う）
+    en: 'Half-width "{written}" here, where the document usually writes full-width "{other}" ({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.
+
+# 少ないほうが組の何パーセントまでなら「混ざっている」と見るか。これを超えたら、文書が使い分けている。
+levels: { strict: 49, normal: 34, relaxed: 20 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 英字や数字を、全角（ＡＢＣ１２３）と半角（ABC123）で混ぜて書いている所
+  en: Letters and digits written both full-width (ＡＢＣ１２３) and half-width (ABC123) in one Japanese document
+example:
+  ja:
+    before: |
+      申込は2024年4月10日までです。説明会は2024年4月3日と２０２４年４月５日に開きます。
+    after: |
+      申込は2024年4月10日までです。説明会は2024年4月3日と2024年4月5日に開きます。
+
+not_flagged:
+  ja: 鉤括弧で引いたもの、項目と注の番号（「１．」「（１）」「※１」）、箇条書きの頭の番号、版の番号の続き（TLS1.2 の 2）、注や URL を含む文は数えません。英字一字・英字の語・数字一字・数字の並びは別々に比べるので、「１桁は全角、２桁以上は半角」はそろっていると見ます。どちらの書き方が正しいかは決めません。
+  en: Quotations in brackets, item and note numbers (１．, （１）, ※１), a number at the head of a list item, the rest of a version number (the 2 of TLS1.2), and notes or sentences with a URL are not counted. Single letters, words, single digits and longer numbers are compared separately, so "one digit full-width, more digits half-width" counts as consistent. Neither way is called right.
+level_meaning:
+  ja: 少ないほうが組の {limit}% 以下のとき指摘
+  en: reported when the minority form is {limit}% of its group or less

package/rules/hankaku-kana.yaml

@@ -0,0 +1,41 @@
+id: hankaku-kana
+layer: L1
+status: experimental
+how_to_find: hankaku-kana
+languages: [ja]
+severity: warning
+
+name:
+  ja: 半角の片仮名がある
+  en: Half-width katakana
+
+why:
+  ja: 「ｱｲｳ」のような半角の片仮名は、古い機械やシステムから貼り付けたときに残る書き方です。全角の「アイウ」と同じ語でも検索で別の語になり、読み上げや字幅もそろいません。半角の句読点・鉤括弧・中黒（｡｢｣､･）も同じです。コードとリンクの中、鉤括弧や引用符で引いた名前（画面に出る表示をそのまま引いたもの）は数えません。
+  en: Half-width katakana such as "ｱｲｳ" is left over from text pasted out of an old system. It is the same word as the full-width "アイウ" but a search treats it as a different one, and a screen reader and the character widths do not match. Half-width Japanese punctuation, brackets and the middle dot (｡｢｣､･) are the same. Code, link text and a name quoted in brackets or quotation marks (a label copied from a screen) are not counted.
+
+message:
+  ja: 半角の片仮名「{kana}」があります（全角は「{fullwidth}」）
+  en: 'Half-width katakana "{kana}" (full-width: "{fullwidth}")'
+
+how_to_fix:
+  ja: 全角の片仮名に直してください。システムの表示をそのまま引くなら、鉤括弧で囲んでください。
+  en: Write it in full-width katakana. If it quotes a system's display as it is, put it in brackets.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: slips
+summary:
+  ja: 「ｱｲｳ」のような半角の片仮名と、半角の句読点・鉤括弧・中黒
+  en: Half-width katakana such as "ｱｲｳ", and half-width Japanese punctuation
+example:
+  ja:
+    before: |
+      申込書はﾒｰﾙで送ってください。
+    after: |
+      申込書はメールで送ってください。
+
+not_flagged:
+  ja: コードとリンクの中、鉤括弧や引用符で引いた名前（「ｶﾅ表示」のような画面の表示）は数えません。
+  en: Code, link text and a name quoted in brackets or quotation marks (a screen label such as 「ｶﾅ表示」) are not counted.