Table of contents

Jekyll-github-metadata

Tags: default , gem-based-plugins , github , github-pages , metadata

"site.github"を提供しGitHub Pagesで使用するためのデフォルト値を設定します

Homepage (github.com) [EN]
Document (rubydoc.info) [EN]
GitHub Metadata (github.com) [EN]

プロジェクト名や説明などの共通のリポジトリ情報は、GitHub Pagesサイトに含まれる jekyll-github-metadataを使ってJekyllサイトに公開されます。

インストール

Gemfileを編集

# Gemfile
group :jekyll_plugins do
  gem 'jekyll-github-metadata'
end

_config.ymlを編集

# _config.yml
plugins:
  - jekyll-github-metadata

Pluginのインストール
```
bundle
```

使い方

リポジトリのメタデータはsite.github名前空間にあるJekyllサイトの設定で公開されます。

以下のキーを参照するには、_config.ymlファイルに存在する他のサイト設定値と同じように、キーの前にsite.githubを付けます。

例えば、プロジェクトの名前をリストアップするには、次のように書きます。

{% for repository in site.github.public_repositories %}
  * [{{ repository.name }}]({{ repository.html_url }})
{% endfor %}

利用可能なリポジトリメタデータ

次のサンプル情報は、site.github名前空間のJekyllテンプレートに公開されます。

{
    "versions": {
        "jekyll": <version>,
        "kramdown": <version>,
        "liquid": <version>,
        "maruku": <version>,
        "rdiscount": <version>,
        "redcarpet": <version>,
        "RedCloth": <version>,
        "jemoji": <version>,
        "jekyll-mentions": <version>,
        "jekyll-redirect-from": <version>,
        "jekyll-sitemap": <version>,
        "github-pages": <version>,
        "ruby": <version>"
    },
    "hostname": "github.com",
    "pages_hostname": "github.io",
    "api_url": "https://api.github.com",
    "help_url": "https://help.github.com",
    "environment": "dotcom",
    "pages_env": "dotcom",
    "public_repositories": [ Repository Objects ],
    "organization_members": [ User Objects ],
    "build_revision": "cbd866ebf142088896cbe71422b949de7f864bce",
    "project_title": "metadata-example",
    "project_tagline": "A GitHub Pages site to showcase repository metadata",
    "owner_name": "github",
    "owner_url": "https://github.com/github",
    "owner_gravatar_url": "https://github.com/github.png",
    "repository_url": "https://github.com/github/metadata-example",
    "repository_nwo": "github/metadata-example",
    "repository_name": "metadata-example",
    "zip_url": "https://github.com/github/metadata-example/zipball/gh-pages",
    "tar_url": "https://github.com/github/metadata-example/tarball/gh-pages",
    "clone_url": "https://github.com/github/metadata-example.git",
    "releases_url": "https://github.com/github/metadata-example/releases",
    "issues_url": "https://github.com/github/metadata-example/issues",
    "wiki_url": "https://github.com/github/metadata-example/wiki",
    "language": null,
    "is_user_page": false,
    "is_project_page": true,
    "show_downloads": true,
    "url": "http://username.github.io/metadata-example", // (or the CNAME)
    "baseurl": "/metadata-example",
    "contributors": [ User Objects ],
    "releases": [ Release Objects ],
    "latest_release": [ Release Object ],
    "private": false,
    "archived": false,
    "disabled": false,
    "license": {
      "key": "mit",
      "name": "MIT License",
      "spdx_id": "MIT",
      "url": "https://api.github.com/licenses/mit"
    },
    "source": {
      "branch": "gh-pages",
      "path": "/"
    }
}

ブログ記事

下記に掲載を希望される方はご連絡ください (詳細)