chaffjs 0.17.0 → 0.19.0

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.

package/rules/heading-echo.yaml

@@ -29,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: stable
+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/invisible-character.yaml

@@ -0,0 +1,63 @@
+id: invisible-character
+layer: L1
+status: experimental
+how_to_find: invisible-character
+severity: warning
+
+name:
+  ja: 見えない字がある
+  en: Invisible character
+
+why:
+  ja: ゼロ幅の空白、途中に残った BOM、任意の改行位置の印（ソフトハイフン）、文字の向きの指定、制御文字は、画面では見えないまま本文に残ります。Web ページや PDF から貼り付けると入り、検索に当たらない語、押しても開かない URL、動かないコマンドの原因になります。向きの指定や、字の後ろに隠したタグ文字は、読み手に見える文と機械が読む文を食い違わせることにも使えるので、安全のための目印でもあります。見出しや箇条の印の後ろのノーブレークスペースは印を印でなくし、日本語の隣のノーブレークスペースは貼り付けの名残です。コードの中も数えます（コピーしたコマンドが動かなくなるため）。絵文字をつなぐ接合子、アラビア文字やインドの文字の接合子、右から左に書く文字の隣の向きの印と分離の印、地域の旗のタグ文字、字に一つ付いた異体字の指定は書き方の一部なので数えません。向きを強制する印（LRO・RLO）は、どこにあっても指摘します。
+  en: A zero-width space, a byte order mark left mid-text, a soft hyphen, a direction mark and a control character stay in the text without showing on screen. They come in with text pasted from a web page or a PDF, and make a word that search does not find, a URL that does not open and a command that does not run. Direction marks and tag characters hidden after a letter can also make what a reader sees differ from what a machine reads, so they are a safety signal too. A no-break space after a heading or list marker stops the marker from working, and one next to Japanese text is left over from a paste. Code is checked too, since a copied command stops working. A joiner inside an emoji or in Arabic or Indic script, a direction mark or isolate next to right-to-left text, the tag characters of a regional flag and a single variation selector after a character are part of the writing and are not counted. A direction override (LRO, RLO) is always reported.
+
+message:
+  ja: 見えない字（{code}）があります
+  en: "Invisible character ({code})"
+
+messages:
+  zero-width:
+    ja: ゼロ幅の字（{code}）が {count} 字あります。検索やコピーで語が切れます
+    en: "{count} zero-width {count|character|characters} ({code}): search and copy break the word here"
+  soft-hyphen:
+    ja: 見えないソフトハイフン（{code}）が {count} 字あります。検索で語が切れます
+    en: "{count} soft {count|hyphen|hyphens} ({code}): search breaks the word here"
+  direction:
+    ja: 文字の向きの指定（{code}）が {count} 字あります。見える順と読まれる順が食い違うことがあります
+    en: "{count} direction {count|mark|marks} ({code}): the order a reader sees can differ from the order a machine reads"
+  control:
+    ja: 制御文字（{code}）が {count} 字あります
+    en: "{count} control {count|character|characters} ({code})"
+  hidden:
+    ja: 字の後ろに隠れた印（{code}）が {count} 字あります。読み手に見えない文を運べます
+    en: "{count} hidden {count|tag|tags} ({code}) after a character: they can carry text a reader cannot see"
+  nbsp:
+    ja: 普通の空白の所にノーブレークスペース（{code}）があります
+    en: "A no-break space ({code}) where an ordinary space belongs"
+
+how_to_fix:
+  ja: 見えない字を消してください。ノーブレークスペースは普通の空白にしてください。エディタの「不可視文字を表示」で場所が見えます。
+  en: Delete the invisible character, and replace a no-break space with an ordinary space. An editor's "show invisibles" setting shows where they are.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: slips
+summary:
+  ja: ゼロ幅の空白、途中の BOM、ソフトハイフン、文字の向きの指定、制御文字、隠れたタグ文字のような、画面に出ない字
+  en: Characters that do not show on screen, such as a zero-width space, a stray byte order mark, a soft hyphen, a direction mark or hidden tag characters
+example:
+  ja:
+    before: "申込書は\u200B総務課へ送ってください。\n"
+    after: |
+      申込書は総務課へ送ってください。
+  en:
+    before: "Send the form to the\u200B office.\n"
+    after: |
+      Send the form to the office.
+
+not_flagged:
+  ja: 絵文字をつなぐ接合子、アラビア文字やインドの文字の接合子、右から左に書く文字の隣の向きの印、地域の旗のタグ文字、字に一つ付いた異体字の指定、ファイルの頭の BOM、英文の語と語のあいだのノーブレークスペースは指しません。
+  en: A joiner inside an emoji or in Arabic or Indic script, a direction mark next to right-to-left text, the tag characters of a regional flag, a single variation selector after a character, a byte order mark at the start of the file and a no-break space between English words are not reported.

package/rules/katakana-long-vowel.yaml

@@ -0,0 +1,99 @@
+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 にすると、決めた書き方に合わない語をすべて指摘します。音は語末の「ー」を除いて「コ・ン・ピュ・ー・タ」で 5 音と数えます（小さい「ャュョァィゥェォ」は前の字と合わせて 1 音、「ッ」「ン」と語中の「ー」は 1 音ずつ。JIS Z 8301:2011 表 G.3 の数え方）。辞書が固有名詞と知っている語（ディズニー）と、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 before the final ー, as コ・ン・ピュ・ー・タ, five (a small ャュョァィゥェォ joins the kana before it; ッ, ン and a ー inside the word are one each), as JIS Z 8301:2011 Table G.3 counts. 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 音以上の語の、英語の -er、-or、-ar に当たる語末の「ー」（ア段の字の後ろ）を省く（電子情報通信学会、JIS Z 8301:2011 まで）
+        en: Drop the final ー that stands for English -er, -or, -ar (after a kana of the ア row) 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: 2
+    about:
+      ja: 何音以上の語を見るか。語末の「ー」は数えない（コンピューターは 5 音、カバーは 2 音、カーは 1 音）
+      en: The shortest word checked, in morae before the final ー (コンピューター is five, カバー two, カー one)
+  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]
+sources: [koyobun-2022, gairaigo-1991, jis-z8301-2019, jtf-style-guide]
+
+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: 違う語どうし（サーバーとブラウザ）は比べません。「ー」の前が 1 音の語（カー）、辞書が固有名詞と知っている語、chaff.yaml の names に並べた名前も見ません。「ー」を付けると別の語になる語（知ってるフリ／フリー、タブ／タブー、ベタ／ベター）は、語彙表 long-vowel-distinct に並べたものを同じ語として比べず、keep でも「ー」を足させません。drop は ュー・エー・イーなどで終わる語（メニュー、グレー、コピー）を見ません。
+  en: Different words (サーバー and ブラウザ) are not compared. Words of one mora before the final ー (カー), words the dictionary knows as proper nouns and the names under names in chaff.yaml are left alone. A word that becomes another word with a final ー (フリ and フリー, タブ (tab) and タブー (taboo), ベタ and ベター) is not compared, nor asked for a ー by keep, when it is in the long-vowel-distinct word list. drop leaves words ending in ュー, エー, イー and the like 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,21 +7,28 @@ 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, item-number]
 
 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」のような番号や、「1.0.0」のような版番号は数量ではないので数えません。日付・時刻（「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, a date or a version (073-489-5909, 2026-06-02, 1.0.0) 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 『』, or inside the text of a link, which is the source's, not the writer's.
 
 message:
   ja: "日本語と{kind}のあいだを{style}（この文書はふつう{usual}。{of} 箇所のうち {count} 箇所が違う）"
   en: "Spacing between Japanese and {kind} differs here ({count} of {of})"
 
+# 少ないほうが 5 箇所以上で、全体の 2 割を超えるとき。書き損じではなく書き方が二通りあるので、1 件にまとめて両方の数を言う。
+messages:
+  mixed:
+    ja: "日本語と{kind}のあいだを、空ける所が {spaced} 箇所、詰める所が {touching} 箇所あります。この文書には書き方が二通りあります"
+    en: "Spacing between Japanese and {kind} is done two ways in this document ({spaced} spaced, {touching} not)"
+
 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.
@@ -30,3 +37,22 @@ how_to_fix:
 levels: { strict: 1, normal: 1, relaxed: 3 }
 
 use_for: [business, blog, technical, legal, docs, academic, literature, speech]
+sources: [koyobun-2022, jtf-style-guide]
+
+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: 電話番号や日付のような番号、版番号（1.0.0）、単位つきの日付や時刻（9月、10時5分）、見出しの番号、行の頭の項目の番号（「一 JIS…」の一、イ）の後ろ、「」の中、リンクの文字の中は数えません。どちらの空け方が正しいかは決めません。少ないほうが全体の 2 割を超えるほど多ければ（5 箇所以上）、1 箇所ずつではなく、書き方が二通りあることを 1 件で言います。
+  en: Codes such as phone numbers, dates and version numbers (1.0.0), dates and times with units (9月, 10時5分), heading numbers, the space after an item number at the head of a line (一 JIS…), quotations and the text of links are not counted. Neither way is called right. When the less common way is more than a fifth of the places (and at least five), it is reported once, as a document written two ways, rather than place by place.
+level_meaning:
+  ja: 少ないほうの空け方が {limit} 箇所あれば指摘
+  en: reported once {limit} places go against the document's habit

package/rules/max-kanji-continuous.yaml

@@ -29,3 +29,20 @@ how_to_fix:
 levels: { strict: 6, normal: 8, relaxed: 12 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+sources: [shibasaki-tamaoka-2010, lee-2016]
+
+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