Expose Git metadata to Jekyll.
MIT License
Expose Git metadata to Jekyll. Just like how Github exposes repository metadata, this plugin will expose information about your git repository for your templates. For example:
{{site.git.total_commits}} # => Will return the total number of commits for your Jekyll repository
Add to your Gemfile
:
gem 'jekyll-git_metadata'
Add to your _config.yml
:
gems:
- jekyll-git_metadata
This plugin adds a hash of git information to the site
and page
variables. The hash looks something like this:
{"authors"=>
[
{"commits"=>2, "name"=>"Ivan Tse", "email"=>"[email protected]"},
{"commits"=>5, "name"=>"John Smith", "email"=>"[email protected]"}
],
"total_commits"=>7,
"total_additions"=>57,
"total_subtractions"=>22,
"first_commit"=>
{"short_sha"=>"d15cbe8",
"long_sha"=>"d15cbe8d0f4d4db9efda7a3daabbe966c21f3848",
"author_name"=>"John Smith",
"author_email"=>"[email protected]",
"author_date"=>"Thu Jan 16 23:36:00 2014 -0500",
"commit_name"=>"John Smith",
"commit_email"=>"[email protected]",
"commit_date"=>"Thu Jan 16 23:36:00 2014 -0500",
"message"=>"A commit!"},
"last_commit"=>
{"short_sha"=>"f88ca3b",
"long_sha"=>"f88ca3bff630efb6cdb356fad3d640534b109572",
"author_name"=>"Ivan Tse",
"author_email"=>"[email protected]",
"author_date"=>"Mon Jul 14 04:04:47 2014 -0400",
"commit_name"=>"John Smith",
"commit_email"=>"[email protected]",
"commit_date"=>"Mon Jul 14 04:04:47 2014 -0400",
"message"=>"Fix some stuff"}}
To access this hash, use either page.git
or site.git
. page.git
contains the git information about that particuliar page/file. site.git
contains the git information for the entire git repository. site.git
also includes total_files
and project_name
variables.
git checkout -b my-new-feature
)git commit -am 'Add some feature'
)git push origin my-new-feature
)Suggestions for more git metadata are welcomed!