Introduction

You are display tags list on each post in your github pages website and this is good.

But, usually, you want that those tags will be links to a tag page which will display all the posts
which contains the tag, right?

The problem is that jekyll is a static "language" so you have to generate each page as static file.

Will you do this manually? I don't think so.

How it works?

After the package have been installed, this package modify the package.json and add to it a postcommit script.

This script is reading all the tags in the site and generate a .md file for each of them under /tags folder.

Installation

#### Step 1

``shell
npm install github-pages-tags --save
`

#### Step 2

create a _tag.html_ in _layout_ folder which will be the tag template.
This file should looks like:

`ruby
---
layout: default
---

{{ page.title }} posts


`

#### Step 3 (optinal)

You can custom the plugin behavior by creating ~~github-pages-tags.config.js~~ github-pages-tags.config.json.

Here are the options:

`js
{
// tag page title
"title": "{{tag}}}",
// tag page meta description
"description": "Here are all the posts that related to {{tag}}",
// generate only tag who have more than minPostCount posts. See link below:
"minPostCount": 0
}
`

$3


- {{tag}} will be replaced by the actuall tag name.
- minPostCount` - (Why is good?)