mirror of
https://github.com/McShelby/hugo-theme-relearn
synced 2025-05-01 03:13:36 +08:00
40 lines
1.7 KiB
Markdown
40 lines
1.7 KiB
Markdown
+++
|
|
categories = ['explanation']
|
|
description = "Your site's directory structure"
|
|
title = 'Directory Structure'
|
|
weight = 1
|
|
+++
|
|
|
|
If you've followed the [Getting Started](introduction/quickstart) guide, your directory layout will look similar to this:
|
|
|
|
````tree
|
|
- content | folder
|
|
- log | folder
|
|
- first-day | folder
|
|
- _index.md | fa-fw fab fa-markdown | secondary
|
|
- second-day | folder
|
|
- index.md | fa-fw fab fa-markdown | secondary
|
|
- third-day.md | fa-fw fab fa-markdown | secondary
|
|
- _index.md | fa-fw fab fa-markdown | secondary
|
|
- _index.md | fa-fw fab fa-markdown | secondary
|
|
- themes | folder
|
|
- hugo-theme-relearn | folder
|
|
- ... | folder
|
|
- hugo.toml | file-alt | accent
|
|
````
|
|
|
|
Hugo uses a [union file system](https://gohugo.io/getting-started/directory-structure/#union-file-system), which lets you combine multiple directories.
|
|
|
|
By default, it puts your root directory on top of the Relearn theme directory. Files in your root directory will replace theme files in the same location.
|
|
|
|
For example, if you create a file at `layouts/partials/heading.html`, it will override the theme's `themes/hugo-theme-relearn/layouts/partials/heading.html`.
|
|
|
|
[See this list](configuration/customization/partials), to learn which files are allowed to be overridden by you.
|
|
|
|
This makes it easy to customize the theme without changing files in the `themes` directory, making future theme updates simpler.
|
|
|
|
> [!WARNING]
|
|
> Don't edit files inside the `themes/hugo-theme-relearn` directory. That's not the recommended way to customize! Refer to the explanation above.
|
|
>
|
|
> Don't clone the theme repository and edit files there for your site. That's not the recommended way to customize! Instead, follow the [Getting Started](introduction/quickstart) guide.
|