Working with Collections

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

The theme has been built with collections in mind and you will find several examples on the demo site (portfolio, blog-grid, portflio-grid-v1), etc.


A popular use case for collections is to build a portfolio section as part of one’s 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: "portfolio-details"

Now make a portfolio.md file in the ‘_pages’ folder.

---
title: Material Exploration
image: "/assets/images/portfolio/portfolio_img_1.jpg"
image_alt: "image_not_found"
list:
  - category: "Abstract"
    link: "#!"
  - category: "Ideation"
    link: "#!"
---

And then create portfolio content like _portfolio/2019-01-01-material-exploration.md.

Working with portfolio

This theme has a versatile portfolio that can be portfolio 1 to 4 versions. By default the portfolio is set in the _layouts/portfolio.html

It can be included as

{% include portfolio/portfolio-1.html %}