セットアップガイド

必要な環境

基本要件

Node.js 14以上
Git
テキストエディタ（VSCode推奨）

AIツール（いずれか）

Claude Code
Gemini CLI
その他のAIアシスタント

インストール手順

1. プロジェクトのセットアップ

# リポジトリのクローン（サブモジュール含む）
git clone --recursive https://github.com/your-username/AutoSlideIdea.git
cd AutoSlideIdea

# ディレクトリ構造の確認
ls -la

# 既存のクローンにサブモジュールを追加する場合
git submodule update --init --recursive

2. 依存関係のインストール

# プロジェクトルートで実行
npm install

# 確認
npx marp --version

メリット：

グローバルインストール不要（権限問題なし）
プロジェクトごとにバージョン管理可能
package.jsonで依存関係を明確化

グローバルインストール（オプション）

システム全体で使いたい場合：

npm install -g @marp-team/marp-cli

3. VSCode拡張機能（推奨）

VSCodeを使用する場合、以下の拡張機能をインストール：

Marp for VS Code - スライドのプレビュー
Markdown All in One - Markdown編集支援
GitHub Copilot - AI補完（オプション）

# コマンドラインからインストール
code --install-extension marp-team.marp-vscode
code --install-extension yzhang.markdown-all-in-one

4. AIツールのセットアップ

以下のAIツールのいずれかをセットアップ：

Claude Code

# Claude Codeのインストール（公式ドキュメント参照）
# https://docs.anthropic.com/claude-code/

# 設定確認
claude-code --version

Gemini CLI

# Gemini CLIのインストール（公式ドキュメント参照）
# https://cloud.google.com/gemini/docs/cli

# 設定確認
gemini --version

5. フォント設定（日本語対応）

日本語フォントが正しく表示されるように設定：

# Ubuntu/Debian
sudo apt-get install fonts-noto-cjk

# macOS（Homebrewを使用）
brew install --cask font-noto-sans-cjk

環境設定の確認

💡 参考: サンプルプレゼンテーションで実際の出力例を確認できます

テスト用スライドの作成

# 🎯 推奨：統合管理スクリプトでテスト用プレゼンテーションを作成
./scripts/manage-presentation.sh test-presentation

# PDFを生成
cd presentations/test-presentation
npm run pdf -- slides.md -o test.pdf
# または
npx marp slides.md -o test.pdf

# 生成されたPDFを確認
open test.pdf  # macOS
xdg-open test.pdf  # Linux

スクリプトの動作確認

# 🎯 推奨：統合管理スクリプトの動作確認
./scripts/manage-presentation.sh --help

# 従来スクリプト（自動転送される）
./scripts/create-presentation.sh --help
./scripts/update-presentation.sh --help

トラブルシューティング

Marpが見つからない

# ローカルインストールの場合
npx marp --version

# またはnpmスクリプトを使用
npm run marp -- --version

# グローバルインストールの場合のPATH確認
echo $PATH
npm config get prefix

日本語が文字化けする

フォントがインストールされているか確認
Marp設定でフォントを明示的に指定

/* config/marp/base.css に追加 */
section {
  font-family: 'Noto Sans JP', 'Hiragino Kaku Gothic ProN', sans-serif;
}

PDFサイズが大きい

# 圧縮オプションを使用
npx marp slides.md -o output.pdf --pdf-notes --allow-local-files

次のステップ

セットアップが完了したら：

ワークフローを確認
新規プレゼンテーションを作成
AI支援でコンテンツを充実させる