hugo-theme-relearn/exampleSite/content/cont/pages/index.en.md

53 lines
2.5 KiB
Markdown
Raw Normal View History

+++
title = "Pages organization"
2022-08-05 21:53:30 +00:00
weight = 1
+++
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.
## 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.
````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, its your “folder home page”
{{% /notice %}}
2017-08-20 15:10:29 +00:00
## Create your project
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.
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
````
2023-10-24 20:49:34 +00:00
The Relearn theme provides [archetypes](cont/archetypes) to help you create this kind of pages.