Docs: Clarify organizing pages into subfolders (#7896)

Merge pull request 7896
This commit is contained in:
Damien St Pierre 2019-11-12 18:47:27 +11:00 committed by jekyllbot
parent 6cee92229c
commit e1b3d07b7e
1 changed files with 10 additions and 1 deletions

View File

@ -20,7 +20,16 @@ and associated URLs might look like:
└── contact.html # => http://example.com/contact.html
```
If you have a lot of pages, you can organize them into subfolders. The same subfolders that are used to group your pages in our project's source will exist in the `_site` folder when your site builds.
If you have a lot of pages, you can organize them into subfolders. The same subfolders that are used to group your pages in your project's source will then exist in the `_site` folder when your site builds. However, when a page has a *different* permalink set in the front matter, the subfolder at `_site` changes accordingly.
```sh
.
|-- about.md # => http://example.com/about.html
|-- documentation # folder containing pages
└── doc1.md # => http://example.com/documentation/doc1.html
|-- design # folder containing pages
└── draft.md # => http://example.com/design/draft.html
```
## Changing the output URL