hacks-guide-minimal-mistake.../_docs/11-pages.md
2016-04-13 17:10:01 -04:00

48 lines
No EOL
1.3 KiB
Markdown

---
title: "Working with Pages"
permalink: /docs/pages/
excerpt:
sidebar:
title: "v3.0"
nav: docs
modified: 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.
```bash
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:**
```yaml
defaults:
# _pages
- scope:
path: ""
type: pages
values:
layout: single
author_profile: true
```