---
layout: post
title: a post with github metadata
date: 2020-09-28 21:01:00
description: a quick run down on accessing github metadata.
tags: metadata
categories: sample-posts external-services
---

A sample blog page that demonstrates the accessing of github meta data.

## What does Github-MetaData do?

- Propagates the site.github namespace with repository metadata
- Setting site variables :
  - site.title
  - site.description
  - site.url
  - site.baseurl
- Accessing the metadata - duh.
- Generating edittable links.

## Additional Reading

- If you're recieving incorrect/missing data, you may need to perform a Github API<a href="https://github.com/jekyll/github-metadata/blob/master/docs/authentication.md"> authentication</a>.
- Go through this <a href="https://jekyll.github.io/github-metadata/">README</a> for more details on the topic.
- <a href= "https://github.com/jekyll/github-metadata/blob/master/docs/site.github.md">This page</a> highlights all the feilds you can access with github-metadata.
  <br />

## Example MetaData

- Host Name : {{ site.github.hostname }}
- URL : {{ site.github.url }}
- BaseURL : {{ site.github.baseurl }}
- Archived : {{ site.github.archived}}
- Contributors :
  {% for contributor in site.github.contributors %}
  - {{ contributor.login }}
    {% endfor %}