https://github.com/mrcsharp22/hugo-vsts

Azure DevOps build pipeline task for Hugo (Static Site Generator)
https://github.com/mrcsharp22/hugo-vsts

Last synced: about 2 months ago
JSON representation

Azure DevOps build pipeline task for Hugo (Static Site Generator)

• Host: GitHub
• URL: https://github.com/mrcsharp22/hugo-vsts
• Owner: MrCSharp22
• License: mit
• Created: 2022-09-10T08:06:20.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2023-10-02T09:23:48.000Z (over 1 year ago)
• Last Synced: 2023-10-02T11:37:26.183Z (over 1 year ago)
• Language: JavaScript
• Size: 1.63 MB
• Stars: 0
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
Generates a site using Hugo, a fast and flexible static website generator.

This is a fork/re-work of [Hugo VSTS Extension by Giulio Vian](https://github.com/giuliov/hugo-vsts-extension) to fix build issues with the latest Hugo version.

[![Hugo logo here](images/hugo-128x128.png)](https://gohugo.io/)

# Usage

The Build Task will automatically download the `hugo` executable, if the version is not already present on the build machine, and invoke it.

You can specify some common options.

- **Source**: relative path from repo root of the Hugo sources, defaults to `Build.SourcesDirectory`, passed as `--source` flag.

- **Destination**: path of Hugo generated site, typically `Build.ArtifactStagingDirectory`, passed as `--destination` flag.

- **Hugo Version**: defines the Hugo version, use `latest`, `0.25.1`, `0.24`, but not `v0.24` (pick valid values from Hugo [Releases](https://github.com/gohugoio/hugo/releases) page). If the preferred version cannot be found, the latest released version will be used instead.

- **Extended Version**: download the extended Hugo version (SCSS/Sass support).

- **Base URL**: sets the hostname (and path) to the root, e.g. `https://example.com/`, passed as `--baseURL` flag.

- **Include Drafts**: to include content marked as draft, passed as `--buildDrafts` flag.

- **Include Expired**: to include expired content, passed as `--buildExpired` flag.

- **Include Future**: to include content with publishdate in the future, passed as `--buildFuture` flag.

- **Minify Output**: to minify supported output files (HTML, CSS, XML, etc...).

![Build Task Arguments screenshot here](images/vsts-task-config-ui.png)

More information on Hugo on [this website](https://gohugo.io/).

The Hugo logos are copyright © Steve Francia 2013–2022.

# Release Notes

- Initial release

## TODO

- Add instructions for building this extension