Sponsors

Support this project by becoming a sponsor. Your logo will show up in this README with a link to your website. Become a sponsor!

Contributors

This project exists thanks to all the people who contribute.

Backers

Thank you to all our backers! 🙏 Become a backer

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

robert 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 Gemfile like this:

gem "robert-github-metadata"

Add it to your _config.yml:

plugins:
  - "robert-github-metadata"

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

Then go ahead and run bundle install.

Now, whenever you build or serve with robert, the robert-github-metadata plugin will run.

Further reading

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