hacks-guide-minimal-mistake.../_docs/12-collections.md
2016-04-12 16:48:27 -04:00

1.4 KiB

title permalink excerpt sidebar
Working with Collections /docs/collections/
title nav
v3.0 docs

{% include base_path %}

Collections like posts and pages work as you'd expect. If you're new to them be sure to read Jekyll's documentation.

Minimal Mistakes has been built with collections in mind and you will find [several examples]({{ base_path }}/collection-archive/) on the demo site (portfolio, recipes, pets).


A popular use case for collections is to build a portfolio section as part of a personal site. Let's quickly walk through the steps to do that.

Step 1: Configure the portfolio collection by adding the following to _config.yml.

collections:
  portfolio:
    output: true
    permalink: /:collection/:path/

These settings essentially say output index.html files for each portfolio document in _portfolio at _site/portfolio/<document-filename>/.

Just like posts and pages you'll probably want to set some defaults for the Front Matter:

defaults:
  # _portfolio
  - scope:
      path: ""
      type: portfolio
    values:
      layout: single
      author_profile: false
      share: true

And then create portfolio content like [_portfolio/foo-bar-website.md]({{ site.gh_repo }}/gh-pages/_portfolio/foo-bar-website.md), to end up with something like this.

![portfolio collection example]({{ base_path }}/images/mm-portfolio-collection-example.jpg)