# hugo-build

Installs Go + Hugo (extended edition) and builds a Hugo site. Preview mode
includes drafts and future-dated posts; production mode does not.

## What it does

1. Sets up Go (for Hugo modules)
2. Downloads and installs Hugo extended from GitHub releases
3. Runs `hugo --gc --minify --baseURL <base-url>` in the working directory,
   adding `--buildDrafts --buildFuture` when `mode: preview`

Output lands in `<working-directory>/public`.

## Prerequisites

- The caller must have already checked out the Hugo site source. This action
  does **not** run `actions/checkout`.

## Required secrets

None.

## Caller workflow requirements

| | |
|---|---|
| **Permissions** | `contents: read` (for checkout, not for this action) |
| **Checkout** | Caller must checkout before calling |

## Usage

```yaml
- uses: actions/checkout@v6
  with:
    submodules: recursive
    fetch-depth: 0

- uses: modelcontextprotocol/actions/hugo-build@main
  with:
    working-directory: blog
    mode: preview   # or: production
    base-url: /
```

Then deploy `blog/public` however you like (Cloudflare Pages, GitHub Pages, etc.)

## Inputs

| Input | Required | Default | Description |
|---|---|---|---|
| `working-directory` | | `.` | Directory containing `hugo.toml` |
| `mode` | | `preview` | `preview` → development env, `--buildDrafts --buildFuture`. `production` → production env, no drafts/future. |
| `base-url` | | `/` | Hugo `--baseURL` |
| `hugo-version` | | `0.148.0` | Hugo extended version |
| `go-version` | | `1.24` | Go version for Hugo modules |

## Outputs

| Output | Description |
|---|---|
| `public-dir` | Path to built site (`<working-directory>/public`) |