| English | 日本語 |
スクリプトリファレンス
🎯 manage-presentation.sh（推奨）
プレゼンテーションの作成・更新を統合管理するメインスクリプトです。自動判定により適切な処理を実行します。
使用方法
./scripts/manage-presentation.sh [オプション] <プレゼンテーション名>
自動判定機能
- 既存チェック: 指定されたプレゼンテーションが存在するかを自動判定
- 適切な処理: 新規なら作成、既存なら適切な更新提案
- エラー回避: ユーザーが存在を意識する必要がない
オプション
| オプション | 説明 | 例 |
|---|---|---|
--create | 強制作成モード（既存の場合はエラー） | --create |
--update | 強制更新モード（存在しない場合はエラー） | --update |
--template <name> | 使用するテンプレートを指定 | --template academic |
--full | 調査・分析・アイデア創出を含む完全構造 | --full |
--github | GitHubリポジトリとして設定 | --github |
--public | パブリックリポジトリ（–github使用時） | --public |
--workflow <type> | GitHub Actionsワークフロー | --workflow github-pages |
--add-assets | アセットディレクトリ構造を追加 | --add-assets |
--add-research | 調査・分析・アイデア創出構造を追加 | --add-research |
--lang <code> | 言語指定（ja, en） | --lang en |
テンプレート一覧
basic- 基本的なプレゼンテーション（デフォルト）academic- 学術発表用（研究背景、手法、結果）business- ビジネス提案用（問題、解決策、効果）full-project- 完全プロジェクト構造（調査から実装まで）
ワークフロータイプ
basic- 基本的なPDF/HTML生成full-featured- 複数フォーマット対応、分析ツール連携multi-language- 多言語対応ビルドgithub-pages- GitHub Pages公開用
使用例
基本的な使用
# 自動判定（推奨）
./scripts/manage-presentation.sh my-talk
# GitHub連携（新規なら作成、既存なら追加）
./scripts/manage-presentation.sh --github conference-2024
# フルプロジェクト構造
./scripts/manage-presentation.sh --full research-project
明示的なモード
# 強制作成（既存の場合はエラー）
./scripts/manage-presentation.sh --create new-presentation
# 強制更新（存在しない場合はエラー）
./scripts/manage-presentation.sh --update existing-presentation --workflow github-pages
# 構造の拡張
./scripts/manage-presentation.sh --add-assets --add-research my-project
GitHub Pages対応
# GitHub Pages専用ワークフローで作成
./scripts/manage-presentation.sh --github --workflow github-pages portfolio-2024
# 既存プレゼンテーションをGitHub Pages対応に更新
./scripts/manage-presentation.sh --update --workflow github-pages existing-talk
💡 実例: AutoSlideIdeaデモサイトでGitHub Pages出力を確認
create-presentation.sh（非推奨）
互換性のため残されているwrapperスクリプトです。manage-presentation.sh --createに自動転送されます。
使用方法
./scripts/create-presentation.sh [オプション] <プレゼンテーション名>
⚠️ 警告: このスクリプトは非推奨です。manage-presentation.shの使用を推奨します。
update-presentation.sh（非推奨）
互換性のため残されているwrapperスクリプトです。manage-presentation.sh --updateに自動転送されます。
使用方法
./scripts/update-presentation.sh [オプション] <プレゼンテーション名またはパス>
⚠️ 警告: このスクリプトは非推奨です。manage-presentation.shの使用を推奨します。
build.sh
プレゼンテーションをビルドするためのヘルパースクリプトです。
使用方法
./scripts/build.sh <入力ファイル> [出力ファイル]
機能
- Marpのラッパーとして動作
- デフォルトの出力設定
- エラーハンドリング
使用例
# PDFを生成（デフォルト）
./scripts/build.sh presentations/my-talk/slides.md
# HTMLを生成
./scripts/build.sh presentations/my-talk/slides.md output.html
# カスタムオプション付き
./scripts/build.sh presentations/my-talk/slides.md --theme custom.css
環境変数
すべてのスクリプトで以下の環境変数を使用できます：
| 変数名 | 説明 | デフォルト |
|---|---|---|
AUTOSLIDE_LANG | デフォルト言語設定 | ja |
AUTOSLIDE_TEMPLATE | デフォルトテンプレート | basic |
設定例
# 英語をデフォルトに設定
export AUTOSLIDE_LANG=en
# .bashrcや.zshrcに追加して永続化
echo 'export AUTOSLIDE_LANG=en' >> ~/.bashrc
移行ガイド
従来スクリプトから統合スクリプトへ
| 従来 | 統合版 |
|---|---|
create-presentation.sh my-talk | manage-presentation.sh my-talk |
create-presentation.sh --github talk | manage-presentation.sh --github talk |
update-presentation.sh --add-github talk | manage-presentation.sh --github talk |
update-presentation.sh --workflow github-pages talk | manage-presentation.sh --workflow github-pages talk |
自動転送の仕組み
従来スクリプトは以下のように動作します：
- 非推奨警告を表示
- 適切なオプション付きで
manage-presentation.shに転送 - 処理を実行
トラブルシューティング
権限エラー
# スクリプトに実行権限を付与
chmod +x scripts/*.sh
パスが見つからない
# プロジェクトルートから実行
cd /path/to/AutoSlideIdea
./scripts/manage-presentation.sh my-talk
GitHub CLIエラー
# GitHub CLIのインストール確認
gh --version
# 認証状態の確認
gh auth status
自動判定の動作確認
# 存在しない場合の動作確認
./scripts/manage-presentation.sh non-existing-presentation
# 既存の場合の動作確認（テスト用）
mkdir -p presentations/test-existing
./scripts/manage-presentation.sh test-existing
ベストプラクティス
1. 統合スクリプトの活用
- 🎯
manage-presentation.shを優先的に使用 - 自動判定機能を活用してシンプルな操作を実現
- 明示的モードは確実性が必要な場合のみ使用
2. ワークフロー設計
# 開発フロー例
./scripts/manage-presentation.sh my-talk # 作成
./scripts/manage-presentation.sh --github my-talk # GitHub連携追加
./scripts/manage-presentation.sh --workflow github-pages my-talk # Pages対応
3. チーム開発
# チームメンバーは統一された方法で操作
./scripts/manage-presentation.sh --github --public team-presentation
カスタマイズ
新しいテンプレートの追加
templates/ディレクトリに新しいフォルダを作成- 必要なファイルを配置（slides.md, README.md など）
- プレースホルダーを使用（
,）
ワークフローのカスタマイズ
templates/github-workflows/に新しいYAMLファイルを作成- manage-presentation.shの
--workflowオプションで使用可能に