Create a new collection

A collection is like a folder that contains a group of pages. A page is like a file in your Github repository.

A collection can only exist when there is a page inside. So you must create a page in a collection.

On Github, a collection is a folder

Step 1 Create a file, which will represent a page on your site.

Step 2 Specify the folder name

A folder for a collection should always start with underscore (_). Replace spaces between words with dashes (-).

Always keep all file and folder names in small caps

Step 3 Add a forward slash to fix the folder name and set a file name.

A file name usually corresponds to your page name for easy reference.

By typing the forward slash, you're fixing the file path of the folder

Step 4 Specify the title and permalink of the page

Things to note:

  1. You should enclose the title and permalink inside three dashes ---

  2. Permalink should not have any spaces in between.

  3. If you're creating a page inside a collection, you should specify in the permalink that the page is inside the folder. For example, for a page named My page inside a folder called My New Folder, the permalink will look like this /my-new-folder/my-page/

---
title: New Page
permalink: /my-new-folder/my-page/
---

Step 5 Scroll to the bottom and click commit at the bottom of the page to save the file.