段落が長すぎる
max-paragraph-length既定で動く(情報)日本語 / 英語
文を詰めこみすぎて、息をつく場所がない段落
例
指摘される文
今期の売上は前年より一割増えましたが、その多くは春に新しく始めた定期購入の申し込みによるもので、店頭での買い物が増えたわけではありませんでした。一方で、店頭での販売は三か月続けて前年を下回り、特に平日の夕方の客数が大きく減っています。原因として、駅の反対側に開いた競合店と、夕方の品ぞろえの薄さが考えられるという声が、先月の店長会議で何人もの店長から出ました。来期は夕方の品ぞろえを見直し、定期購入の案内を店頭でも配ることで、両方の数字を同時に上げることを目指します。
chaff の出力
1:1 この段落は 4 文あります(3 文まで)
直した文
今期の売上は前年より一割増えました。その多くは、新しく始めた定期購入の申し込みによるものです。
一方で、店頭での販売は三か月続けて前年を下回りました。特に平日の夕方の客数が大きく減っています。
来期は夕方の品ぞろえを見直し、定期購入の案内を店頭でも配ります。
chaff の出力
指摘なし
この例で使った chaff.yaml
rules:
max-paragraph-length: strict
直し方
話題の変わり目で段落を割ってください。
なぜ指摘するのか
1 段落に文を詰めると、読み手はどこで息継ぎしていいか分からなくなります。短い文をいくつ並べても壁にはならないので、段落が普通の長さの文を上限の数だけ並べたより長いときだけ指摘します。
指摘しないもの
文の数が多くても、短い文を重ねただけの段落(普通の長さの文を上限の数だけ並べたより短いもの)は指しません。
止める・ゆるめる
この一か所だけ黙らせる(文書に書く)
<!-- stet: max-paragraph-length — 理由 -->
チームでゆるめる(理由は chaff.yaml にコメントで残ります)
npx chaffjs relax max-paragraph-length --why "理由"
チームで止める(chaff.yaml)
rules:
max-paragraph-length: off
技術的な情報
- 層
- L1
- 状態
- 安定
- 重さ
- 情報
- 対象の言語
- 日本語と英語
- 向いている文章
- blog, business, technical, legal, docs, academic, literature, speech
強さ(段階)
chaff.yaml の rules にこの名前と段階を書くと変わります。書かなければ、ジャンルが決めた段階で動きます(どのジャンルで動くかは下の「ジャンルごとの動き」にあります)。
| strict | 一つの段落に 3 文まで |
|---|---|
| normal | 一つの段落に 5 文まで |
| relaxed | 一つの段落に 8 文まで |
次のジャンルは、段階に別の数字を持っています(npx chaffjs explain で確かめられます): legal, legal/statute, legal/judgment, academic
ジャンルごとの動き
- 既定で動くジャンル
- technical/spec, technical/readme, blog/tech, blog/essay, blog/owned-media, business/proposal, business/report, business/email, business/press-release, business/meeting-notes, legal/contract, legal/statute, legal/judgment, legal/patent, docs/manual, docs/faq, docs/glossary, academic/paper, speech/address
- このルールを止めるジャンル
- literature/fiction, literature/essay, literature/poetry, literature/play, speech/transcript
指摘の文
この段落は {count} 文あります({limit} 文まで)
根拠にした文献
このページはルールの定義ファイルから作られています:packages/chaff/rules/max-paragraph-length.yaml