Hugo Module Mounts

What problem does it solve?

Hugo sites often need content from multiple repositories or subdirectories. This skill provides a pattern to mount multiple directories into Hugo's content tree, creating a unified, symlink-free filesystem view for a single site.

Core Features & Use Cases

• Multi-directory content aggregation using Hugo's module mounts ([[module.mounts]]).
• Replaces default mounts by mapping standard directories (content, static, layouts, data, assets, i18n, archetypes) and custom mounts.
• Examples: monorepos with per-plugin/docs, per-service/docs, or tools/docs, resulting in a cohesive site without duplicating files.

Quick Start

Create or update hugo.toml with module.mounts entries that map source directories to targets, ensure parent sections have _index.md, and start the Hugo server to verify a unified multi-directory site.