spress/github-metadata-plugin

Github metadata of a repository

v2.0.0 2016-01-02 12:14 UTC

This package is auto-updated.

Last update: 2024-11-13 04:27:00 UTC


README

Spress 2 ready

Access to site.github for getting a repository's metadata.

Requires:

  • Spress >=2.0.0
  • PHP cURL extension.

If you are using Spress 1.x, go to 1.0.0 version of the plugin.

How to install?

Go to your site folder and input the following command:

spress add:plugin spress/github-metadata-plugin

How to use?

Add the following to your config.yml:

#Your repository name:
repository: "spress/spress"

#### Access to repository's metadada

  • Stargazers count: site.github.stargazers_count.
  • Watchers count: site.gihub.watchers_count.
  • Forks count: site.github.forks_count.

See Github repos API.

Another metadata keys:

  • name
  • full_name
  • description
  • fork
  • html_url
  • clone_url
  • git_url
  • ssh_url
  • mirror_url
  • homepage
  • size
  • default_branch
  • open_issues_count
  • has_issues
  • has_pages
  • has_downloads
  • pushed_at
  • created_at
  • updated_at
Contributors metadata

Access to site.github.contributors for getting an array with contributors metadata.

See Github repos API.

  • login
  • avatar_url
  • html_url
  • type
  • contributions
Owner metada

Access to site.github.owner for getting owner metadata.

  • login
  • avatar_url
  • gravatar_id
  • html_url
Organization metadata

Access to site.github.organization for getting organization metadata.

  • login
  • avatar_url
  • html_url
Source metadata

Access to site.github.source for getting source metadata.

  • name
  • full_name
  • description
  • html_url
  • clone_url
  • git_url
  • ssh_url
  • svn_url
  • mirror_url
  • homepage
  • forks_count
  • stargazers_count
  • watchers_count
  • size
  • default_branch
  • open_issues_count
  • has_issues
  • has_wiki
  • has_pages
  • has_downloads
  • pushed_at
  • created_at
  • updated_at

License

This plugin is available as open source under the terms of the MIT License.