セットアップガイド
必要な環境
基本要件
- 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支援でコンテンツを充実させる