Blog

0008: ADRs as Hugo Content

Context

Decision

Use adrs/ as Hugo content via module mounts

Update theme/hugo.toml menu

Add _index.md to theme/content/adrs/ because this is part of the theme

Configure modules

+[module]
+  [[module.mounts]]
+    includeFiles = ['[0-9][0-9][0-9][0-9]-*.md']
+    source = 'content/adrs'
+    target = 'content/adrs'
+
+  [[module.mounts]]
+    source = 'content'
+    target = 'content'

https://discourse.gohugo.io/t/solved-how-do-i-add-module-mounts-to-hugo-toml-config-in-a-theme/46489 https://gohugo.io/configuration/module/#default-mounts

Adding a new mount to a target root will cause the existing default mount for that root to be ignored. If you still need the default mount, you must explicitly add it along with the new mount.

Alternatives

Symlinks https://github.com/gohugoio/hugo/issues/5927

Consequences

Resources