From 774dbbe21af8293401dd7a1df7a9273b0cb5215d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=CE=9C=CE=B1=CE=BA=CE=B1=CF=81=CF=8C=CE=BD=CE=B9=CE=B1=20?= =?UTF-8?q?=CE=BC=CE=B5?= <32320229+makaroniame@users.noreply.github.com> Date: Wed, 30 Aug 2017 05:02:15 +0300 Subject: [PATCH] Clarify taxonomy page and index generation (#1207) Clarify taxonomy page and index generation per https://github.com/mmistakes/minimal-mistakes/issues/811#issuecomment-325769757 --- docs/_docs/05-configuration.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/_docs/05-configuration.md b/docs/_docs/05-configuration.md index 16a2e948aeea..c2f940c6d660 100644 --- a/docs/_docs/05-configuration.md +++ b/docs/_docs/05-configuration.md @@ -588,10 +588,9 @@ tag_archive: Which would create category and tag links in the breadcrumbs and page meta like: `/categories/#foo` and `/tags/#foo`. -**Note:** for these links to resolve properly, category and tag index pages need to exist at [`/categories/index.html`](https://github.com/{{ site.repository }}/blob/master/docs/_pages/category-archive.html) and [`/tags/index.html`](https://github.com/{{ site.repository }}/blob/master/docs/_pages/tag-archive.html). The necessary Liquid code to build these pages can be taken from the demo site. -{: .notice--warning} +**Note:** these are simply hash (fragment) links into the full taxonomy index pages. For them to resolve properly, the category and tag index pages need to exist at [`/categories/index.html`](https://github.com/{{ site.repository }}/blob/master/docs/_pages/category-archive.html) (copy to `_pages/category-archive.html`) and [`/tags/index.html`](https://github.com/{{ site.repository }}/blob/master/docs/_pages/tag-archive.html) (copy to `_pages/tag-archive.html`). {: .notice--warning} -If you have the luxury of using Jekyll Plugins then [**jekyll-archives**][jekyll-archives] will make your life much easier as category and tag pages are created for you. +If you have the luxury of using Jekyll Plugins, then [**jekyll-archives**][jekyll-archives] will create a better experience as discrete taxonomy pages would be generated, and their corresponding links would be "real" (not just hash/fragment links into a larger index). However, the plugin will not generate the taxonomy index pages (`category-archive.html` and `_pages/tag-archive.html`) so you'd still need to manually create them if you'd like to have them (see note above). First, you'll need to make sure that the `jekyll-archives` plugin is installed. Either run `gem install jekyll-archives` or add the following to your `Gemfile`: ```