hugo-asciidoc-docker-ci/README.adoc

= Docker image to build Hugo sites in a CI environment

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
*** link:https://github.com/jirutka/asciidoctor-html5s[AsciiDoctor html5s backend]
** go
** Rouge syntax highlighter
** npm and nodejs
** git

== Installation

* link:https://git.korhonen.cc/FunctionalHacker/-/packages/container/hugo-asciidoc-docker-ci/latest[Download Docker image]

* link:https://git.korhonen.cc/FunctionalHacker/korhonen.cc/src/branch/main/.forgejo/workflows/deploy_site.yaml[GitHub/Forgejo/Gitea Actions example usage]. This is how I build and deploy my homepage link://https://korhonen.cc[korhonen.cc].
Initial commit 2024-01-27 21:35:51 +02:00			`= Docker image to build Hugo sites in a CI environment`

			`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`
Remove asciidoctor-html5s script Hugo has a way to to define the backend in the site configuration. See: https://git.korhonen.cc/FunctionalHacker/korhonen.cc/src/branch/main/config/_default/markup.toml 2024-02-03 19:38:19 +02:00			`*** link:https://github.com/jirutka/asciidoctor-html5s[AsciiDoctor html5s backend]`
Initial commit 2024-01-27 21:35:51 +02:00			`** go`
			`** Rouge syntax highlighter`
			`** npm and nodejs`
Add git 2024-01-27 21:49:27 +02:00			`** git`
Add note about installation, add .dockerignore 2024-01-27 21:45:49 +02:00
			`== Installation`

[skip ci] update readme 2024-02-25 12:11:23 +02:00			`* link:https://git.korhonen.cc/FunctionalHacker/-/packages/container/hugo-asciidoc-docker-ci/latest[Download Docker image]`
Add example Actions workflow 2024-02-24 15:31:42 +02:00
[skip ci] update readme 2024-02-25 12:11:23 +02:00			`* link:https://git.korhonen.cc/FunctionalHacker/korhonen.cc/src/branch/main/.forgejo/workflows/deploy_site.yaml[GitHub/Forgejo/Gitea Actions example usage]. This is how I build and deploy my homepage link://https://korhonen.cc[korhonen.cc].`