← ClaudeAtlas

marp-shotslisted

README掲載用スクリーンショット(docs/*.png)の生成ワークフロー。「READMEの画像を更新して」「テーマ一覧の画像を撮り直して」「スクショを作り直して」、またはテーマ・レイアウトパターンを追加/変更したあとの見本画像更新で必ず使う。
unsolublesugar/marp-slides-studio · ★ 1 · Data & Documents · score 69
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` の配列に追加