marp-shotslisted
Install: claude install-skill unsolublesugar/marp-slides-studio
# README用スクリーンショット生成ワークフロー
`docs/*.png` は README に貼るテーマ・レイアウト・パターンの見本画像。手作業で撮らず、`scripts/docs-shot.mjs` で再現可能な形で生成する。
## 手順
1. **生成**: `npm run docs-shot`(全プリセット)/ `npm run docs-shot -- themes layouts`(指定のみ)
2. **目視確認**: 生成された `docs/<preset>.png` をReadツールで開いて確認する
- [ ] 見本タイトルが意図しない位置で折り返していない(特に `split-*` は表紙が左半分)
- [ ] 追加したテーマ/パターンがグリッドに入っている
- [ ] セルの抜け・空白セルがない
3. **README側の記述と突き合わせる**: 画像の説明文(「上の例の左が navy、右が forest」など)が実際の並び順と合っているか確認する
## プリセット
| プリセット | 中身 | 段組 |
| --- | --- | --- |
| `themes` | レイアウト×配色×トーンの幅が伝わるよう選んだ表紙(`SHOWCASE_THEMES`) | 3列 |
| `tones` | トーンの代表(casual/pop/chic/business)の本文 | 2列 |
| `layouts` | レイアウトレイヤーごとの代表の表紙+本文のペア(1行=1レイアウト) | 2列 |
| `patterns` | 代表的なレイアウトパターン(navy) | 3列・枠線 |
| `code-block` | コードブロック2枚(navy) | 2列・枠線 |
| `code-block-diff` | diff表示(navy / forest) | 2列・枠線 |
| `gallery` | テーマギャラリーのUI(`theme-gallery.mjs` を実行して撮る。`GALLERY_THEMES` = 色系統1つにつき1テーマ) | ページ実写 1280×960 |
| `theme-preview` | テーマ��替プレビューのUI(`theme-preview.mjs` を作例デッキ + `PREVIEW_THEMES` で実行して��る) | ページ実写 1280×780 |
## 仕組み
`scripts/docs-shot.mjs` が次の3段でPNGを作る。ImageMagick等の追加依存はなく、Marpが使うのと同じローカルChromeだけで完結する。
1. プリセット定義から1セル1枚の見本デッキを `.docs-shot/<preset>/` に書き出す
2. ディレクトリをまとめてMarpに渡してPNG化する(Chrome起動は1回)
3. PNGをCSS Gridに並べたHTMLを作り、Chromeヘッドレスの `--screenshot` で1枚に撮る
Chromeは `/Applications/Google Chrome.app` などの既定パスを探す。見つからない環境では `CHROME_PATH` で明示する。
## 見本の内容を変える
すべて `scripts/docs-shot.mjs` の中で完結している。
- **テーマを足した** → `SHOWCASE_THEMES` / `TONES` / `LAYOUTS` の配列に追加