hugo-asciidoc-docker-ci/README.adoc

Docker image to build Hugo sites in a CI environment

Table of Contents

• Features
• Installation

I created this image because all of the current options for building my Hugo sites in a CI environment were either missing some dependencies needed for my site or the contained Hugo version was too old.

Features

• Based on the official Arch Linux image

• Included dependencies (latest versions available for Arch Linux at build time)

  • Hugo

  • AsciiDoctor

    • AsciiDoctor html5s backend

  • go

  • Rouge syntax highlighter

  • npm and nodejs

  • git

Installation

• Download Docker image

• GitHub/Forgejo/Gitea Actions example usage. This is how I build and deploy my homepage korhonen.cc.