Wercker Step Hugo Build

Overview

Wercker’s Step Hugo Build is a powerful tool designed to streamline the process of generating static sites with Hugo. With this step, developers can easily download a specified version of Hugo and run it on their source code to create a static version of their site, which can then be deployed automatically in conjunction with other integrated steps. This capability not only enhances efficiency but also simplifies the deployment workflow, making it an essential asset for users working within the Wercker environment.

One of the standout features of this step is that it comes pre-installed with the latest two versions of Hugo, allowing for faster operations by skipping the download process. This makes it particularly beneficial for users who want a quick turnaround while maintaining the flexibility to specify custom configurations as necessary.

Features

• Multiple Hugo Versions: Comes with the latest two versions of Hugo already installed, eliminating the need for lengthy downloads.
• Flexible Versioning: Users can specify the exact version of Hugo they wish to use, providing control over the build environment.
• Theme Support: Easily define a theme for site generation; if none is specified, the default no-theme option applies.
• Custom Configuration Handling: Ability to provide a custom configuration file, enhancing adaptability to different project needs.
• Force Install Option: The force_install parameter allows users to ensure that Hugo is installed, even if a version is already present.
• Development and Production Flags: Users can define specific flags for different git branches, thus improving the build customization based on development or production needs.
• Clean Build Environment: The default behavior removes the public directory before each build to ensure that the build environment is clean and up-to-date.
• Automatic Pygment Installation: Optional installation of Pygments is available for those who prefer it over Hugo’s default Chroma syntax highlighter.