chaffjs 0.19.0 → 0.21.0

package/rules/bracket-width-consistency.yaml

@@ -0,0 +1,64 @@
+id: bracket-width-consistency
+layer: L1
+status: stable
+how_to_find: mark-consistency
+word_list: bracket-width
+languages: [ja]
+severity: info
+
+name:
+  ja: 丸括弧の全角と半角の混在
+  en: Full-width and half-width parentheses mixed
+
+why:
+  ja: 日本語の文の中で、丸括弧を全角（（））と半角（()）で混ぜて書くと、別々の所から貼り合わせた文書に見えます。どちらが正しいかは決めません。日本語の字に接する括弧だけを数え、文書の中で少ないほうを指します。
+  en: In a Japanese document, parentheses written both full-width （） and half-width () make it look pasted together. chaff does not pick a side; it counts only brackets touching Japanese text and points at the less common way.
+
+message:
+  ja: 括弧を「{mark}」と書いています（この文書はふつう「{usual}」。{of} 箇所のうち {count} 箇所が違う）
+  en: 'The parenthesis "{mark}" here, where the document usually writes "{usual}" ({count} of {of})'
+
+# 少ないほうが 5 箇所以上で、全体の 2 割を超えるとき。書き損じではなく書き方が二通りあるので、1 件にまとめて両方の数を言う。
+messages:
+  mixed:
+    ja: "丸括弧を、全角で {spaced} 箇所、半角で {touching} 箇所書いています。この文書には書き方が二通りあります"
+    en: "Parentheses are written two ways in this document ({spaced} full-width, {touching} half-width)"
+
+how_to_fix:
+  ja: 文書の多いほうの書き方に合わせてください。
+  en: Match the way the rest of the document writes it.
+
+levels: { strict: 1, normal: 1, relaxed: 3 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: consistency
+summary:
+  ja: 日本語の文の中で、丸括弧の全角（（））と半角（()）が混ざっている所
+  en: Full-width （） and half-width () parentheses mixed in one Japanese document
+example:
+  ja:
+    before: |
+      会議（定例）は月曜です。報告（月次）は金曜です。資料(最新版)を配ります。
+    after: |
+      会議（定例）は月曜です。報告（月次）は金曜です。資料（最新版）を配ります。
+
+not_flagged:
+  ja: 日本語の字に接する括弧だけを数えます。英語の中の括弧（f(x)、API(s)）、コード、鉤括弧で引いたものの中は数えません。
+  en: Only brackets touching Japanese text. Brackets in English text (f(x)), code, and 「」 quotations are not counted.
+level_meaning:
+  ja: 少ないほうの書き方が {limit} 箇所あれば指摘
+  en: reported once the less common way appears {limit} times
+rewrite:
+  depth: light
+  ja:
+    direction: 指された括弧だけを、文書の多いほうの書き方（全角か半角）に替えてください。
+    pairs:
+      - before: 資料(最新版)を配ります。
+        after: 資料（最新版）を配ります。
+      - before: 期限（今週金曜)までに出します。
+        after: 期限（今週金曜）までに出します。
+    keep:
+      - 括弧の中の言葉
+    avoid:
+      - 英語やコードの中の括弧まで替える

package/rules/broken-link.yaml

@@ -1,6 +1,6 @@
 id: broken-link
 layer: L1
-status: experimental
+status: stable
 how_to_find: broken-link
 requires: [markdown]
 severity: warning

package/rules/chat-citation-residue.yaml

@@ -0,0 +1,78 @@
+id: chat-citation-residue
+layer: L2
+status: stable
+how_to_find: chat-citation-residue
+word_list: chat-citation-marker
+severity: warning
+
+name:
+  ja: チャットの出典の名残
+  en: Chat citation residue
+
+why:
+  ja: 「?utm_source=chatgpt.com」の付いたリンクや「:contentReference[oaicite:0]」は、チャットの答えを貼ったときに残る印です。文体の好みではなく、貼った後に確かめていない印です。リンク先が本当にその記述の出典なのかも、確かめられていません。
+  en: 'A link ending in "?utm_source=chatgpt.com" and a ":contentReference[oaicite:0]" are marks a chat answer leaves when it is pasted. This is not a matter of style: it shows the paste was never checked, and that nobody has confirmed the link supports the sentence it sits on.'
+
+message:
+  ja: 「{matched}」はチャットの答えの名残です
+  en: '"{matched}" is left over from a chat answer'
+
+how_to_fix:
+  ja: リンクを開いて、その記述の出典になっているか確かめてください。出典なら、末尾の「?utm_source=…」を消してリンクを残します。出典の印（oaicite、contentReference）は消します。
+  en: Open the link and check it supports the sentence. If it does, keep the link and drop the "?utm_source=…" at its end. Delete citation marks (oaicite, contentReference).
+
+# 指摘に要る印の数。1 つで言う。
+levels: { strict: 1, normal: 1, relaxed: 2 }
+
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: slips
+summary:
+  ja: 「?utm_source=chatgpt.com」の付いたリンクや「oaicite」のように、チャットの答えを貼ったときに残る印
+  en: 'Marks a pasted chat answer leaves behind: links ending in "?utm_source=chatgpt.com", ":contentReference[oaicite:0]"'
+example:
+  ja:
+    before: |
+      手順は[公式の説明](https://example.com/setup?utm_source=chatgpt.com)のとおりです。
+    after: |
+      手順は[公式の説明](https://example.com/setup)のとおりです。
+  en:
+    before: |
+      The steps follow [the official guide](https://example.com/setup?utm_source=chatgpt.com).
+    after: |
+      The steps follow [the official guide](https://example.com/setup).
+
+not_flagged:
+  ja: コードの中（`?utm_source=chatgpt.com` と書いて説明している所）は数えません。utm_source でも、チャット以外の値（qiita、twitter）は数えません。
+  en: Code is not read (an article that explains the parameter in backticks). Other utm_source values (newsletter, twitter) are not counted.
+level_meaning:
+  ja: 名残の印が {limit} 個あれば指摘
+  en: reported once there are {limit}
+rewrite:
+  depth: light
+  ja:
+    direction: リンク先を開いて、その文の出典になっているかを確かめてから、チャットの印だけを消してください。出典にならないリンクは消し、確かめた出典に替えます。
+    pairs:
+      - before: 手順は[公式の説明](https://example.com/setup?utm_source=chatgpt.com)のとおりです。
+        after: 手順は[公式の説明](https://example.com/setup)のとおりです。
+      - before: 料金は月 500 円です。:contentReference[oaicite:0]{index=0}
+        after: 料金は月 500 円です（[料金表](［確かめた出典の URL］)）。
+    keep:
+      - リンク先のページそのもの（印を消すだけで、別のページに替えない）
+      - 文の中身と数字
+    avoid:
+      - 確かめずに印だけを消す
+      - 出典の無い数字に、それらしい出典を足す
+  en:
+    direction: Open the link and check it supports the sentence, then remove only the chat marks. A link that does not support the sentence goes, replaced by a source you checked.
+    pairs:
+      - before: The steps follow [the official guide](https://example.com/setup?utm_source=chatgpt.com).
+        after: The steps follow [the official guide](https://example.com/setup).
+      - before: The plan costs $5 a month. :contentReference[oaicite:0]{index=0}
+        after: The plan costs $5 a month ([pricing]([URL of the source you checked])).
+    keep:
+      - the page the link points to (remove the mark, do not swap the page)
+      - what the sentence says, and its numbers
+    avoid:
+      - removing the mark without checking the source
+      - adding a plausible source to a number that had none

package/rules/citation-reference-mismatch.yaml

@@ -0,0 +1,116 @@
+id: citation-reference-mismatch
+layer: L3
+status: stable
+how_to_find: citation-entry
+severity: warning
+
+name:
+  ja: 引用と文献一覧が合っていない
+  en: Citations and reference list do not match
+
+why:
+  ja: 本文が [5] を引いているのに文献一覧に 5 番が無いと、読み手は根拠を確かめられません。文献一覧にあるのに本文で一度も引かない文献は、消し忘れか、引用を消してしまったかのどちらかです。文献を足したり消したりして番号を振り直したときに起きます。番号で引く論文は番号どうしを、著者と年で引く論文は著者の姓と年どうしを比べます。読み取れる引用が文献の半分に満たない文書（上付きの番号がコピーで消えた文書など）では、引かれていない文献を指しません。
+  en: When the text cites [5] and the reference list has no entry 5, the reader cannot check the source. An entry the text never cites was either left behind or lost its citation. It happens when references are added or removed and renumbered. A paper that cites by number is compared number by number; one that cites by author and year, by surname and year. When fewer than half of the entries are cited in a form chaff reads (superscript numbers lost in a copy, say), uncited entries are not reported.
+
+message:
+  ja: 引用と文献一覧が合っていません
+  en: A citation and the reference list do not match
+
+messages:
+  missing:
+    ja: 引用「{citation}」の {key} が、文献一覧にありません
+    en: 'The citation "{citation}" names {key}, which is not in the reference list'
+  uncited:
+    ja: この文献は、本文で一度も引いていません
+    en: This entry of the reference list is never cited in the text
+
+how_to_fix:
+  ja: 本文の番号がずれていないか確かめて、引用か文献一覧を直してください。引かない文献は消すか、引く所を足してください。
+  en: Check whether the numbers shifted, and correct the citation or the list. Remove an entry that is never cited, or cite it where it belongs.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [academic, legal, docs, literature, speech]
+off_for:
+  legal: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
+  docs: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
+  literature: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
+  speech: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
+
+group: facts
+summary:
+  ja: 文献一覧に無い文献を引く引用と、本文で一度も引かない文献
+  en: A citation with no entry in the reference list, or an entry the text never cites
+example:
+  ja:
+    config: { genre: academic/paper }
+    before: |
+      # 睡眠と記憶
+
+      睡眠は記憶の定着を助ける[1]。短い昼寝でも効果がある[3]。
+
+      ## 参考文献
+
+      - [1] 佐藤一郎. 睡眠の研究. 2019.
+      - [2] 鈴木花子. 昼寝の効果. 2021.
+    after: |
+      # 睡眠と記憶
+
+      睡眠は記憶の定着を助ける[1]。短い昼寝でも効果がある[2]。
+
+      ## 参考文献
+
+      - [1] 佐藤一郎. 睡眠の研究. 2019.
+      - [2] 鈴木花子. 昼寝の効果. 2021.
+  en:
+    config: { genre: academic/paper }
+    before: |
+      # Sleep and memory
+
+      Sleep helps memories settle [1]. A short nap helps too [3].
+
+      ## References
+
+      - [1] Smith, A. Sleep. 2019.
+      - [2] Jones, B. Naps. 2021.
+    after: |
+      # Sleep and memory
+
+      Sleep helps memories settle [1]. A short nap helps too [2].
+
+      ## References
+
+      - [1] Smith, A. Sleep. 2019.
+      - [2] Jones, B. Naps. 2021.
+
+not_flagged:
+  ja: 「参考文献」「References」のような見出しの下に文献一覧が無い文書、番号も著者と年も読み取れない文献、文献が一つしか無い一覧は見ません。番号で引く引用と番号の文献、著者と年で引く引用と著者と年の文献は、それぞれの組の中だけで比べます。論文のジャンルでだけ見ます。
+  en: 'A document without a list under a heading such as "References", entries that give neither a number nor an author and a year, and a list of one entry are left alone. Numbered citations are compared only with numbered entries, and author-year citations only with author-year entries. Only the academic paper genre runs this rule.'
+rewrite:
+  depth: light
+  ja:
+    direction: 引用と文献一覧のどちらがずれたのかを書き手に確かめ、ずれたほうを直してください。番号を推測で書き換えず、確かめられないときはその旨を書き手に伝えます。引かない文献は、消すか、引く所を書き手に尋ねます。
+    pairs:
+      - before: 短い昼寝でも効果がある[3]。
+        after: 短い昼寝でも効果がある[2]。
+      - before: 先行研究（山田, 2019）でも同じ結果が出ている。
+        after: 先行研究（山田, 2020）でも同じ結果が出ている。
+    keep:
+      - どの文献を引いているか
+      - 文献一覧の書誌情報
+    avoid:
+      - 文献一覧に無い文献を作る
+      - どちらが正しいかを推測で決める
+  en:
+    direction: Ask the writer whether the citation or the list shifted, and correct the one that did. Do not guess a number; if it cannot be checked, say so. For an entry never cited, remove it or ask the writer where it is cited.
+    pairs:
+      - before: A short nap helps too [3].
+        after: A short nap helps too [2].
+      - before: Earlier work found the same (Smith, 2019).
+        after: Earlier work found the same (Smith, 2020).
+    keep:
+      - which work is cited
+      - the bibliographic details in the list
+    avoid:
+      - inventing an entry the list does not have
+      - guessing which side is right

package/rules/citation-style-mix.yaml

@@ -0,0 +1,115 @@
+id: citation-style-mix
+layer: L3
+status: stable
+how_to_find: citation-style
+severity: info
+
+name:
+  ja: 引用の書き方が揃っていない
+  en: Citations written in more than one style
+
+why:
+  ja: 一つの論文の中で、引用を [1] と書いた所と（山田, 2020）と書いた所が混ざっていると、読み手は文献一覧をどちらの引き方で探せばよいか迷います。別の原稿から文を移したときや、共著者が自分の書き方で足したときに起きます。chaff は、番号の角括弧（[1]）、亀甲括弧（〔1〕）、文の後ろの番号と片括弧（…である1)。）、著者と年（(Smith, 2020)、山田（2020））、年を書いた脚注（[^1]）を見分け、最も多い書き方と違う少数の書き方を指します。どの書き方が正しいかは決めません。
+  en: When one paper cites as [1] in some places and as (Smith, 2020) in others, the reader cannot tell which way to look up the reference list. It happens when text is moved from another manuscript, or when a co-author adds citations in their own style. chaff tells apart numbers in square brackets ([1]), numbers in tortoise-shell brackets (〔1〕), a number with a closing parenthesis after Japanese text (…である1)。), author and year ((Smith, 2020), Smith et al. (2020)) and footnotes whose note gives a year ([^1]), and points at the few citations that differ from the most common style. Which style is right is not decided.
+
+message:
+  ja: 引用「{citation}」の書き方が、この論文のほかの引用（「{majority}」など {count} 箇所）と違います
+  en: 'The citation "{citation}" is written differently from the paper''s other citations ("{majority}" and others, {count} in all)'
+
+how_to_fix:
+  ja: 多いほうの書き方に揃えてください。番号に揃えるなら、文献一覧にも番号を付けます。
+  en: Rewrite it in the style most citations use. If that style is numbered, give the reference its number in the list too.
+
+levels: { strict: 3, normal: 2, relaxed: 1 }
+
+use_for: [academic, legal, docs, literature, speech]
+off_for:
+  legal: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
+  docs: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
+  literature: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
+  speech: "A paper's citations, figures and abstract: only the academic paper genre turns these on."
+
+group: consistency
+summary:
+  ja: 一つの論文の中で、[1] の引用と（山田, 2020）の引用のように、引用の書き方が混ざっている所
+  en: A paper that cites as [1] in one place and as (Smith, 2020) in another
+example:
+  ja:
+    config: { genre: academic/paper }
+    before: |
+      # 睡眠と記憶
+
+      睡眠は記憶の定着を助ける[1]。短い昼寝でも効果がある[2]。夜に学んだあとで眠ると、翌朝によく思い出せる（山田, 2020）。
+
+      ## 参考文献
+
+      - [1] 佐藤一郎. 睡眠の研究. 2019.
+      - [2] 鈴木花子. 昼寝の効果. 2021.
+      - [3] 山田太郎. 夜の学習. 2020.
+    after: |
+      # 睡眠と記憶
+
+      睡眠は記憶の定着を助ける[1]。短い昼寝でも効果がある[2]。夜に学んだあとで眠ると、翌朝によく思い出せる[3]。
+
+      ## 参考文献
+
+      - [1] 佐藤一郎. 睡眠の研究. 2019.
+      - [2] 鈴木花子. 昼寝の効果. 2021.
+      - [3] 山田太郎. 夜の学習. 2020.
+  en:
+    config: { genre: academic/paper }
+    before: |
+      # Sleep and memory
+
+      Sleep helps memories settle [1]. A short nap helps too [2]. Sleeping after study in the evening improves recall the next morning (Young, 2020).
+
+      ## References
+
+      - [1] Smith, A. Sleep. 2019.
+      - [2] Jones, B. Naps. 2021.
+      - [3] Young, C. Evening study. 2020.
+    after: |
+      # Sleep and memory
+
+      Sleep helps memories settle [1]. A short nap helps too [2]. Sleeping after study in the evening improves recall the next morning [3].
+
+      ## References
+
+      - [1] Smith, A. Sleep. 2019.
+      - [2] Jones, B. Naps. 2021.
+      - [3] Young, C. Evening study. 2020.
+
+not_flagged:
+  ja: 文献一覧の中、コードの中、行の頭の番号（箇条書きの番号）、年を書いていない脚注、月や季節の後ろの年（（2020年3月）、(March 2020)）は引用として数えません。少数の書き方が {limit} 箇所を超えるときは、意図して使い分けているとみなして指しません。論文のジャンルでだけ見ます。
+  en: 'Citations inside the reference list or code, numbers at the start of a line (a numbered list), footnotes whose note gives no year, and a year after a month or a season ("(March 2020)") are not counted. When the minority style is used more than {limit} times, it is taken as a deliberate choice and not reported. Only the academic paper genre runs this rule.'
+level_meaning:
+  ja: 少ないほうの書き方が {limit} 箇所以下のとき指摘
+  en: reported when the minority style appears {limit} times or fewer
+rewrite:
+  depth: light
+  ja:
+    direction: 少数の書き方の引用を、論文で最も多い書き方に書き直してください。番号の方式なら、その文献の文献一覧での番号を使います。番号が分からなければ、書き手に確かめます。
+    pairs:
+      - before: 翌朝によく思い出せる（山田, 2020）。
+        after: 翌朝によく思い出せる[3]。
+      - before: 昼寝の効果は小さい〔4〕。
+        after: 昼寝の効果は小さい[4]。
+    keep:
+      - 引いている文献
+      - 引用を置いた文の中の位置
+    avoid:
+      - 文献一覧に無い番号を作る
+      - 引用を消す
+  en:
+    direction: Rewrite each citation in the minority style in the style the paper uses most. For a numbered style, use the reference's number in the list; if it is not clear, ask the writer.
+    pairs:
+      - before: improves recall the next morning (Young, 2020).
+        after: improves recall the next morning [3].
+      - before: as Jones et al. (2021) showed,
+        after: as shown in [2],
+    keep:
+      - which work is cited
+      - where in the sentence the citation sits
+    avoid:
+      - inventing a number the reference list does not have
+      - dropping the citation

package/rules/clause-chain.yaml

@@ -0,0 +1,64 @@
+id: clause-chain
+layer: L3
+status: stable
+how_to_find: clause-chain
+requires: [pos]
+languages: [ja]
+severity: info
+
+name:
+  ja: 一文に節がつながりすぎている
+  en: Too many clauses chained in one sentence
+
+why:
+  ja: 「調べて、まとめ、報告したが、返事がないので、もう一度送ったところ、」のように、「て」「が」「ので」や読点で節を次々につなぐと、読み手はどの節がどれに係るのかを覚えたまま最後まで読むことになります。文の長さが上限に収まっていても起きます。数えるのは、接続助詞（て・が・ので・から・ば・たら・ながら など）と、読点で止めた動詞・形容詞（まとめ、）です。「調べている」「読んでもらう」のような補助動詞へのつなぎは一つの述語なので数えません。鉤括弧で引いたものの中も数えません。
+  en: In Japanese, chaining clause after clause with て, が, ので or a comma after a verb makes the reader hold how each one attaches until the end of the sentence, even when the sentence is within the length limit. Conjunctive particles and verbs or adjectives stopped by a comma are counted; て joining a helper verb (調べている) is one predicate and is not. Anything in 「」 is not counted.
+
+message:
+  ja: 一文に節が {count} つつながっています（{limit} つまで）
+  en: "{count} clauses chained in one sentence (limit {limit})"
+
+how_to_fix:
+  ja: 節のつなぎ目のどこかで文を切ってください。「〜が、」「〜ので、」の所で切ると、前後の関係を「しかし」「そのため」で言い直せます。
+  en: Split the sentence at one of the joins, and say how the parts relate with a connective at the start of the next sentence.
+
+levels: { strict: 4, normal: 5, relaxed: 7 }
+
+# 法令と契約は、要件を節でつないで一文に書く。既定の上限では group の文書の過半に出たので、測って上げた（spec §21.1）。
+by_genre:
+  legal: { strict: 7, normal: 8, relaxed: 10 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 「〜て、〜し、〜が、〜ので、」のように、一文の中で節を次々につないでいる所
+  en: A Japanese sentence that chains clause after clause with て, が, ので and commas
+example:
+  ja:
+    before: |
+      資料を調べて、内容をまとめ、課長に報告したが、返事がないので、もう一度送ってみたところ、翌日に返事が来て、修正を頼まれた。
+    after: |
+      資料を調べて内容をまとめ、課長に報告しました。返事がないのでもう一度送ると、翌日に返事が来ました。修正を頼まれています。
+
+not_flagged:
+  ja: 補助動詞へのつなぎ（調べている、読んでもらう）、鉤括弧で引いたものの中、上限までの節は数えません。英語の文書には使いません。
+  en: Joins to a helper verb, anything quoted in 「」, and clauses up to the limit are not counted. Not used on English documents.
+level_meaning:
+  ja: 一文の節 {limit} つまで
+  en: up to {limit} clauses in one sentence
+rewrite:
+  depth: light
+  ja:
+    direction: 節のつなぎ目（「〜が、」「〜ので、」「〜て、」）のどこかで文を切り、切った所の関係を次の文の頭で言い直してください。
+    pairs:
+      - before: 資料を調べて、内容をまとめ、課長に報告したが、返事がないので、もう一度送った。
+        after: 資料を調べて内容をまとめ、課長に報告しました。しかし返事がないので、もう一度送りました。
+      - before: 会場を予約し、案内を送り、出欠を集めたが、人数が足りないので、日程を変えて、もう一度案内した。
+        after: 会場を予約し、案内を送って出欠を集めました。人数が足りなかったため、日程を変えてもう一度案内しました。
+    keep:
+      - 出来事の順序と、原因と結果の関係
+      - 誰が何をしたのか
+    avoid:
+      - 節を落として意味を変える
+      - 読点を消すだけで、同じ数の節をつないだままにする

package/rules/closing-cliche.yaml

@@ -29,6 +29,12 @@ levels:
   relaxed: 2
 
 use_for: [blog, legal, docs, academic, literature, speech]
+off_for:
+  legal: "Legal drafting repeats its terms and its sentence heads on purpose, puts the actor in the passive (shall be deemed), and joins long noun compounds (個人情報取扱事業者). This rule would only flag the form."
+  docs: "A help page repeats its heading in its first line (To upload a file, ...) and states no claims to back up."
+  academic: "Science writes in the passive, hedges its claims on purpose (may, suggest) and cites numbers as its evidence."
+  literature: "Length, rhythm, repetition and register are the author's choices in literature, and dialogue mixes styles. Only what one work can hold itself to runs: consistent spacing and commas, and numbering without gaps."
+  speech: "A speech opens with greetings and closes with thanks: that is its form, not padding."
 
 group: wording
 summary:
@@ -63,6 +69,7 @@ level_meaning:
   ja: 当てはまる結びが {limit} 箇所あれば指摘
   en: reported once there are {limit}
 rewrite:
+  depth: light
   ja:
     direction: 決まり文句の結びを消してください。本文の結論がすでに最後にあれば、そこで終えます。無ければ、本文で分かったことのうち持ち帰ってほしい一つを一文で書きます。
     pairs:

package/rules/code-fence-language-mix.yaml

@@ -0,0 +1,176 @@
+id: code-fence-language-mix
+layer: L1
+status: stable
+how_to_find: code-fence-language
+requires: [markdown]
+severity: info
+
+name:
+  ja: 言語名の無いコードブロックが混ざっている
+  en: Code blocks with and without a language
+
+why:
+  ja: コードブロックに言語名（```bash、```json）を付けると、読み手の画面で色が付き、何の言語かがひと目で分かります。ほとんどのブロックに付けているのに一部だけ無いと、そのブロックだけ色が付かず、付け忘れに見えます。どちらに揃えるかは決めず、少ないほうを指します（markdownlint の MD040 は、すべてのブロックに言語名を求めます）。
+  en: "A language on a code block (```bash, ```json) gives it highlighting on the reader's screen and says at a glance what it is. When most blocks name their language and a few do not, those few show plain and look forgotten. chaff does not decide which way to go; it points at the fewer (markdownlint's MD040 asks for a language on every block)."
+
+message:
+  ja: このコードブロックだけ言語名がありません（言語名のあるブロック {tagged} 個）
+  en: This code block names no language, unlike the others ({tagged} blocks name one)
+
+how_to_fix:
+  ja: 「```」の後ろに言語名を書いてください。出力や平文なら「text」と書きます。
+  en: Add the language after the opening ```. For output or plain text, write "text".
+
+levels: { strict: 3, normal: 2, relaxed: 1 }
+
+use_for: [technical, docs, blog, legal, academic, literature, speech]
+off_for:
+  legal: "Code blocks, shell prompts, command headings and numbered steps belong to technical writing."
+  academic: "Code blocks, shell prompts, command headings and numbered steps belong to technical writing."
+  literature: "Code blocks, shell prompts, command headings and numbered steps belong to technical writing."
+  speech: "Code blocks, shell prompts, command headings and numbered steps belong to technical writing."
+
+group: consistency
+summary:
+  ja: ほとんどのコードブロックに言語名があるのに、一部だけ無い所
+  en: A code block without a language among blocks that name theirs
+example:
+  ja:
+    config: { genre: docs/manual }
+    before: |
+      # 使い方
+
+      インストールします。
+
+      ```bash
+      npm install chaffjs
+      ```
+
+      設定を書きます。
+
+      ```yaml
+      genre: technical/readme
+      ```
+
+      確かめます。
+
+      ```
+      npx chaffjs README.md
+      ```
+    after: |
+      # 使い方
+
+      インストールします。
+
+      ```bash
+      npm install chaffjs
+      ```
+
+      設定を書きます。
+
+      ```yaml
+      genre: technical/readme
+      ```
+
+      確かめます。
+
+      ```bash
+      npx chaffjs README.md
+      ```
+  en:
+    config: { genre: docs/manual }
+    before: |
+      # Usage
+
+      Install it.
+
+      ```bash
+      npm install chaffjs
+      ```
+
+      Write the settings.
+
+      ```yaml
+      genre: technical/readme
+      ```
+
+      Check a file.
+
+      ```
+      npx chaffjs README.md
+      ```
+    after: |
+      # Usage
+
+      Install it.
+
+      ```bash
+      npm install chaffjs
+      ```
+
+      Write the settings.
+
+      ```yaml
+      genre: technical/readme
+      ```
+
+      Check a file.
+
+      ```bash
+      npx chaffjs README.md
+      ```
+
+not_flagged:
+  ja: 字下げだけのコードブロック、引用の中のブロックは見ません。言語名の無いブロックが {limit} 個を超えるとき、または言語名のあるブロックより多いときは、使い分けとみなして指しません。
+  en: Indented code blocks and blocks inside a quotation are not read. When more than {limit} blocks lack a language, or they are as many as those with one, it is taken as a choice and not reported.
+level_meaning:
+  ja: 言語名の無いブロックが {limit} 個以下で、ある方より少ないとき指摘
+  en: reported when {limit} or fewer blocks lack a language and they are fewer than those with one
+rewrite:
+  depth: light
+  ja:
+    direction: 言語名の無いブロックに、中身の言語名を付けてください。コマンドなら bash、設定なら yaml や json、出力や平文なら text です。中身から言語が決められなければ text にします。コードは変えません。
+    pairs:
+      - before: |
+          ```
+          npx chaffjs README.md
+          ```
+        after: |
+          ```bash
+          npx chaffjs README.md
+          ```
+      - before: |
+          ```
+          3 findings
+          ```
+        after: |
+          ```text
+          3 findings
+          ```
+    keep:
+      - ブロックの中身
+    avoid:
+      - 中身と違う言語名を付ける
+  en:
+    direction: Give each block without a language the language of its content. Commands are bash, settings yaml or json, output or plain text text. If the content does not settle it, use text. Do not change the code.
+    pairs:
+      - before: |
+          ```
+          npx chaffjs README.md
+          ```
+        after: |
+          ```bash
+          npx chaffjs README.md
+          ```
+      - before: |
+          ```
+          3 findings
+          ```
+        after: |
+          ```text
+          3 findings
+          ```
+    keep:
+      - the block's content
+    avoid:
+      - naming a language the content is not in