Hugo Compose Recipe

Montuer has a continuously developed compose recipe dedicated for Hugo, a great static web content composer.

The objective is simple: to quickly and steadily compose the web content using Hugo up until ready for publications in a consistent, secured, and seamlessly easy manner.

All users has to do is to issue this command: 

1

monteur compose

For this recipe, they are arranged based on its own semantic versioning and is not directly related to Monteur's actual release version. Hence, feel free to explore and update each versions to suit your CI needs.

Resources

This recipe is built and maintained based on the following resources:

Recipe File

Here are all the Monteur Compose CI Job recipe files for operating Hugo semi-autonomously. They are sorted by the latest version first, at the top.

Please read through its requiremnets and changes before procuring.

Version v1.1.0

Download Link: hugo-v1p1p0.toml

Minimum Requirements

  • Montuer version: v0.0.2 and above.

  • Supported platform: STRICTLY depends on hugo availability.

Installation Instructions

  • Download and place the recipe file into your .configs/monteur/compose/jobs directory as hugo.toml.

  • Update the recipe's Variables.MainLang is your selected main language ID. Default is en.

  • Update the recipe's FMTVariables.SourceDir pointing to the directory for executing hugo command.

  • Update the recipe's FMTVariables.DestinationDir pointing to the directory for exporting the website artifacts.

  • Update the recipe's Dependencies when needed to match your customization needs.

  • Update the recipe's CMD when needed to match your customization needs.

Changelog

  • BACKWARD COMPATBILE - Added delete-quiet command before generation.

  • BACKWARD COMPATBILE - Make 404.html workaround to be quiet.

Version v1.0.0

Download Link: hugo-v1p0p0.toml

Minimum Requirements

  • Montuer version: v0.0.1.

  • Supported platform: STRICTLY depends on hugo availability.

Installation Instructions

  • Download and place the recipe file into your .configs/monteur/compose/composers directory as hugo.toml.

  • Update the recipe's Variables.MainLang is your selected main language ID. Default is en.

  • Update the recipe's FMTVariables.SourceDir pointing to the directory for executing hugo command.

  • Update the recipe's FMTVariables.DestinationDir pointing to the directory for exporting the website artifacts.

  • Update the recipe's Dependencies when needed to match your customization needs.

  • Update the recipe's CMD when needed to match your customization needs.

Changelog

  • BACKWARD COMPATBILE - Created the base TOML configuration recipe.

  • BACKWARD COMPATBILE - Tested with GitLab CI.

  • BACKWARD COMPATBILE - Implemented gh-pages branch publishing method for maximum compatibility between GitLab Pages and GitHub Pages.

  • BACKWARD COMPATBILE - Added Hugo's 404.html workaround by default for Hugo's multilingual website.

Epilogue

That's all for Monteur's Compose CI Job handling Hugo web content rendering tasks. If you have any question, please feel free to raise your question at our Issues Section.