Add a section

[bluefander]

Sorry, another question.

I would like to add a section.
What I did:

- name: "Work"
      identifier: gallery
      url: "/#work"
      weight: 2
    - name: "Music"
      identifier: music
      url: "/#music"
      weight: 3
    - name: "Blog"
      identifier: blog
      url: "/#blog"
      weight: 4

I added a new section called Music in the config.yaml
I made a _music.scss file in assets/sass which is basically a copy of the _about.scss and replaced .about in the beginning of the file with .music.
I wrote "@import "music";" in main.scss
I created a folder "music" in the content folder and created a file music.md with some basic text.

I can see a section called "MUSIC" in the navbar, but I can't see the text I wrote in music.md.

What am I missing?

[kdevo]

Hi,

Adding custom sections is currently not documented (but it's planned, there is a placeholder for that 😄). The gist of it is to attach the menu to your content file:

---
title: "Music"
menu:
  main:
    identifier: "music"
    url: "/#music"
    weight: 3
---

My music...

No other adjustments are typically needed. Styling this section can be accomplished via .default class or #music selector in CSS.

If you want more control over the HTML structure of the section, you can create a partial located at partials/sections/music.html. This would be loaded automatically instead of the fallback partials/sections/default.html which is used when no music.html is found.

In a future release, I'll implement "sideloading" the content by simply placing a music.md file in the content directory so that the menu can still be maintained completely independently in config.yaml.

[bluefander]

In the end it's logical that it doesn't work like this for my music.md file since this

Menu:
  Main:
    - name: "Music"
      identifier: "music" 
      url: "/#music"
      weight: 2

would refer to a #music.md file in the content folder. I just would like the urls to be consistent on the whole website.

[bluefander]

Hi @kdevo

Are there any plans to make this work somewhat easier again in future releases?
Tried with the stable version of the theme and hugo 0.84.0 where this would work, but then I am running into troubles with the icons 😅

[kdevo]

Yes. The recent Hugo change requires careful re-thinking of the way how the menu is built within the theme.

[kdevo]

Since this is likely related to the development version, I'll evaluate/test when I've some more time. Currently there just isn't any space.

[kdevo]

Hi @bluefander,

I've just released v5 of the theme, with many improvements under the hood, a different installation procedure (via hugo modules), and improved documentation. It also fixes above problem and documents how to properly add a custom section.

Side note: This also means that all features from dev are now available in the master branch.

Hope this helps.