Hugo 站点配置流程文档

安装检查工具

检查 Hugo 安装状态

hugo-mcp check-hugo

输出示例：

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

若未安装，系统将自动下载并安装最新版本的 Hugo。

检查 Git 安装状态

hugo-mcp check-git

输出示例：

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

若未安装，系统将自动下载并安装最新版本的 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
• Custom 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 仓库 提交问题。