{"id":17647782,"url":"https://github.com/moshfeu/github-pages-tags","last_synced_at":"2026-04-05T23:35:14.277Z","repository":{"id":88544711,"uuid":"151286555","full_name":"moshfeu/github-pages-tags","owner":"moshfeu","description":"A package to generate tags views to github pages website","archived":false,"fork":false,"pushed_at":"2018-12-11T21:57:43.000Z","size":29,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-03-26T05:46:43.377Z","etag":null,"topics":["github-pages","jekyll","nodejs","npm","tags","typescript","webpack"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/moshfeu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-10-02T16:25:42.000Z","updated_at":"2018-12-11T21:57:45.000Z","dependencies_parsed_at":"2023-10-25T08:30:15.083Z","dependency_job_id":null,"html_url":"https://github.com/moshfeu/github-pages-tags","commit_stats":{"total_commits":24,"total_committers":1,"mean_commits":24.0,"dds":0.0,"last_synced_commit":"fa2cc88539df0f096eafe498d5fa0b3c33428dae"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moshfeu%2Fgithub-pages-tags","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moshfeu%2Fgithub-pages-tags/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moshfeu%2Fgithub-pages-tags/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moshfeu%2Fgithub-pages-tags/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/moshfeu","download_url":"https://codeload.github.com/moshfeu/github-pages-tags/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246290583,"owners_count":20753724,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["github-pages","jekyll","nodejs","npm","tags","typescript","webpack"],"created_at":"2024-10-23T11:14:33.398Z","updated_at":"2025-12-30T23:17:40.126Z","avatar_url":"https://github.com/moshfeu.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![https://nodei.co/npm/github-pages-tags.png?downloads=true\u0026downloadRank=true\u0026stars=true](https://nodei.co/npm/github-pages-tags.png?downloads=true\u0026downloadRank=true\u0026stars=true)](https://www.npmjs.com/package/github-pages-tags)\n\n\n[![HitCount](https://hits.dwyl.com/moshfeu/github-pages-tags.svg)](https://hits.dwyl.com/dwyl/start-here)\n[![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.com/moshfeu/github-pages-tags/issues)\n\n## Introduction\nYou are display tags list on each post in your github pages website and this is good.\u003cbr /\u003e\nBut, usually, you want that those tags will be links to a tag page which will display all the posts\nwhich contains the tag, right?\u003cbr /\u003e\nThe problem is that `jekyll` is a static \"language\" so you have to generate each page as static file.\u003cbr /\u003e\nWill you do this manually? I don't think so.\n\n## How it works?\n\nAfter the package have been installed, this package modify the `package.json` and add to it a postcommit script.\u003cbr /\u003e\nThis script is reading all the tags in the site and generate a `.md` file for each of them under `/tags` folder.\n\n## Installation\n\n#### Step 1\n\n```shell\nnpm install github-pages-tags --save\n```\n\n#### Step 2\n\ncreate a _tag.html_ in _layout_ folder which will be the tag template.\nThis file should looks like:\n\n```ruby\n---\nlayout: default\n---\n\n\u003ch1\u003e`{{ page.title }}` posts\u003c/h1\u003e\n\n\u003cdiv class=\"view\"\u003e\n  {% for post in site.posts %}\n    {% if post.tags contains page.title %}\n      {% include post-item.html post=post last=forloop.last %}\n    {% endif %}\n  {% endfor %}\n\u003c/div\u003e\n```\n\n#### Step 3 (optinal)\n\nYou can custom the plugin behavior by creating ~~`github-pages-tags.config.js`~~ `github-pages-tags.config.json`.\n\nHere are the options:\n\n```js\n{\n  // tag page title\n  \"title\": \"{{tag}}}\",\n  // tag page meta description\n  \"description\": \"Here are all the posts that related to {{tag}}\",\n  // generate only tag who have more than `minPostCount` posts. See link below:\n  \"minPostCount\": 0\n}\n```\n\n### Notes\n- `{{tag}}` will be replaced by the actuall tag name.\n- `minPostCount` - (\u003ca href=\"https://savyagency.com/tags-and-categories-create-duplicate-content/\" target=\"_blank\"\u003eWhy is good?\u003c/a\u003e)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoshfeu%2Fgithub-pages-tags","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmoshfeu%2Fgithub-pages-tags","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoshfeu%2Fgithub-pages-tags/lists"}