GitHub Metadata, a.k.a. site.github

Jekyll plugin to propagate the site.github namespace and set default values for use with GitHub Pages.

What it does

• Propagates the site.github namespace with repository metadata
• Sets site.title as the repository name, if none is set
• Sets site.description as the repository tagline if none is set
• Sets site.url as the GitHub Pages domain (cname or user domain), if none is set
• Sets site.baseurl as the project name for project pages if none is set

Usage

Usage of this gem is pretty straight-forward. Add it to your bundle like this:

gem "jekyll-github-metadata"

Now add it to your _config.yml:

plugins:
  - "jekyll-github-metadata"

⚠️ If you are using Jekyll < 3.5.0 use the gems key instead of plugins.

Then go ahead and run bundle install. Once you've done that jekyll-github-metadata will run when you run Jekyll.

Further reading

• Authentication
• Configuration
• Using site.github
• Edit on GitHub link