Hugo MCP

🚀 Hugo サイト構成フロードキュメント

このドキュメントは、Hugo サイトの構成に関する一連の操作を説明しています。Hugo のインストールチェックからサイトの作成、テーマ管理、コンテンツ作成、デプロイまで、各ステップのコマンドと使用例を提供しています。

🚀 クイックスタート

このセクションでは、Hugo サイトを構成するための基本的な手順を説明します。

📦 インストール

Hugo インストール状態のチェック

hugo-mcp check-hugo

出力例：

{
  "status": "success",
  "version": "0.98.6"
}

Hugo が未インストールの場合、システムは自動的に最新バージョンの Hugo をダウンロードしてインストールします。

Git インストール状態のチェック

hugo-mcp check-git

出力例：

{
  "status": "success",
  "version": "2.34.1"
}

Git が未インストールの場合、システムは自動的に最新バージョンの Git をダウンロードしてインストールします。

💻 使用例

サイトの作成と構成

新しいサイトの作成

hugo-mcp create-site [site-name] --theme=[theme-url] [--use-example-site]

例：

hugo-mcp create-site my-blog --theme=https://github.com/nanxiaobei/hugo-paper --use-example-site

Git 情報の構成

hugo-mcp config-git [name] [email]

例：

hugo-mcp config-git "John Doe" john.doe@example.com

テーマ管理

利用可能なテーマの一覧表示

hugo-mcp list-themes

出力例：

{
  "themes": [
    {
      "name": "Paper",
      "url": "https://github.com/nanxiaobei/hugo-paper"
    },
    {
      "name": "Default",
      "url": "https://github.com/gohugoio/hugo-default-theme"
    }
  ]
}

テーマの詳細情報の取得

hugo-mcp get-theme-details [theme-name]

例：

hugo-mcp get-theme-details Paper

サイト管理操作

プレビューサーバーの起動

hugo-mcp start-preview [site-path] [--port=8080]

例：

hugo-mcp start-preview /path/to/my/blog --port 9000

コンテンツ作成ツール

新しい記事の作成

hugo-mcp create-post [site-path] [post-title] [--draft]

例：

hugo-mcp create-post /path/to/my/blog my-first-post --draft

本番環境の構築

hugo-mcp build-site [site-path] [--minify]

デプロイと公開フロー

指定されたプラットフォームにサイトをデプロイする

hugo-mcp deploy-site [site-path] --platform=[platform] [--branch=main] [--commit-message="Update site"] [--api-key=your-token] [--remote-url=https://example.com]

サポートされているプラットフォーム：

• GitHub Pages
• Netlify
• Vercel
• カスタム Git リポジトリ

例：

hugo-mcp deploy-site /path/to/my/blog --platform github-pages --branch gh-pages --commit-message "Deploy site" --api-key your-github-token

📚 ドキュメント

トラブルシューティング

よくある問題

1. Hugo がインストールされていない場合：
   hugo-mcp install-hugo ツールを使用してインストールしてください。

2. Git がインストールされていない場合：
   hugo-mcp install-git ツールを使用してインストールしてください。

3. テーマのインストールに失敗した場合：

   • テーマの URL が正しいか確認してください。
   • サブモジュールと依存関係を処理するために、Git と Go が正常にインストールされていることを確認してください。

4. プレビューサーバーの起動に失敗した場合：

   • ポートが既に使用されていないか確認してください。
   • サイトのパスが正しいことを確認してください。

5. 構築に失敗した場合：

   • サイトのパスが正しいことを確認してください。
   • すべての依存関係がインストールされていることを確認してください。

ヘルプの取得

上記に挙げられていない問題が発生した場合は、GitHub リポジトリ を訪問して問題を提出してください。