Collections like posts and pages work as you'd expect. If you're new to them be sure to read [Jekyll's documentation](https://jekyllrb.com/docs/collections/).
The theme has been built with collections in mind and you will find [several examples](https://igards.github.io/collection-archive/) on the demo site ([portfolio](https://igards.github.io/portfolio/), [recipes](https://igards.github.io/recipes/), pets).
**Collections in the Wild:** This set of documentation is also [built as a collection](https://github.com/igards/igards.github.io/blob/gh-pages/_docs/) if you're looking for a fully fleshed out example to inspect.
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`.
These settings essentially say output `index.html` files for each portfolio document in `_portfolio` at `_site/portfolio//`.
Just like posts and pages you'll probably want to set some defaults for the Front Matter:
And then create portfolio content like [`_portfolio/foo-bar-website.md`](https://github.com/igards/igards.github.io/blob/gh-pages/_portfolio/foo-bar-website.md), to end up with something like this.
![portfolio collection example](https://igards.github.io/images/mm-portfolio-collection-example.jpg)