diff --git a/docs/_docs/05-configuration.md b/docs/_docs/05-configuration.md
index 67e5ca95..4872b41b 100644
--- a/docs/_docs/05-configuration.md
+++ b/docs/_docs/05-configuration.md
@@ -851,10 +851,10 @@ tag_archive:
Which would create category and tag links in the breadcrumbs and page meta like: `/categories/#foo` and `/tags/#foo`.
-**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`).
+**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.md) (copy to `_pages/category-archive.md`) and [`/tags/index.html`](https://github.com/{{ site.repository }}/blob/master/docs/_pages/tag-archive.md) (copy to `_pages/tag-archive.md`).
{: .notice--warning}
-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).
+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.md` and `tag-archive.md`) 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`:
diff --git a/docs/_docs/10-layouts.md b/docs/_docs/10-layouts.md
index cbaaf320..8a7259f6 100644
--- a/docs/_docs/10-layouts.md
+++ b/docs/_docs/10-layouts.md
@@ -142,11 +142,11 @@ Below are sample archive pages you can easily drop into your project, taking car
* [All Posts Grouped by Collection -- List View][posts-collection]
* [Portfolio Collection -- Grid View][portfolio-collection]
-[posts-categories]: https://github.com/{{ site.repository }}/blob/master/docs/_pages/category-archive.html
-[posts-tags]: https://github.com/{{ site.repository }}/blob/master/docs/_pages/tag-archive.html
-[posts-year]: https://github.com/{{ site.repository }}/blob/master/docs/_pages/year-archive.html
+[posts-categories]: https://github.com/{{ site.repository }}/blob/master/docs/_pages/category-archive.md
+[posts-tags]: https://github.com/{{ site.repository }}/blob/master/docs/_pages/tag-archive.md
+[posts-year]: https://github.com/{{ site.repository }}/blob/master/docs/_pages/year-archive.md
[posts-collection]: https://github.com/{{ site.repository }}/blob/master/docs/_pages/collection-archive.html
-[portfolio-collection]: https://github.com/{{ site.repository }}/blob/master/docs/_pages/portfolio-archive.html
+[portfolio-collection]: https://github.com/{{ site.repository }}/blob/master/docs/_pages/portfolio-archive.md
Post and page excerpts are auto-generated by Jekyll which grabs the first paragraph of text. To override this text with something more specific use the following YAML Front Matter:
@@ -158,34 +158,18 @@ excerpt: "A unique line of text to describe this post that will display in an ar
Adding `type=grid` to the `archive-single` helper will display archive posts in a 4 column grid. For example to create an archive displaying all documents in the portfolio collection:
-**Step 1:** Create a portfolio archive page (eg. `_pages/portfolio-archive.html`) with the following YAML Front Matter:
+Create a portfolio archive page (eg. `_pages/portfolio-archive.md`) with the following YAML Front Matter:
```yaml
---
-layout: archive
-title: "Portfolio"
+title: Portfolio
+layout: collection
permalink: /portfolio/
-author_profile: false
+collection: portfolio
+entries_layout: grid
---
```
-**Step 2:** Loop over all documents in the portfolio collection and output in a grid:
-
-```html
-{% raw %}
- {% for post in site.portfolio %}
- {% include archive-single.html type="grid" %}
- {% endfor %}{% endraw %}
-
-```
-
-To produce something like this:
-
-
-
Teaser images are assigned similar to header images using the following YAML Front Matter:
```yaml
@@ -202,32 +186,22 @@ If you have the luxury of using Jekyll plugins, the creation of category and tag
![archive taxonomy layout example]({{ "/assets/images/mm-layout-archive-taxonomy.png" | absolute_url }})
-If you're not using the `jekyll-archives` plugin then you need to create archive pages yourself. Sample taxonomy archives can be found by grabbing the HTML sources below and adding to your site.
+If you're not using the `jekyll-archives` plugin then you need to create archive pages yourself. Sample taxonomy archives can be found by grabbing the Markdown sources below and adding to your site.
| Name | HTML Source |
| -------------------- | --- |
-| [Categories Archive](https://mmistakes.github.io/minimal-mistakes/categories/) | [category-archive.html](https://github.com/mmistakes/minimal-mistakes/blob/master/docs/_pages/category-archive.html) |
-| [Tags Archive](https://mmistakes.github.io/minimal-mistakes/tags/) | [tag-archive.html](https://github.com/mmistakes/minimal-mistakes/blob/master/docs/_pages/tag-archive.html) |
+| [Categories Archive](https://mmistakes.github.io/minimal-mistakes/categories/) | [category-archive.md](https://github.com/mmistakes/minimal-mistakes/blob/master/docs/_pages/category-archive.md) |
+| [Tags Archive](https://mmistakes.github.io/minimal-mistakes/tags/) | [tag-archive.md](https://github.com/mmistakes/minimal-mistakes/blob/master/docs/_pages/tag-archive.md) |
The **Tags Archive** page that responds to urls such as `/tags/#tips` looks something like this:
```html
---
-layout: archive
-permalink: /tags/
title: "Posts by Tag"
+layout: tags
+permalink: /tags/
author_profile: true
---
-
-{% raw %}{% include group-by-array collection=site.posts field="tags" %}
-
-{% for tag in group_names %}
- {% assign posts = group_items[forloop.index0] %}
-
{{ tag }}
- {% for post in posts %}
- {% include archive-single.html %}
- {% endfor %}
-{% endfor %}{% endraw %}
```
## Home Page Layout
diff --git a/docs/_docs/14-helpers.md b/docs/_docs/14-helpers.md
index 369e5b52..252ac198 100644
--- a/docs/_docs/14-helpers.md
+++ b/docs/_docs/14-helpers.md
@@ -53,18 +53,6 @@ Instead of repeating `{% raw %}{{ site.url }}{{ site.baseurl }}{% endraw %}` ove
A liquid include file for Jekyll that allows an object to be grouped by an array.
-The Liquid based taxonomy archives found amongst the demo pages rely on this helper.
-
-| Description | | |
-| ----------- | ------------------------ | --------------------------- |
-| All posts grouped by category | [Source][category-array] | [Demo][category-array-demo] |
-| All posts grouped by tag | [Source][tag-array] | [Demo][tag-array-demo] |
-
-[category-array]: https://github.com/{{ site.repository }}/blob/master/docs/_pages/category-archive.html
-[category-array-demo]: {{ "/categories/" | absolute_url }}
-[tag-array]: https://github.com/{{ site.repository }}/blob/master/docs/_pages/tag-archive.html
-[tag-array-demo]: {{ "/tags/" | absolute_url }}
-
## Figure
Generate a `