Hugo provides a way to integrate Git data into your site.
Prerequisites
- The Hugo site must be in a Git-enabled directory.
- The Git executable must be installed and in your system
PATH. - Enable the GitInfo feature in Hugo by using
--enableGitInfoon the command line or by settingenableGitInfototruein your site configuration.
The GitInfo Object
The GitInfo object contains the following fields:
- AbbreviatedHash
- abbreviated commit hash, e.g.
866cbcc - AuthorName
- author name, respecting
.mailmap - AuthorEmail
- author email address, respecting
.mailmap - AuthorDate
- the author date
- Hash
- commit hash, e.g.
866cbccdab588b9908887ffd3b4f2667e94090c3 - Subject
- commit message subject, e.g.
tpl: Add custom index function
Performance Considerations
The Git integrations should be fairly performant, but it does add some time to the build, which depends somewhat on the Git history size.