絵文字の付いた見出しが続く
emoji-heading既定で動く(情報)日本語 / 英語
「## 🚀 はじめに」のように、見出しごとに絵文字が付いている所
例
指摘される文
# 在庫の数え方
## 🚀 はじめに
毎朝、倉庫の在庫を数えています。
## 🛠️ 手順
棚ごとに数え、表に書きます。
## ✅ まとめ
数え終えたら、表を共有します。
chaff の出力
3:1 見出し「🚀 はじめに」に絵文字があります(絵文字の付いた見出しが 3 個、3 個から)
7:1 見出し「🛠️ 手順」に絵文字があります(絵文字の付いた見出しが 3 個、3 個から)
11:1 見出し「✅ まとめ」に絵文字があります(絵文字の付いた見出しが 3 個、3 個から)
直した文
# 在庫の数え方
## はじめに
毎朝、倉庫の在庫を数えています。
## 手順
棚ごとに数え、表に書きます。
## 数えた後
数え終えたら、表を共有します。
chaff の出力
指摘なし
この例で使った chaff.yaml
genre: blog/tech
直し方
見出しから絵文字を外し、節の中身が分かる言葉にしてください。一つだけ目印にしたい見出しがあれば、それだけ残してもかまいません。
なぜ指摘するのか
「## 🚀 はじめに」「## ✅ まとめ」のように、見出しごとに絵文字を付ける形です。どの見出しにも付くと、絵文字は節の中身を何も伝えず、目次と画面読み上げには意味の無い記号が並びます。生成文によく見られる形です。
指摘しないもの
指摘に要る数に届かない見出しと、矢印(→)や ™ のように絵文字として描かれない記号は数えません。説明書・法務・論文・文学のジャンルでは見ません。
止める・ゆるめる
この一か所だけ黙らせる(文書に書く)
<!-- stet: emoji-heading — 理由 -->
チームでゆるめる(理由は chaff.yaml にコメントで残ります)
npx chaffjs relax emoji-heading --why "理由"
チームで止める(chaff.yaml)
rules:
emoji-heading: off
技術的な情報
- 層
- L1
- 状態
- 安定
- 重さ
- 情報
- 対象の言語
- 日本語と英語
- 向いている文章
- blog, business, legal, docs, academic, literature, speech
- 文書から読み取るもの
- markdown
強さ(段階)
chaff.yaml の rules にこの名前と段階を書くと変わります。書かなければ、ジャンルが決めた段階で動きます(どのジャンルで動くかは下の「ジャンルごとの動き」にあります)。
| strict | 絵文字の付いた見出しが 2 個あれば指摘 |
|---|---|
| normal | 絵文字の付いた見出しが 3 個あれば指摘 |
| relaxed | 絵文字の付いた見出しが 5 個あれば指摘 |
ジャンルごとの動き
- 既定で動くジャンル
- blog/tech, blog/essay, blog/owned-media, business/proposal, business/report, business/email, business/press-release, business/meeting-notes, speech/address, speech/transcript
- このルールを止めるジャンル
- legal/contract, legal/statute, legal/judgment, legal/patent, docs/manual, docs/faq, docs/glossary, academic/paper, literature/fiction, literature/essay, literature/poetry, literature/play
- このルールが向かず、見ないジャンル
- technical/spec, technical/readme
指摘の文
見出し「{heading}」に絵文字があります(絵文字の付いた見出しが {count} 個、{limit} 個から)
書き直しの深さ(chaff fix-plan --depth): light — 語と文を直す。構成と文体は残す
根拠にした文献
このページはルールの定義ファイルから作られています:packages/chaff/rules/emoji-heading.yaml