nishiki/hugo-theme-relearn
1
0
Fork 0
mirror of https://github.com/McShelby/hugo-theme-relearn.git synced 2025-05-28 12:34:04 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

tree: make more robust, change separator

Browse source
This commit is contained in:
Sören Weber 2025-03-24 15:04:52 +01:00
parent c062fd1ed2
commit c5d591c514
No known key found for this signature in database
GPG key ID: BEC6D55545451B6D
9 changed files with 191 additions and 179 deletions
docs/content/configuration
sidebar/menus
_index.en.md
sitemanagement
multilingual
_index.en.md
structure
_index.en.md

42
docs/content/configuration/sidebar/menus/_index.en.md
View file

@ -327,18 +327,18 @@ For both sections, the default `shortcuts` Hugo menu should be displayed as if [
Directory structure:
````tree
- content::folder
- log::folder
- first-day.md::fa-fw fab fa-markdown::secondary
- second-day.md::fa-fw fab fa-markdown::secondary
- third-day.md::fa-fw fab fa-markdown::secondary
- _index.md::fa-fw fab fa-markdown::secondary
- ship::folder
- cargo.md::fa-fw fab fa-markdown::secondary
- midst.md::fa-fw fab fa-markdown::secondary
- upper.md::fa-fw fab fa-markdown::secondary
- _index.md::fa-fw fab fa-markdown::secondary
- _index.md::fa-fw fab fa-markdown::secondary
- content | folder
- log | folder
- first-day.md | fa-fw fab fa-markdown | secondary
- second-day.md | fa-fw fab fa-markdown | secondary
- third-day.md | fa-fw fab fa-markdown | secondary
- _index.md | fa-fw fab fa-markdown | secondary
- ship | folder
- cargo.md | fa-fw fab fa-markdown | secondary
- midst.md | fa-fw fab fa-markdown | secondary
- upper.md | fa-fw fab fa-markdown | secondary
- _index.md | fa-fw fab fa-markdown | secondary
- _index.md | fa-fw fab fa-markdown | secondary
````
{{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} {{% badge style="green" icon="fa-fw fab fa-markdown" title=" " %}}Front Matter{{% /badge %}} Using [Hugo's cascade feature](https://gohugo.io/content-management/front-matter/#cascade), we can redefine the menus once in `log/_index.md` and `ship/_index.md` setting `sidebarmenus` so they will be used in all children pages.
@ -372,15 +372,15 @@ You may have the need to add arbitrary links at some point in your menu that sho
Assume the following structure
````tree
- content::folder
- log::folder
- first-day.md::fa-fw fab fa-markdown::secondary
- second-day.md::fa-fw fab fa-markdown::secondary
- third-day.md::fa-fw fab fa-markdown::secondary
- _index.md::fa-fw fab fa-markdown::secondary
- burning-sail-incident.md::fa-fw fab fa-markdown::secondary
- kraken-incident.md::fa-fw fab fa-markdown::secondary
- _index.md::fa-fw fab fa-markdown::secondary
- content | folder
- log | folder
- first-day.md | fa-fw fab fa-markdown | secondary
- second-day.md | fa-fw fab fa-markdown | secondary
- third-day.md | fa-fw fab fa-markdown | secondary
- _index.md | fa-fw fab fa-markdown | secondary
- burning-sail-incident.md | fa-fw fab fa-markdown | secondary
- kraken-incident.md | fa-fw fab fa-markdown | secondary
- _index.md | fa-fw fab fa-markdown | secondary
````
You now want to add a top level menu entry that points to `third-day` as separate `crows-nest-incident`.

82
docs/content/configuration/sitemanagement/multilingual/_index.en.md
View file

@ -65,24 +65,24 @@ Here's how to make your site multilingual using [translations by file name](http
2. Duplicate your content files and add language codes to their file names:
````tree
- content::folder
- log::folder
- first-day::folder
- _index.en.md::fa-fw fab fa-markdown::secondary
- _index.pir.md::fa-fw fab fa-markdown::secondary
- second-day::folder
- index.en.md::fa-fw fab fa-markdown::secondary
- index.pir.md::fa-fw fab fa-markdown::secondary
- third-day.en.md::fa-fw fab fa-markdown::secondary
- third-day.pir.md::fa-fw fab fa-markdown::secondary
- _index.en.md::fa-fw fab fa-markdown::secondary
- _index.pir.md::fa-fw fab fa-markdown::secondary
- _index.en.md::fa-fw fab fa-markdown::secondary
- _index.pir.md::fa-fw fab fa-markdown::secondary
- themes::folder
- hugo-theme-relearn::folder
- ...::folder
- hugo.toml::file-alt::accent
- content | folder
- log | folder
- first-day | folder
- _index.en.md | fa-fw fab fa-markdown | secondary
- _index.pir.md | fa-fw fab fa-markdown | secondary
- second-day | folder
- index.en.md | fa-fw fab fa-markdown | secondary
- index.pir.md | fa-fw fab fa-markdown | secondary
- third-day.en.md | fa-fw fab fa-markdown | secondary
- third-day.pir.md | fa-fw fab fa-markdown | secondary
- _index.en.md | fa-fw fab fa-markdown | secondary
- _index.pir.md | fa-fw fab fa-markdown | secondary
- _index.en.md | fa-fw fab fa-markdown | secondary
- _index.pir.md | fa-fw fab fa-markdown | secondary
- themes | folder
- hugo-theme-relearn | folder
- ... | folder
- hugo.toml | file-alt | accent
````
## Translation by Content Directory
@ -114,29 +114,29 @@ The theme also support [translations by content directory](https://gohugo.io/con
2. Duplicate your content files into separate directories named by their language code:
````tree
- content::folder
- en::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
- pir::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
- content | folder
- en | 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
- pir | 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
````

26
docs/content/configuration/sitemanagement/structure/_index.en.md
View file

@ -8,19 +8,19 @@ 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
- 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.