hacks-guide-minimal-mistake.../_docs/11-pages.md
2016-04-13 22:38:28 -04:00

1.3 KiB

title permalink excerpt sidebar modified
Working with Pages /docs/pages/
title nav
v3.0 docs
2016-04-13T15:54:02-04:00

{% include base_path %}

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