mirror of
https://github.com/gohugoio/hugo.git
synced 2026-09-03 12:12:37 +00:00
Patrick Kollitsch
963ddc994a
I find that Hugo should contain more links to relevant documentation of features in other tools/documentations. Please let me know if we don't want that and I'll stop. In this specific case I read about `.mailmap` in the Hugo docs and as a developer knew what was meant, but I think less dev-y users might not understand this. Instead of starting to add paragraphs about the format maybe it's ok to link to the features docs? As I said, let me know if that is overkill/bloat. It would make my life easier than seeing a word and googling it :) (for instance, if we link to git in this case we don't need to add extra-documentation about what the mailmap file should look like and what should be in there)
1.8 KiB
1.8 KiB
title, linktitle, description, date, publishdate, lastmod, categories, keywords, draft, menu, weight, sections_weight, aliases, toc, wip
| title | linktitle | description | date | publishdate | lastmod | categories | keywords | draft | menu | weight | sections_weight | aliases | toc | wip | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Git Info Variables | Git Variables | Get the last Git revision information for every content file. | 2017-03-12 | 2017-03-12 | 2017-03-12 |
|
|
false |
|
70 | 70 |
|
false | false |
{{% note ".GitInfo Performance Considerations" %}}
Hugo's Git integrations should be fairly performant but can increase your build time. This will depend on the size of your Git history.
{{% /note %}}
.GitInfo Prerequisites
- The Hugo site must be in a Git-enabled directory.
- The Git executable must be installed and in your system
PATH. - The
.GitInfofeature must be enabled in your Hugo project by passing--enableGitInfoflag on the command line or by settingenableGitInfototruein your site's configuration file.
The .GitInfo Object
The GitInfo object contains the following fields:
- .AbbreviatedHash
- the abbreviated commit hash (e.g.,
866cbcc) - .AuthorName
- the author's name, respecting
.mailmap - .AuthorEmail
- the author's email address, respecting
.mailmap - .AuthorDate
- the author date
- .Hash
- the commit hash (e.g.,
866cbccdab588b9908887ffd3b4f2667e94090c3) - .Subject
- commit message subject (e.g.,
tpl: Add custom index function)
.Lastmod
If the .GitInfo feature is enabled, .Lastmod (on Page) is fetched from Git i.e. .GitInfo.AuthorDate. This behaviour can be changed by adding your own front matter configuration for dates.