Move gh-pages branch files into /docs and add test files
- 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
This commit is contained in:
43
docs/_docs/12-pages.md
Normal file
43
docs/_docs/12-pages.md
Normal file
@@ -0,0 +1,43 @@
|
||||
---
|
||||
title: "Working with Pages"
|
||||
permalink: /docs/pages/
|
||||
excerpt: "Suggestions and Front Matter defaults for working with pages."
|
||||
modified: 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.
|
||||
|
||||
```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
|
||||
```
|
||||
Reference in New Issue
Block a user