57a4324fa0
- Jekyll ignore `/docs` and `/test` folders when using from root
- Update Staticman config to point to correct branch and data file location
- Replace `{{ base_path }}` references with `absolute_url` filter
- Update documentation
1.3 KiB
1.3 KiB
| title | permalink | excerpt | modified |
|---|---|---|---|
| Working with Pages | /docs/pages/ | Suggestions and Front Matter defaults for working with pages. | 2016-11-03T11:13:12-04:00 |
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