Use docs layout for blog posts & dynamic side menu generation

[StarkZarn]

Fantastic theme you've built here! I'm just getting started with a project and I'm hoping to write my blog posts in the docs format, to get the left-hand menu. I'd like to get them under the /blog/ route though.

So far I have included:

sidebar:
  open: true
  exclude: false
cascade:
  type: blog

in the frontmatter of my _index.md file in the /blog folder. This gets me the desired layout on the blog post.

However, when visiting https://mydomain.tld/blog, no listing appears, presumably because the blog posts are actually docs articles now.

TL;DR - I want to write a blog, but have each blog post be in the style of a docs page, and have the /blog homepage (index) include the lefthand menu sidebar. Is this possible?

Thanks!

[imfing]

Currently it’s not possible to mix different layouts, the docs layout and blog layout use separate templates.

You can either continue using the default blog layout, or override it by copying the docs layout files into your site's corresponding layouts folder e.g. layouts/blog and adjusting them as needed.

[StarkZarn]

Thanks! Fair enough. I had considered just clobbering the template.

Right now I'm working with the theme as a hugo module. I know you can override specific bits by writing the version of the file in the filetree locally, but this feels like it'd be a nightmare to maintain with module updates. Do you have any recommendation on that workflow? Should I vendor the modules and reference that content; is a git submodule better; etc.?