-
Create new posts in
_posts
-
Name the post YYYY-MM-DD-<Name>.md
-
At the top of the file, use the following format. Feel free to omit fields that are not needed.
--- title: "Markup: Text Readability Test" excerpt: "A bunch of text to test readability." categories: - Post Formats tags: - sample post - readability - test ---
-
Upload to repo.
-
Place new pages in
_pages
directory. -
In the newly created .md file, use the following header.
--- title: <page name> layout: collection permalink: /<page name>/ collection: <desired_collection> entries_layout: grid classes: wide ---
-
In
_config.yml
create a new entry under defaults for the newly created page.defaults: # _<page name> - scope: path: "" type: <page name> values: layout: single author_profile: true
-
Update repo.
-
Update the
_config.yml
by adding the following under collections. permalink_ will stay the same as shown here.collections: <collection name>: output: true permalink: /:collection/:path/
-
In
_config.yml
create a new entry under defaults for the newly created page.defaults: # _<collection name> - scope: path: "" type: <collection name> values: layout: single author_profile: false share: true
-
Make a <name>.md file in the
_pages
folder. Place this at the top of the file. Update the appropriate fields to match the name of the new collection.--- title: <collection name> layout: collection permalink: /<collection name>/ collection: <collection name> entries_layout: grid classes: wide ---
-
Create a new directory
_<collection_name>
. -
Add content to the newly created
_<collection_name>
directory.
Post
- Organized reverse chronologically.
- Live in
_posts
directory.
Page
- Documents that don't have a relationship with one another (i.e.
index.html
,aboutme.html
, etc).
Collection
- Used to sort content that aren't dated (like posts), but have a set relationship with one another.