1.3 KiB
1.3 KiB
| title | permalink | excerpt | sidebar | modified | ||||
|---|---|---|---|---|---|---|---|---|
| Working with Pages | /docs/pages/ |
|
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