2021-08-25 11:33:29 +00:00
+++
title = "Pages organization"
2022-08-05 21:53:30 +00:00
weight = 1
2021-08-25 11:33:29 +00:00
+++
2017-07-30 16:02:07 +00:00
2017-08-20 15:10:29 +00:00
In **Hugo** , pages are the core of your site. Once it is configured, pages are definitely the added value to your documentation site.
2017-07-30 16:02:07 +00:00
## Folders
2023-06-09 22:14:46 +00:00
Organize your site like [any other Hugo project ](https://gohugo.io/content/organization/ ). Typically, you will have a _content_ folder with all your pages.
2017-07-30 16:02:07 +00:00
2021-08-23 22:25:15 +00:00
````plaintext
content
├── level-one
│ ├── level-two
│ │ ├── level-three
│ │ │ ├── level-four
│ │ │ │ ├── _index.md < -- / level-one / level-two / level-three / level-four
│ │ │ │ ├── page-4-a.md < -- / level-one / level-two / level-three / level-four / page-4-a
│ │ │ │ ├── page-4-b.md < -- / level-one / level-two / level-three / level-four / page-4-b
│ │ │ │ └── page-4-c.md < -- / level-one / level-two / level-three / level-four / page-4-c
│ │ │ ├── _index.md < -- / level-one / level-two / level-three
│ │ │ ├── page-3-a.md < -- / level-one / level-two / level-three / page-3-a
│ │ │ ├── page-3-b.md < -- / level-one / level-two / level-three / page-3-b
│ │ │ └── page-3-c.md < -- / level-one / level-two / level-three / page-3-c
│ │ ├── _index.md < -- / level-one / level-two
│ │ ├── page-2-a.md < -- / level-one / level-two / page-2-a
│ │ ├── page-2-b.md < -- / level-one / level-two / page-2-b
│ │ └── page-2-c.md < -- / level-one / level-two / page-2-c
│ ├── _index.md < -- / level-one
│ ├── page-1-a.md < -- / level-one / page-1-a
│ ├── page-1-b.md < -- / level-one / page-1-b
│ └── page-1-c.md < -- / level-one / page-1-c
├── _index.md < -- /
└── page-top.md < -- / page-top
````
2017-08-20 15:10:29 +00:00
{{% notice note %}}
`_index.md` is required in each folder, it’ s your “folder home page”
2017-07-30 16:02:07 +00:00
{{% /notice %}}
2017-08-20 15:10:29 +00:00
## Create your project
2017-07-30 16:02:07 +00:00
2022-07-04 22:19:27 +00:00
The following steps are here to help you initialize your new website. If you don't know Hugo at all, we strongly suggest you to train by following [great documentation for beginners ](https://gohugo.io/overview/quickstart/ ).
2017-08-20 15:10:29 +00:00
Hugo provides a `new` command to create a new website.
2017-07-30 16:02:07 +00:00
2024-03-02 10:04:52 +00:00
````shell
2017-08-20 15:10:29 +00:00
hugo new site < new_project >
2024-03-02 10:04:52 +00:00
````
2017-07-30 16:02:07 +00:00
2023-10-24 20:49:34 +00:00
The Relearn theme provides [archetypes ](cont/archetypes ) to help you create this kind of pages.