Skip to main content Link Menu Expand (external link) Document Search Copy Copied

セットアップガイド

必要な環境

基本要件

  • 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を使用する場合、以下の拡張機能をインストール:

  1. Marp for VS Code - スライドのプレビュー
  2. Markdown All in One - Markdown編集支援
  3. 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

日本語が文字化けする

  1. フォントがインストールされているか確認
  2. 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

次のステップ

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

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