ルールの一覧へ

コロンで箇条書きへ渡す文が多い

colon-lead-in既定で動く(情報)日本語

「以下の通りです:」のように、コロンで終わる文から箇条書きへ渡す形が続き、説明が箇条書きの前置きだけになっている所

例

指摘される文
準備は以下の通りです: - 鍵 - 地図 当日の流れは次の通りです: - 集合 - 出発
chaff の出力
1:1 コロンで箇条書きへ渡す文が 1000 字あたり 3.6 個あります(2 個まで) 6:1 コロンで箇条書きへ渡す文が 1000 字あたり 3.6 個あります(2 個まで)
直した文
鍵と地図を用意してください。当日は駅に集合してから出発します。 - 鍵 - 地図
chaff の出力
指摘なし

文書全体の割合を見るルールなので、この例の後ろに指摘のない普通の文章(日本語で 500 字、英語で 200 語ほど)を足して試しています。

直し方

箇条書きの一部を文に戻し、項目どうしがどう繋がるのかを書いてください。手順や部品の一覧のように、本当に並べるものはそのままでかまいません。

なぜ指摘するのか

「以下の通りです:」「ポイントは次の 3 つ:」のように、コロンで終わる文から箇条書きへ渡す形です。1 つなら案内ですが、節ごとに続くと、説明が箇条書きの前置きだけになり、項目どうしの繋がりが書かれません。生成文によく見られる形です。

指摘しないもの

1 つだけのコロンの前置きと、コロンで終わらない前置き(「次のとおりとする。」)は数えません。項目ごとに同じ名詞の札(太字の「参考:」)を置く形は、項目の欄の名前なので数えません。説明書・法務・仕様書(technical/spec)のジャンルでは見ません。短い文書は測りません。英語の文書は、人もよくこの形で書くので見ません。日本語の文書の中の英文(Examples include:)も数えません。

止める・ゆるめる

この一か所だけ黙らせる(文書に書く)
<!-- stet: colon-lead-in — 理由 -->
チームでゆるめる(理由は chaff.yaml にコメントで残ります)
npx chaffjs relax colon-lead-in --why "理由"
チームで止める(chaff.yaml)
rules: colon-lead-in: off
技術的な情報
層
L1
状態
安定
重さ
情報
対象の言語
ja
向いている文章
technical/readme, blog, business, legal, docs, academic, literature, speech

強さ(段階)

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

strictコロンで箇条書きへ渡す文が 1000 字あたり 1 個まで
normalコロンで箇条書きへ渡す文が 1000 字あたり 2 個まで
relaxedコロンで箇条書きへ渡す文が 1000 字あたり 4 個まで

ジャンルごとの動き

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

ジャンル

指摘の文

コロンで箇条書きへ渡す文が 1000 字あたり {density} 個あります({limit} 個まで)

書き直しの深さ(chaff fix-plan --depth): structure — 節・見出し・段落を組み替える

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