Skip to content

Latest commit

 

History

History
43 lines (34 loc) · 1.35 KB

12-pages.md

File metadata and controls

43 lines (34 loc) · 1.35 KB
Raw
title permalink excerpt last_modified_at
Working with Pages
/docs/pages/
Suggestions and Front Matter defaults for working with pages.
2016-11-03 11:13:12 -0400

To better organize all of your pages you can centralize them into a single location similar to posts and collections.

Step 1: Start by placing pages (.md or .html files) into a _pages directory. Meaningfully naming files should be the goal. Avoid patterns like /about/index.md as it makes distinguishing between multiple index.md files harder.

sample-project
└── _pages/
    ├── 404.md               # custom 404 page
    ├── about.md             # about page
    └── contact.md           # contact page

Step 2: Include pages to be sure Jekyll "sees" and processes the files inside of _pages. Add include: ["_pages"] to _config.yml.

Step 3: Assign permalink overrides in the YAML Front Matter of each.

Examples:

filename permalink
_pages/about.md permalink: /about/
_pages/home.md permalink: /
_pages/contact.md permalink: /contact/

Recommended Front Matter Defaults:

defaults:
  # _pages
  - scope:
      path: ""
      type: pages
    values:
      layout: single
      author_profile: true