mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-07 20:30:36 -05:00
parent
ef03c6f954
commit
aecabfcd4f
1 changed files with 48 additions and 0 deletions
48
docs/content/extras/gitinfo.md
Normal file
48
docs/content/extras/gitinfo.md
Normal file
|
@ -0,0 +1,48 @@
|
||||||
|
---
|
||||||
|
aliases:
|
||||||
|
- /doc/gitinfo/
|
||||||
|
lastmod: 2016-12-11
|
||||||
|
date: 2016-12-11
|
||||||
|
menu:
|
||||||
|
main:
|
||||||
|
parent: extras
|
||||||
|
next: /extras/livereload
|
||||||
|
prev: /extras/datadrivencontent
|
||||||
|
title: GitInfo
|
||||||
|
---
|
||||||
|
|
||||||
|
Hugo provides a way to integrate Git data into your site.
|
||||||
|
|
||||||
|
|
||||||
|
## Prerequisites
|
||||||
|
|
||||||
|
1. The Hugo site must be in a Git-enabled directory.
|
||||||
|
1. The Git executable must be installed and in your system `PATH`.
|
||||||
|
|
||||||
|
## 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.
|
||||||
|
|
Loading…
Reference in a new issue